LatLng 类
google.maps.LatLng 类
LatLng 是指地理坐标（纬度和经度）中的一个点。
- 纬度范围为 -90 度（含）到 90 度（含）。不在此范围内的值会被强制转换为 [-90, 90] 范围内的值。这意味着，如果指定的值小于 -90，则会将其设置为 -90。如果该值大于 90，则会设置为 90。
- 经度范围为-180度到180度（含-180度）。不在此范围内的值会被换算为该范围内的值。例如，值 -190 将转换为 170。值 190 将转换为 -170。这反映了经度环绕地球的特性。
请注意，您无法修改
LatLng 的坐标。如果您想计算另一个点，则必须创建一个新点。 大多数接受 LatLng 对象的方法也接受 LatLngLiteral 对象，因此以下内容是等效的：
map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});
构造函数还接受 LatLngLiteral 和 LatLng 对象。如果将 LatLng 实例传递给构造函数，则会创建一个副本。
对构造函数的可能调用如下：
new google.maps.LatLng(-34, 151);
new google.maps.LatLng(-34, 151, true);
new google.maps.LatLng({lat: -34, lng: 151});
new google.maps.LatLng({lat: -34, lng: 151}, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
通过调用 const {LatLng} = await google.maps.importLibrary("core") 进行访问。
请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
LatLng |
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])参数：
创建表示地理点的 LatLng 对象。纬度以度为单位指定，范围为 [-90, 90]。经度以度为单位指定，范围为 [-180, 180)。将 noClampNoWrap 设置为 true 可启用此范围之外的值。请注意纬度和经度的顺序。 |
方法 | |
|---|---|
equals |
equals(other)参数：
返回值：
boolean比较函数。 |
lat |
lat()参数：无
返回值：
number用于返回纬度值（以度为单位）。 |
lng |
lng()参数：无
返回值：
number返回经度值（以度为单位）。 |
toJSON |
toJSON()参数：无
返回值：
LatLngLiteral转换为 JSON 表示形式。此函数旨在通过 JSON.stringify 使用。 |
toString |
toString()参数：无
返回值：
string转换为字符串表示。 |
toUrlValue |
toUrlValue([precision])参数：
返回值：
string以“纬度,经度”形式传回相应 LatLng 的字符串。默认情况下，我们会将纬度/经度值四舍五入到小数点后 6 位。 |
LatLngLiteral 接口
google.maps.LatLngLiteral
接口
为了方便起见，在许多地方，对象字面量可代替 LatLng 对象。当 Maps API 遇到这些对象时，会将它们转换为 LatLng 对象。
示例：
map.setCenter({lat: -34, lng: 151});
new google.maps.Marker({position: {lat: -34, lng: 151}, map: map}); Geometry 库不支持 LatLng 对象字面量。
属性 | |
|---|---|
lat |
类型：
number纬度（以度为单位）。值将被限定在 [-90, 90] 范围内。这意味着，如果指定的值小于 -90，则会将其设置为 -90。如果该值大于 90，则会设置为 90。 |
lng |
类型：
number经度（以度为单位）。超出 [-180, 180] 范围的值会被换算为该范围内的值。例如，值 -190 将转换为 170。值 190 将转换为 -170。这反映了经度环绕地球的特性。 |