# 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
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
2
3
返回**[LngLat][230]**包装的LngLat
对象。
# toArray
返回表示为两个数字数组的坐标。
# Examples
var ll = new vjmap.LngLat(-73.9749, 40.7736);
ll.toArray(); // = [-73.9749, 40.7736]
1
2
2
返回**Array
< number
>**坐标表示为经度和纬度数组。
# toString
返回表示为字符串的坐标。
# Examples
var ll = new vjmap.LngLat(-73.9749, 40.7736);
ll.toString(); // = "LngLat(-73.9749, 40.7736)"
1
2
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
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
2
返回**[LngLatBounds][285]**一个新LngLatBounds
对象,表示由 扩展的坐标radius
。
# convert
将包含两个数字的数组或具有lng
andlat
或lon
andlat
属性的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
2
3
返回**[LngLat][230]**一个新LngLat
对象(如果发生转换)或原始LngLat
对象。