LngLat

定义于: src/geo/lng_lat.ts:53

LngLat对象表示以度为单位的给定经度和纬度坐标；这些坐标基于WGS84 (EPSG:4326)标准；

MapLibre GL JS使用经度、纬度的坐标顺序（而不是纬度、经度），以匹配GeoJSON规范；

请注意，任何接受LngLat对象作为参数或选项的MapLibre GL JS方法也可以接受两个数字的Array，并会执行隐式转换；这种灵活的类型记录为LngLatLike；

示例

let ll = new LngLat(-123.9749, 40.7736);
ll.lng; // = -123.9749

参见

• 获取鼠标指针的坐标
• 显示弹出窗口
• 创建时间轴动画

构造函数

构造函数

new LngLat(lng: number, lat: number): LngLat

定义于: src/geo/lng_lat.ts:68

参数

返回

LngLat

方法

distanceTo()

distanceTo(lngLat: LngLat): number

定义于: src/geo/lng_lat.ts:135

返回一对坐标之间的近似距离（以米为单位）；使用Haversine公式（来自R.W. Sinnott，"Virtues of the Haversine", Sky and Telescope, vol. 68, no. 2, 1984, p. 159）；

参数

返回

number

两个坐标之间的距离，以米为单位；

示例

let new_york = new LngLat(-74.0060, 40.7128);
let los_angeles = new LngLat(-118.2437, 34.0522);
new_york.distanceTo(los_angeles); // = 3935751.690893987, 使用非球形近似的"真实距离"约为3966公里

toArray()

toArray(): [number, number]

定义于: src/geo/lng_lat.ts:104

返回表示为两个数字数组的坐标；

返回

[number, number]

表示为经度和纬度数组的坐标；

示例

let ll = new LngLat(-73.9749, 40.7736);
ll.toArray(); // = [-73.9749, 40.7736]

toString()

toString(): string

定义于: src/geo/lng_lat.ts:118

以字符串形式返回坐标；

返回

string

以'LngLat(lng, lat)'格式的字符串表示的坐标；

示例

let ll = new LngLat(-73.9749, 40.7736);
ll.toString(); // = "LngLat(-73.9749, 40.7736)"

wrap()

wrap(): LngLat

定义于: src/geo/lng_lat.ts:90

返回一个新的LngLat对象，其经度被包裹在(-180, 180)范围内；

返回

LngLat

包裹后的LngLat对象；

示例

let ll = new LngLat(286.0251, 40.7736);
let wrapped = ll.wrap();
wrapped.lng; // = -73.9749

convert()

static convert(input: LngLatLike): LngLat

定义于: src/geo/lng_lat.ts:160

将两个数字的数组或具有lng和lat或lon和lat属性的对象转换为LngLat对象；

如果传入LngLat对象，函数将原样返回它；

参数

返回

LngLat

如果发生转换，则返回新的LngLat对象，否则返回原始的LngLat对象；

示例

let arr = [-73.9749, 40.7736];
let ll = LngLat.convert(arr);
ll;   // = LngLat {lng: -73.9749, lat: 40.7736}

属性

lat

lat: number

定义于: src/geo/lng_lat.ts:62

纬度，以度为单位；

lng

lng: number

定义于: src/geo/lng_lat.ts:57

经度，以度为单位；