---
title: MercatorCoordinate
source: https://vjmap.com/en/doc/MercatorCoordinate.html
---

# MercatorCoordinate

甲`MercatorCoordinate`对象表示投影三维位置。

`MercatorCoordinate`使用 web 墨卡托投影 ( `EPSG:3857 `) 单位略有不同：

- 1个单位的大小是投影世界的宽度而不是“墨卡托米”
- 坐标空间的原点在西北角而不是中间

例如，`MercatorCoordinate(0, 0, 0)`是墨卡托世界的西北角， `MercatorCoordinate(1, 1, 0)`是东南角。如果您熟悉 `矢量切片 `将坐标空间视为`0/0/0`范围为 的瓦片可能会有所帮助`1`。

的`z`尺寸`MercatorCoordinate`是共形的。墨卡托坐标空间中的立方体将被渲染为立方体。

### Parameters
- `x` **`number`** 位置的 x 分量。
- `y` **`number`** 位置的 y 分量。
- `z` **`number`**位置的 z 分量。（可选，默认`0`）

### Examples
```
var nullIsland = new vjmap.MercatorCoordinate(0.5, 0.5, 0);
```

### toLngLat
返回`LngLat`坐标的 。

#### Examples
```
var coord = new vjmap.MercatorCoordinate(0.5, 0.5, 0);
var lngLat = coord.toLngLat(); // LngLat(0, 0)
```

返回**[LngLat][230]**的`LngLat`对象。

### toAltitude
返回以米为单位的坐标高度。

#### Examples
```
var coord = new vjmap.MercatorCoordinate(0, 0, 0.02);
coord.toAltitude(); // 6914.281956295339
```

返回**`number`**以米为单位的海拔高度。

### meterInMercatorCoordinateUnits
返回`MercatorCoordinate`以该纬度为单位的 1 米的距离。

对于使用米的真实世界单位坐标，这自然提供了转换为`MercatorCoordinate`s的比例。

**`number`**以`MercatorCoordinate`单位返回1 米的距离。

### fromLngLat
`LngLat`将 a投影到 a `MercatorCoordinate`。

#### Parameters
- `lngLatLike` **[LngLatLike][284]**要投影的位置。
- `altitude` **`number`**位置的高度（以米为单位）。（可选，默认`0`）

#### Examples
```
var coord = vjmap.MercatorCoordinate.fromLngLat({ lng: 0, lat: 0}, 0);
coord; // MercatorCoordinate(0.5, 0.5, 0)
```

返回**[MercatorCoordinate][300]**投影的墨卡托坐标。