LngLat

Объект LngLat представляет заданные координаты долготы и широты, измеряемые в градусах. Эти координаты основаны на стандарте WGS84 (EPSG:4326).

MapLibre GL JS использует порядок координат «долгота, широта» (в отличие от порядка «широта, долгота»), чтобы соответствовать спецификации GeoJSON.

Обратите внимание: любой метод MapLibre GL JS, принимающий объект LngLat в качестве аргумента или параметра, также может принимать Array из двух чисел и выполнять неявное преобразование. Этот гибкий тип описан как LngLatLike.

Пример

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

См. также

Получение координат указателя мыши

Конструкторы

Конструктор

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

Параметры

Возвращает

LngLat

Методы

distanceTo()

distanceTo(lngLat: LngLat): number

Возвращает приблизительное расстояние в метрах между парой координат. Используется формула гаверсинусов (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, "true distance" using a non-spherical approximation is ~3966km

toArray()

toArray(): [number, number]

Возвращает координаты в виде массива из двух чисел.

Возвращает

[number, number]

Координаты в виде массива долготы и широты.

Пример

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

toString()

toString(): string

Возвращает координаты в виде строки.

Возвращает

string

Координаты в виде строки формата 'LngLat(lng, lat)'.

Пример

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

wrap()

wrap(): LngLat

Возвращает новый объект 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

Преобразует массив из двух чисел или объект со свойствами 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

Широта, измеряемая в градусах.

lng

lng: number

Долгота, измеряемая в градусах.