# 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
1
2

# wrap

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

# Examples

var ll = new vjmap.LngLat(286.0251, 40.7736);
var wrapped = ll.wrap();
wrapped.lng; // = -73.9749
1
2
3

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

# toArray

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

# Examples

var ll = new vjmap.LngLat(-73.9749, 40.7736);
ll.toArray(); // = [-73.9749, 40.7736]
1
2

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

# toString

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

# Examples

var ll = new vjmap.LngLat(-73.9749, 40.7736);
ll.toString(); // = "LngLat(-73.9749, 40.7736)"
1
2

返回**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
1
2
3

返回**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]]
1
2

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

# convert

将包含两个数字的数组或具有lngandlatlonandlat属性的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}
1
2
3

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