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

# LngLat

甲`LngLat`对象表示一个给定的经度和纬度坐标，以度为单位。这些坐标基于`WGS84 (EPSG:4326) 标准 `.

使用经度、纬度坐标顺序（相对于纬度、经度）来匹配 `GeoJSON 规范 `.

请注意，任何接受`LngLat`对象作为参数或选项的方法也可以接受`Array`两个数字中的一个，并将执行隐式转换。这种灵活的类型记录为[LngLatLike][284]。

### Parameters
- `lng` **`number`** 经度，以度为单位。
- `lat` **`number`** 纬度，以度为单位。

### Examples
```
var ll = new vjmap.LngLat(-123.9749, 40.7736);
ll.lng; // = -123.9749
```

### wrap
返回一个新`LngLat`对象，其经度被包裹到范围 (-180, 180)。

#### Examples
```
var ll = new vjmap.LngLat(286.0251, 40.7736);
var wrapped = ll.wrap();
wrapped.lng; // = -73.9749
```

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

### toArray
返回表示为两个数字数组的坐标。

#### Examples
```
var ll = new vjmap.LngLat(-73.9749, 40.7736);
ll.toArray(); // = [-73.9749, 40.7736]
```

返回**`Array`< `number`\>**坐标表示为经度和纬度数组。

### toString
返回表示为字符串的坐标。

#### Examples
```
var ll = new vjmap.LngLat(-73.9749, 40.7736);
ll.toString(); // = "LngLat(-73.9749, 40.7736)"
```

返回**`string`**值表示为格式字符串的坐标`'LngLat(lng, lat)'`。

### distanceTo
返回一对坐标之间的近似距离（以米为单位） 使用Haversine 公式（来自 RW Sinnott，“Haversine 的优点”，Sky and Telescope，第 68 卷，第 2 期，1984 年，第 159 页）

#### Parameters
- `lngLat` 计算距离的**[LngLat][230]**坐标

#### Examples
```
var new_york = new vjmap.LngLat(-74.0060, 40.7128);
var los_angeles = new vjmap.LngLat(-118.2437, 34.0522);
new_york.distanceTo(los_angeles); // = 3935751.690893987, "true distance" using a non-spherical approximation is ~3966km
```

返回**`number`**两个坐标之间的距离（以米为单位）。

### toBounds
`LngLatBounds`从给定 扩展的坐标返回 a `radius`。返回的`LngLatBounds`完全包含`radius`.

#### Parameters
- `radius` **`number`**从坐标到扩展边界的距离（以米为单位）。（可选，默认`0`）

#### Examples
```
var ll = new vjmap.LngLat(-73.9749, 40.7736);
ll.toBounds(100).toArray(); // = [[-73.97501862141328, 40.77351016847229], [-73.97478137858673, 40.77368983152771]]
```

返回**[LngLatBounds][285]**一个新`LngLatBounds`对象，表示由 扩展的坐标`radius`。

### convert
将包含两个数字的数组或具有`lng`and`lat`或`lon`and`lat`属性的`LngLat`对象转换为对象。

如果`LngLat`传入一个对象，该函数将原样返回它。

#### Parameters
- `input` **[LngLatLike][284]**要转换的两个数字或对象的数组，或`LngLat`要返回的对象。

#### Examples
```
var arr = [-73.9749, 40.7736];
var ll = vjmap.LngLat.convert(arr);
ll;   // = LngLat {lng: -73.9749, lat: 40.7736}
```

返回**[LngLat][230]**一个新`LngLat`对象（如果发生转换）或原始`LngLat`对象。