Cesium API - Rectangle 中文文档

new Cesium.Rectangle(west, south, east, north)

指定经度和纬度坐标的二维区域。

Name	Type	Default	Description
`west`	Number	`0.0`	optional 最西端的经度，以弧度为单位，在[-Pi, Pi]范围内。
`south`	Number	`0.0`	optional 最南端的纬度，以弧度为单位，在[-Pi/2, Pi/2]范围内。
`east`	Number	`0.0`	optional 最东端的经度，以弧度为单位，在[-Pi, Pi]范围内。
`north`	Number	`0.0`	optional 最北端的纬度，以弧度为单位，在[-Pi/2, Pi/2]范围内。

参考：

Packable

成员变量

staticconstantCesium.Rectangle.MAX_VALUE : Rectangle

Core/Rectangle.js 1050

可能的最大矩形。

staticCesium.Rectangle.packedLength : Number

Core/Rectangle.js 98

用于将对象打包成数组的元素数。

east : Number

Core/Rectangle.js 59

最东端的经度，以弧度为单位，在[-Pi, Pi]范围内。

Default Value: 0.0

height : Number

Core/Rectangle.js 87

获取矩形的高度（以弧度为单位）。

north : Number

Core/Rectangle.js 67

最北端的纬度，以弧度为单位，在[-Pi/2, Pi/2]范围内。

Default Value: 0.0

south : Number

Core/Rectangle.js 51

最南端的纬度，以弧度为单位，在[-Pi/2, Pi/2]范围内。

Default Value: 0.0

west : Number

Core/Rectangle.js 43

最西端的经度，以弧度为单位，在[-Pi, Pi]范围内。

Default Value: 0.0

width : Number

Core/Rectangle.js 76

获取矩形的宽度（以弧度为单位）。

内置方法

staticCesium.Rectangle.center(rectangle, result) → Cartographic

Core/Rectangle.js 687

计算矩形的中心。

Name	Type	Description
`rectangle`	Rectangle	要找到中心的矩形。
`result`	Cartographic	optional 存储结果的对象。

返回值：

修改后的结果参数或新的Cartographic实例（如果没有提供）。

staticCesium.Rectangle.clone(rectangle, result) → Rectangle

Core/Rectangle.js 395

复制一个矩形。

Name	Type	Description
`rectangle`	Rectangle	要克隆的矩形。
`result`	Rectangle	optional 存储结果的对象，如果要创建新实例，则为未定义对象。

返回值：

修改后的结果参数或新矩形实例（如果没有提供）。（如果矩形未定义，则返回undefined。）

staticCesium.Rectangle.computeHeight(rectangle) → Number

Core/Rectangle.js 173

计算矩形的高度（以弧度为单位）。

Name	Type	Description
`rectangle`	Rectangle	要计算高度的矩形。

返回值：

高度。

staticCesium.Rectangle.computeWidth(rectangle) → Number

Core/Rectangle.js 156

计算矩形的宽度（以弧度为单位）。

Name	Type	Description
`rectangle`	Rectangle	要计算宽度的矩形。

返回值：

宽度。

staticCesium.Rectangle.contains(rectangle, cartographic) → Boolean

Core/Rectangle.js 932

如果cartographic在矩形上或矩形内，则返回true，否则返回false。

Name	Type	Description
`rectangle`	Rectangle	矩形。
`cartographic`	Cartographic	要测试的cartographic。

返回值：

如果提供的地图在矩形内，则为true，否则为false。

staticCesium.Rectangle.equals(left, right) → Boolean

Core/Rectangle.js 485

比较所提供的矩形，如果相等则返回true，否则返回false。

Name	Type	Description
`left`	Rectangle	optional 第一个矩形。
`right`	Rectangle	optional 第二个矩形。

返回值：

如果两个矩形相等，则为true；否则，false。

staticCesium.Rectangle.equalsEpsilon(left, right, absoluteEpsilon) → Boolean

Core/Rectangle.js 429

比较提供的矩形分量，如果通过了绝对或相对公差测试，则返回true，否则返回false。

Name	Type	Description
`left`	Rectangle	optional 第一个矩形。
`right`	Rectangle	optional 第二个矩形。
`absoluteEpsilon`	Number	用于等式检验的绝对epsilon公差。

返回值：

如果两个矩形都在给定的范围内，则为true ；否则，false。

staticCesium.Rectangle.expand(rectangle, cartographic, result) → Rectangle

Core/Rectangle.js 900

通过放大所提供的矩形直到它包含所提供的cartographic来计算矩形。

Name	Type	Description
`rectangle`	Rectangle	要扩大的矩形。
`cartographic`	Cartographic	要用矩形包围的cartographic。
`result`	Rectangle	optional 存储结果的对象。

返回值：

修改后的结果参数或新矩形实例（如果没有提供）。

staticCesium.Rectangle.fromCartesianArray(cartesians, ellipsoid, result) → Rectangle

Core/Rectangle.js 340

创建包含所提供的数组中所有位置的尽可能小的矩形。

Name	Type	Default	Description
`cartesians`	Array.<Cartesian3>		笛卡尔实例的列表。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 椭球上的笛卡尔坐标。
`result`	Rectangle		optional 存储结果的对象，如果要创建新实例，则为未定义对象。

返回值：

修改后的结果参数或新矩形实例（如果没有提供）。

staticCesium.Rectangle.fromCartographicArray(cartographics, result) → Rectangle

Core/Rectangle.js 277

创建包含所提供的数组中所有位置的尽可能小的矩形。

Name	Type	Description
`cartographics`	Array.<Cartographic>	Cartographic实例的列表。
`result`	Rectangle	optional 存储结果的对象，如果要创建新实例，则为未定义对象。

返回值：

修改后的结果参数或新矩形实例（如果没有提供）。

staticCesium.Rectangle.fromDegrees(west, south, east, north, result) → Rectangle

Core/Rectangle.js 206

创建给定边界经度和纬度的矩形（以角度表示）。

Name	Type	Default	Description
`west`	Number	`0.0`	optional 在[-180.0, 180.0]范围内以角度表示的最西侧经度。
`south`	Number	`0.0`	optional 在[-90.0, 90.0]范围内以角度表示的最南侧经度。
`east`	Number	`0.0`	optional 在[-180.0, 180.0]范围内以角度表示的最东侧经度。
`north`	Number	`0.0`	optional 在[-90.0, 90.0]范围内以角度表示的最北侧经度。
`result`	Rectangle		optional 存储结果的对象，如果要创建新实例，则为未定义对象。

返回值：

修改后的结果参数或新矩形实例（如果没有提供）。

示例：

var rectangle = Cesium.Rectangle.fromRadians(0.0, Math.PI/4, Math.PI/8, 3*Math.PI/4);

staticCesium.Rectangle.fromRadians(west, south, east, north, result) → Rectangle

Core/Rectangle.js 250

创建给定边界经度和纬度的矩形（以弧度表示）。

Name	Type	Default	Description
`west`	Number	`0.0`	optional 在[-Math.PI, Math.PI]范围内以弧度表示的最西侧经度。
`south`	Number	`0.0`	optional 在[-Math.PI/2, Math.PI/2]范围内以弧度表示的最南侧经度。
`east`	Number	`0.0`	optional 在[-Math.PI, Math.PI]范围内以弧度表示的最东侧经度。
`north`	Number	`0.0`	optional 在[-Math.PI/2, Math.PI/2]范围内以弧度表示的最北侧经度。
`result`	Rectangle		optional 存储结果的对象，如果要创建新实例，则为未定义对象。

返回值：

修改后的结果参数或新矩形实例（如果没有提供）。

示例：

var rectangle = Cesium.Rectangle.fromRadians(0.0, Math.PI/4, Math.PI/8, 3*Math.PI/4);

staticCesium.Rectangle.intersection(rectangle, otherRectangle, result) → Rectangle|undefined

Core/Rectangle.js 734

计算两个矩形的交集。这个函数假设矩形的坐标是以弧度表示的经纬度，并生成一个正确的交集，同时考虑到相同的角度可以用多个值表示，以及经度在反面子午线（anti-meridian）处的缠绕（wrapping）。对于忽略这些因素并可与投影坐标一起使用的简单交集，请参见Rectangle.simpleIntersection。

Name	Type	Description
`rectangle`	Rectangle	在矩形上找到一个交集
`otherRectangle`	Rectangle	求交集的另一个矩形。
`result`	Rectangle	optional 存储结果的对象。

返回值：

修改后的结果参数或新的矩形实例（如果没有提供），或如果没有交集，则为undefined。

staticCesium.Rectangle.northeast(rectangle, result) → Cartographic

Core/Rectangle.js 631

计算矩形的东北角。

Name	Type	Description
`rectangle`	Rectangle	要找到角的矩形
`result`	Cartographic	optional 存储结果的对象。

返回值：

修改后的结果参数或新的Cartographic实例（如果没有提供）。

staticCesium.Rectangle.northwest(rectangle, result) → Cartographic

Core/Rectangle.js 603

计算矩形的西北角。

Name	Type	Description
`rectangle`	Rectangle	要找到角的矩形
`result`	Cartographic	optional 存储结果的对象。

返回值：

修改后的结果参数或新的Cartographic实例（如果没有提供）。

staticCesium.Rectangle.pack(value, array, startingIndex) → Array.<Number>

Core/Rectangle.js 109

将提供的实例存储到提供的数组中。

Name	Type	Default	Description
`value`	Rectangle		要包装的值。
`array`	Array.<Number>		要被包装到的数组。
`startingIndex`	Number	`0`	optional 开始包装元素的数组索引。

返回值：

被包装到的数组。

staticCesium.Rectangle.simpleIntersection(rectangle, otherRectangle, result) → Rectangle|undefined

Core/Rectangle.js 803

计算两个矩形的简单交集。与Rectangle.intersection不同，此函数不尝试将角坐标放入一致的范围，也不考虑跨越反面子午线（anti-meridian）。因此，它可以用于坐标不是简单的经纬度（即投影坐标）的矩形。

Name	Type	Description
`rectangle`	Rectangle	在矩形上找到一个交集
`otherRectangle`	Rectangle	求交集的另一个矩形。
`result`	Rectangle	optional 存储结果的对象。

返回值：

修改后的结果参数或新的矩形实例（如果没有提供），或如果没有交集，则为undefined。

staticCesium.Rectangle.southeast(rectangle, result) → Cartographic

Core/Rectangle.js 659

计算矩形的东南角。

Name	Type	Description
`rectangle`	Rectangle	要找到角的矩形
`result`	Cartographic	optional 存储结果的对象。

返回值：

修改后的结果参数或新的Cartographic实例（如果没有提供）。

staticCesium.Rectangle.southwest(rectangle, result) → Cartographic

Core/Rectangle.js 575

计算矩形的西南角。

Name	Type	Description
`rectangle`	Rectangle	要找到角的矩形
`result`	Cartographic	optional 存储结果的对象。

返回值：

修改后的结果参数或新的Cartographic实例（如果没有提供）。

staticCesium.Rectangle.subsample(rectangle, ellipsoid, surfaceHeight, result) → Array.<Cartesian3>

Core/Rectangle.js 978

对一个矩形进行采样，使它包含一个适合传递给BoundingSphere#fromPoints的笛卡尔坐标点列表。采样是必要的，以考虑矩形覆盖两极或跨越赤道。

Name	Type	Default	Description
`rectangle`	Rectangle		要采样的矩形。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 使用的椭球。
`surfaceHeight`	Number	`0.0`	optional 矩形在椭球上的高度。
`result`	Array.<Cartesian3>		optional 用于存储结果的笛卡儿数组。

返回值：

修改后的结果参数新的笛卡尔实例数组（如果没有提供）。

staticCesium.Rectangle.union(rectangle, otherRectangle, result) → Rectangle

Core/Rectangle.js 845

计算由两个矩形合并而成的矩形。

Name	Type	Description
`rectangle`	Rectangle	用矩形包围的矩形。
`otherRectangle`	Rectangle	用矩形包围的矩形。
`result`	Rectangle	optional 存储结果的对象。

返回值：

修改后的结果参数或新矩形实例（如果没有提供）。

staticCesium.Rectangle.unpack(array, startingIndex, result) → Rectangle

Core/Rectangle.js 133

从已包装的数组中检索实例。

Name	Type	Default	Description
`array`	Array.<Number>		包装的数组。
`startingIndex`	Number	`0`	optional 要解包的元素的起始索引。
`result`	Rectangle		optional 存储结果的对象。