English | 简体中文

Cartographic

new Cesium.Cartographic(longitude, latitude, height)
engine/Source/Core/Cartographic.js 19

A position defined by longitude, latitude, and height.
Name Type Default Description
longitude number 0.0 optional The longitude, in radians.
latitude number 0.0 optional The latitude, in radians.
height number 0.0 optional The height, in meters, above the ellipsoid.
See:

Members

static constant Cesium.Cartographic.ZERO : Cartographic
engine/Source/Core/Cartographic.js 258

An immutable Cartographic instance initialized to (0.0, 0.0, 0.0).

height : number
engine/Source/Core/Cartographic.js 39

The height, in meters, above the ellipsoid.
Default Value: 0.0

latitude : number
engine/Source/Core/Cartographic.js 32

The latitude, in radians.
Default Value: 0.0

longitude : number
engine/Source/Core/Cartographic.js 25

The longitude, in radians.
Default Value: 0.0

Methods

static Cesium.Cartographic.clone(cartographic, result) → Cartographic
engine/Source/Core/Cartographic.js 193

Duplicates a Cartographic instance.
Name Type Description
cartographic Cartographic The cartographic to duplicate.
result Cartographic optional The object onto which to store the result.
Returns:
The modified result parameter or a new Cartographic instance if one was not provided. (Returns undefined if cartographic is undefined)

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

Compares the provided cartographics componentwise and returns true if they are equal, false otherwise.
Name Type Description
left Cartographic optional The first cartographic.
right Cartographic optional The second cartographic.
Returns:
true if left and right are equal, false otherwise.

static Cesium.Cartographic.equalsEpsilon(left, right, epsilon) → boolean
engine/Source/Core/Cartographic.js 239

Compares the provided cartographics componentwise and returns true if they are within the provided epsilon, false otherwise.
Name Type Default Description
left Cartographic optional The first cartographic.
right Cartographic optional The second cartographic.
epsilon number 0 optional The epsilon to use for equality testing.
Returns:
true if left and right are within the provided epsilon, false otherwise.

static Cesium.Cartographic.fromCartesian(cartesian, ellipsoid, result) → Cartographic
engine/Source/Core/Cartographic.js 116

Creates a new Cartographic instance from a Cartesian position. The values in the resulting object will be in radians.
Name Type Default Description
cartesian Cartesian3 The Cartesian position to convert to cartographic representation.
ellipsoid Ellipsoid Ellipsoid.WGS84 optional The ellipsoid on which the position lies.
result Cartographic optional The object onto which to store the result.
Returns:
The modified result parameter, new Cartographic instance if none was provided, or undefined if the cartesian is at the center of the ellipsoid.

static Cesium.Cartographic.fromDegrees(longitude, latitude, height, result) → Cartographic
engine/Source/Core/Cartographic.js 81

Creates a new Cartographic instance from longitude and latitude specified in degrees. The values in the resulting object will be in radians.
Name Type Default Description
longitude number The longitude, in degrees.
latitude number The latitude, in degrees.
height number 0.0 optional The height, in meters, above the ellipsoid.
result Cartographic optional The object onto which to store the result.
Returns:
The modified result parameter or a new Cartographic instance if one was not provided.

static Cesium.Cartographic.fromRadians(longitude, latitude, height, result) → Cartographic
engine/Source/Core/Cartographic.js 52

Creates a new Cartographic instance from longitude and latitude specified in radians.
Name Type Default Description
longitude number The longitude, in radians.
latitude number The latitude, in radians.
height number 0.0 optional The height, in meters, above the ellipsoid.
result Cartographic optional The object onto which to store the result.
Returns:
The modified result parameter or a new Cartographic instance if one was not provided.

static Cesium.Cartographic.toCartesian(cartographic, ellipsoid, result) → Cartesian3
engine/Source/Core/Cartographic.js 172

Creates a new Cartesian3 instance from a Cartographic input. The values in the inputted object should be in radians.
Name Type Default Description
cartographic Cartographic Input to be converted into a Cartesian3 output.
ellipsoid Ellipsoid Ellipsoid.WGS84 optional The ellipsoid on which the position lies.
result Cartesian3 optional The object onto which to store the result.
Returns:
The position

clone(result) → Cartographic
engine/Source/Core/Cartographic.js 266

Duplicates this instance.
Name Type Description
result Cartographic optional The object onto which to store the result.
Returns:
The modified result parameter or a new Cartographic instance if one was not provided.

equals(right) → boolean
engine/Source/Core/Cartographic.js 277

Compares the provided against this cartographic componentwise and returns true if they are equal, false otherwise.
Name Type Description
right Cartographic optional The second cartographic.
Returns:
true if left and right are equal, false otherwise.

equalsEpsilon(right, epsilon) → boolean
engine/Source/Core/Cartographic.js 290

Compares the provided against this cartographic componentwise and returns true if they are within the provided epsilon, false otherwise.
Name Type Default Description
right Cartographic optional The second cartographic.
epsilon number 0 optional The epsilon to use for equality testing.
Returns:
true if left and right are within the provided epsilon, false otherwise.

toString() → string
engine/Source/Core/Cartographic.js 299

Creates a string representing this cartographic in the format '(longitude, latitude, height)'.
Returns:
A string representing the provided cartographic in the format '(longitude, latitude, height)'.
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
packages/engine
packages/widgets