Rectangle

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

new Cesium.Rectangle(west, south, east, north)
engine/Source/Core/Rectangle.js 18

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]。
See:

Members

static constant Cesium.Rectangle.MAX_VALUE : Rectangle
engine/Source/Core/Rectangle.js 1061

可能的最大矩形。

static Cesium.Rectangle.packedLength : number
engine/Source/Core/Rectangle.js 1041

用于将对象打包到数组中的元素数量。

east : number
engine/Source/Core/Rectangle.js 48

最东端经度（弧度），范围 [-Pi, Pi]。
Default Value: 0.0

readonly height : number
engine/Source/Core/Rectangle.js 73

获取矩形的高度（弧度）。

north : number
engine/Source/Core/Rectangle.js 56

最北端纬度（弧度），范围 [-Pi/2, Pi/2]。
Default Value: 0.0

south : number
engine/Source/Core/Rectangle.js 40

最南端纬度（弧度），范围 [-Pi/2, Pi/2]。
Default Value: 0.0

west : number
engine/Source/Core/Rectangle.js 32

最西端经度（弧度），范围 [-Pi, Pi]。
Default Value: 0.0

readonly width : number
engine/Source/Core/Rectangle.js 64

获取矩形的宽度（弧度）。

Methods

static Cesium.Rectangle.center(rectangle, result) → Cartographic
engine/Source/Core/Rectangle.js 651

计算矩形的中心。
Name Type Description
rectangle Rectangle 要查找中心的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Cartographic实例。

static Cesium.Rectangle.clone(rectangle, result) → Rectangle
engine/Source/Core/Rectangle.js 414

复制矩形。
Name Type Description
rectangle Rectangle 要克隆的矩形。
result Rectangle optional 存储结果的对象，如果应创建新实例则为undefined。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。（如果矩形未定义则返回undefined）

static Cesium.Rectangle.computeHeight(rectangle) → number
engine/Source/Core/Rectangle.js 150

计算矩形的高度（弧度）。
Name Type Description
rectangle Rectangle 要计算高度的矩形。
Returns:
高度。

static Cesium.Rectangle.computeWidth(rectangle) → number
engine/Source/Core/Rectangle.js 133

计算矩形的宽度（弧度）。
Name Type Description
rectangle Rectangle 要计算宽度的矩形。
Returns:
宽度。

static Cesium.Rectangle.contains(rectangle, cartographic) → boolean
engine/Source/Core/Rectangle.js 858

如果地理坐标在矩形上或矩形内则返回true，否则返回false。
Name Type Description
rectangle Rectangle 矩形
cartographic Cartographic 要测试的地理坐标。
Returns:
如果提供的地理坐标在矩形内则返回true，否则返回false。

static Cesium.Rectangle.equals(left, right) → boolean
engine/Source/Core/Rectangle.js 487

比较提供的矩形，如果相等则返回true， 否则返回false。
Name Type Description
left Rectangle optional 第一个矩形。
right Rectangle optional 第二个矩形。
Returns:
如果left和right相等则返回true；否则返回false。

static Cesium.Rectangle.equalsEpsilon(left, right, absoluteEpsilon) → boolean
engine/Source/Core/Rectangle.js 444

逐分量比较两个提供的矩形，如果它们通过绝对或相对容差测试则返回 true，否则返回false。
Name Type Default Description
left Rectangle optional 第一个矩形。
right Rectangle optional 第二个矩形。
absoluteEpsilon number 0 optional 用于相等性测试的绝对epsilon容差。
Returns:
如果left和right在提供的epsilon范围内则返回true，否则返回false。

static Cesium.Rectangle.expand(rectangle, cartographic, result) → Rectangle
engine/Source/Core/Rectangle.js 833

通过扩大提供的矩形直到包含提供的地理坐标来计算矩形。
Name Type Description
rectangle Rectangle 要扩展的矩形。
cartographic Cartographic 要包含在矩形中的地理坐标。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。

static Cesium.Rectangle.fromBoundingSphere(boundingSphere, ellipsoid, result) → Rectangle
engine/Source/Core/Rectangle.js 339

从边界球创建矩形，忽略高度。
Name Type Default Description
boundingSphere BoundingSphere 边界球。
ellipsoid Ellipsoid Ellipsoid.default optional 椭球。
result Rectangle optional 存储结果的对象，如果应创建新实例则为undefined。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。

static Cesium.Rectangle.fromCartesianArray(cartesians, ellipsoid, result) → Rectangle
engine/Source/Core/Rectangle.js 279

创建能包围提供数组中所有位置的最小可能矩形。
Name Type Default Description
cartesians Array.<Cartesian3> Cartesian实例列表。
ellipsoid Ellipsoid Ellipsoid.default optional 笛卡尔坐标所在的椭球。
result Rectangle optional 存储结果的对象，如果应创建新实例则为undefined。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。

static Cesium.Rectangle.fromCartographicArray(cartographics, result) → Rectangle
engine/Source/Core/Rectangle.js 221

创建能包围提供数组中所有位置的最小可能矩形。
Name Type Description
cartographics Array.<Cartographic> Cartographic实例列表。
result Rectangle optional 存储结果的对象，如果应创建新实例则为undefined。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。

static Cesium.Rectangle.fromDegrees(west, south, east, north, result) → Rectangle
engine/Source/Core/Rectangle.js 170

根据以度为单位给定的边界经度和纬度创建矩形。
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 存储结果的对象，如果应创建新实例则为undefined。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。
Example:
const rectangle = Cesium.Rectangle.fromDegrees(0.0, 20.0, 10.0, 30.0);

static Cesium.Rectangle.fromRadians(west, south, east, north, result) → Rectangle
engine/Source/Core/Rectangle.js 201

根据以弧度为单位给定的边界经度和纬度创建矩形。
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 存储结果的对象，如果应创建新实例则为undefined。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。
Example:
const rectangle = Cesium.Rectangle.fromRadians(0.0, Math.PI/4, Math.PI/8, 3*Math.PI/4);

static Cesium.Rectangle.intersection(rectangle, otherRectangle, result) → Rectangle|undefined
engine/Source/Core/Rectangle.js 684

计算两个矩形的交集。此函数假设矩形的坐标是经度和纬度（弧度），并考虑同一角度可以用多个值表示以及经度在反子午线的环绕，从而生成正确的交集。对于忽略这些因素并可用于投影坐标的简单交集，请参见 Rectangle.simpleIntersection。
Name Type Description
rectangle Rectangle 要查找交集的矩形
otherRectangle Rectangle 另一个要查找交集的矩形
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例，如果没有交集则返回undefined。

static Cesium.Rectangle.northeast(rectangle, result) → Cartographic
engine/Source/Core/Rectangle.js 609

计算矩形的东北角。
Name Type Description
rectangle Rectangle 要查找角的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Cartographic实例。

static Cesium.Rectangle.northwest(rectangle, result) → Cartographic
engine/Source/Core/Rectangle.js 588

计算矩形的西北角。
Name Type Description
rectangle Rectangle 要查找角的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Cartographic实例。

static Cesium.Rectangle.pack(value, array, startingIndex) → Array.<number>
engine/Source/Core/Rectangle.js 86

将提供的实例存储到提供的数组中。
Name Type Default Description
value Rectangle 要打包的值。
array Array.<number> 要打包到的数组。
startingIndex number 0 optional 开始打包元素的数组索引。
Returns:
被打包到的数组

static Cesium.Rectangle.simpleIntersection(rectangle, otherRectangle, result) → Rectangle|undefined
engine/Source/Core/Rectangle.js 748

计算两个矩形的简单交集。与 Rectangle.intersection 不同，此函数不尝试将角度坐标放入一致的范围或考虑跨越反子午线。因此，它可用于坐标不仅仅是经度和纬度的矩形（即投影坐标）。
Name Type Description
rectangle Rectangle 要查找交集的矩形
otherRectangle Rectangle 另一个要查找交集的矩形
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例，如果没有交集则返回undefined。

static Cesium.Rectangle.southeast(rectangle, result) → Cartographic
engine/Source/Core/Rectangle.js 630

计算矩形的东南角。
Name Type Description
rectangle Rectangle 要查找角的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Cartographic实例。

static Cesium.Rectangle.southwest(rectangle, result) → Cartographic
engine/Source/Core/Rectangle.js 567

计算矩形的西南角。
Name Type Description
rectangle Rectangle 要查找角的矩形
result Cartographic optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Cartographic实例。

static Cesium.Rectangle.subsample(rectangle, ellipsoid, surfaceHeight, result) → Array.<Cartesian3>
engine/Source/Core/Rectangle.js 895

对矩形进行采样，使其包含适用于传递给BoundingSphere#fromPoints的笛卡尔点列表。采样是必要的，以考虑覆盖两极或跨越赤道的矩形。
Name Type Default Description
rectangle Rectangle 要子采样的矩形。
ellipsoid Ellipsoid Ellipsoid.default optional 要使用的椭球。
surfaceHeight number 0.0 optional 矩形高于椭球的高度。
result Array.<Cartesian3> optional 存储结果的笛卡尔数组。
Returns:
修改后的结果参数，如果未提供则返回新的笛卡尔实例数组。

static Cesium.Rectangle.subsection(rectangle, westLerp, southLerp, eastLerp, northLerp, result) → Rectangle
engine/Source/Core/Rectangle.js 972

从范围[0.0, 1.0]内的归一化坐标计算矩形的子区域。
Name Type Description
rectangle Rectangle 要划分子区域的矩形。
westLerp number 西部插值因子，范围[0.0, 1.0]。必须小于或等于eastLerp。
southLerp number 南部插值因子，范围[0.0, 1.0]。必须小于或等于northLerp。
eastLerp number 东部插值因子，范围[0.0, 1.0]。必须大于或等于westLerp。
northLerp number 北部插值因子，范围[0.0, 1.0]。必须大于或等于southLerp。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。

static Cesium.Rectangle.union(rectangle, otherRectangle, result) → Rectangle
engine/Source/Core/Rectangle.js 782

计算两个矩形的并集。
Name Type Description
rectangle Rectangle 要包含在矩形中的矩形。
otherRectangle Rectangle 要包含在矩形中的另一个矩形。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。

static Cesium.Rectangle.unpack(array, startingIndex, result) → Rectangle
engine/Source/Core/Rectangle.js 110

从打包数组中检索实例。
Name Type Default Description
array Array.<number> 打包数组。
startingIndex number 0 optional 要解包元素的起始索引。
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。

clone(result) → Rectangle
engine/Source/Core/Rectangle.js 464

复制此矩形。
Name Type Description
result Rectangle optional 存储结果的对象。
Returns:
修改后的结果参数，如果未提供则返回新的Rectangle实例。

equals(other) → boolean
engine/Source/Core/Rectangle.js 475

将此矩形与提供的矩形进行逐分量比较，如果相等则返回 true，否则返回false。
Name Type Description
other Rectangle optional 要比较的矩形。
Returns:
如果矩形相等则返回true，否则返回false。

equalsEpsilon(other, epsilon) → boolean
engine/Source/Core/Rectangle.js 507

将此矩形与提供的矩形进行逐分量比较，如果在提供的epsilon范围内则返回 true，否则返回false。
Name Type Default Description
other Rectangle optional 要比较的矩形。
epsilon number 0 optional 用于相等性测试的epsilon。
Returns:
如果矩形在提供的epsilon范围内则返回true，否则返回false。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
CtrlK
packages/engine
packages/widgets