# Cartographic

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

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:

- Ellipsoid

### Members

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

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

#### height : number
engine/Source/Core/Cartographic.js 38

The height, in meters, above the ellipsoid.

Default Value: `0.0`

#### latitude : number
engine/Source/Core/Cartographic.js 31

The latitude, in radians.

Default Value: `0.0`

#### longitude : number
engine/Source/Core/Cartographic.js 24

The longitude, in radians.

Default Value: `0.0`

### Methods

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

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 220

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 241

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 118

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.default` | 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 80

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 51

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 174

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.default` | 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 268

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 279

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 292

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 301

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.