【Mapbox GL JS 入门】（5）Geography and geometry 地理和几何

简介

与处理和操纵地理信息或几何图形相关的通用实用程序和类型

LngLat

LngLat对象表示给定的经度和纬度坐标，以度为单位。这些坐标使用经度、纬度坐标顺序来匹配GeoJSON规范，该规范相当于OGC:CRS84坐标参考系统。

注意，任何接受LngLat对象作为参数或选项的Mapbox GL方法也可以接受两个数字的数组，并将执行隐式转换，为LngLatLike

参数

lng(number) 经度，以度为单位
lat(number) 纬度，以度为单位

const ll = new mapboxgl.LngLat(-123.9749, 40.7736);
console.log(ll.lng); // = -123.9749

静态成员

convert(input)
将两个数字的数组或具有lng和lat或lon和lat属性的对象转换为LngLat对象。如果传入了LngLat对象，则函数将其返回不变。

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

实例成员

wrap()
返回一个新的LngLat对象，该对象的经度范围为（-180，180）

const ll = new mapboxgl.LngLat(286.0251, 40.7736);
const wrapped = ll.wrap();
console.log(wrapped.lng); // = -73.9749

toArray()
返回以两个数字的数组表示的坐标

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

toString()
返回以字符串表示的坐标

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

distanceTo(LngLat)
返回一对坐标之间的近似距离（以米为单位）

const newYork = new mapboxgl.LngLat(-74.0060, 40.7128);
const losAngeles = new mapboxgl.LngLat(-118.2437, 34.0522);
newYork.distanceTo(losAngeles); // = 3935751.690893987, "true distance" using a non-spherical approximation is ~3966km

toBounds(radius)
根据给定半径延伸的坐标返回LngLatBounds。返回的LngLatBounds完全包含半径

const ll = new mapboxgl.LngLat(-73.9749, 40.7736);
ll.toBounds(100).toArray(); // = [[-73.97501862141328, 40.77351016847229], [-73.97478137858673, 40.77368983152771]]

LngLatBounds

LngLatBoundsLike

LngLatLike

MercatorCoordinate

Point

PointLike