Coordinates

LatLng

google.maps.LatLng

LatLng 是地理坐标(即纬度和经度)中的点。

  • 纬度范围在 -90 度(含)到 90 度(含)之间。不在此范围内的值会被限制在 [-90, 90] 的范围内。这意味着,如果指定的值小于 -90,则会被设为 -90。如果值大于 90,则会被设置为 90。
  • 经度范围为-180度到180度(含-180度)。不在此范围内的值会被换算成该范围内的值。例如,值 -190 将被转换为 170。值 190 将转换为 -170。这反映了经度环绕地球的事实。
尽管默认地图投影将经度与地图的 x 坐标相关联,将纬度与 y 坐标相关联,但始终先写入纬度坐标,再写入经度。
请注意,您无法修改 LatLng 的坐标。如果您想计算另一个点,则必须创建一个新的点。

大多数接受 LatLng 对象的方法也接受 LatLngLiteral 对象,因此以下代码是等效的:

 map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});

该构造函数还接受 LatLngLiteralLatLng 对象。如果将 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])
参数
  • latOrLatLngOrLatLngLiteralnumber|LatLngLiteral|LatLng
  • lngOrNoClampNoWrapnumber|boolean optional
  • noClampNoWrapboolean optional
创建表示地理点的 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])
参数
  • precisionnumber optional
返回值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});

几何图形库不支持 LatLng 对象字面量。

lat
类型number
纬度(以度为单位)。值将限制在 [-90, 90] 范围内。这意味着,如果指定的值小于 -90,则会被设为 -90。如果值大于 90,则会被设置为 90。
lng
类型number
经度(以度为单位)。[-180, 180] 范围之外的值将会自动换行,以纳入其中。例如,值 -190 将被转换为 170。值 190 将转换为 -170。这反映了经度环绕地球的事实。

LatLngBounds

google.maps.LatLngBounds

LatLngBounds 实例表示采用地理坐标的矩形,其中包括与 180 度子午线相交的矩形。

通过调用 const {LatLngBounds} = await google.maps.importLibrary("core") 进行访问。请参阅 Maps JavaScript API 中的库

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
参数
基于矩形的西南角和东北角处的点构造矩形。
MAX_BOUNDS 地球最大边界的 LatLngBounds。这些边界会囊括整个地球。
contains
contains(latLng)
参数
返回值boolean
如果指定的纬度/经度在此范围中,则返回 true
equals
equals(other)
参数
返回值boolean
如果此范围与指定范围大致相等,则返回 true
extend
extend(point)
参数
返回值LatLngBounds
延伸此范围以包含指定点。
getCenter
getCenter()
参数:无
返回值LatLng
计算该 LatLngBounds 的中心。
getNorthEast
getNorthEast()
参数:无
返回值LatLng
用于传回此范围的东北角。
getSouthWest
getSouthWest()
参数:无
返回值LatLng
用于传回此范围的西南角。
intersects
intersects(other)
返回值boolean
如果此范围与其他边界共享任何点,则返回 true
isEmpty
isEmpty()
参数:无
返回值boolean
当范围为空时传回。
toJSON
toJSON()
参数:无
转换为 JSON 表示法。此函数旨在通过 JSON.stringify 使用。
toSpan
toSpan()
参数:无
返回值LatLng
将指定的地图范围转换为纬度/经度跨度。
toString
toString()
参数:无
返回值string
转换为字符串。
toUrlValue
toUrlValue([precision])
参数
  • precisionnumber optional
返回值string
针对此范围返回“lat_lo,lng_lo,lat_hi,lng_hi”形式的字符串,其中“lo”对应于边界框的西南角,而“hi”对应于该框的东北角。
union
union(other)
返回值LatLngBounds
延伸此范围以包含此范围和指定范围的并集。

LatLngBoundsLiteral 接口

google.maps.LatLngBoundsLiteral 接口

整个 API 接受对象字面量代替 LatLngBounds 对象。它们会自动转换为 LatLngBounds 对象。必须设置所有 southwestnortheast,否则会抛出异常。

east
类型number
东经度(以度为单位)。[-180, 180] 范围之外的值将换行到 [-180, 180] 范围内。例如,值 -190 将被转换为 170。值 190 将转换为 -170。这反映了经度环绕地球的事实。
north
类型number
北纬度(以度为单位)。值将限制在 [-90, 90] 范围内。这意味着,如果指定的值小于 -90,则会被设为 -90。如果值大于 90,则会被设置为 90。
south
类型number
南纬度,以度为单位。值将限制在 [-90, 90] 范围内。这意味着,如果指定的值小于 -90,则会被设为 -90。如果值大于 90,则会被设置为 90。
west
类型number
西经度数(以度为单位)。[-180, 180] 范围之外的值将换行到 [-180, 180] 范围内。例如,值 -190 将被转换为 170。值 190 将转换为 -170。这反映了经度环绕地球的事实。

LatLngAltitude

google.maps.LatLngAltitude

LatLngAltitude 是以地理坐标(纬度、经度和海拔)表示的 3D 点。

  • 纬度范围在 -90 度(含)到 90 度(含)之间。不在此范围内的值会被限制在 [-90, 90] 的范围内。这意味着,如果指定的值小于 -90,则会被设为 -90。如果值大于 90,则会被设置为 90。
  • 经度范围为-180度到180度(含-180度)。不在此范围内的值会被换算成该范围内的值。例如,值 -190 将被转换为 170。值 190 将转换为 -170。这反映了经度环绕地球的事实。
  • 海拔高度以米为单位。正值表示高于地平面的高度,负值表示地表以下的高度。

此类会实现 LatLngAltitudeLiteral

此类会实现 LatLngLiteral

通过调用 const {LatLngAltitude} = await google.maps.importLibrary("core") 进行访问。请参阅 Maps JavaScript API 中的库

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
参数
  • valueLatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 初始化值。
  • noClampNoWrapboolean optional:是否保留初始化值,即使它们不一定是 [-90, 90] 范围内的有效纬度值或 [-180, 180] 范围内的有效经度值。默认值为 false,用于启用纬度限制和经度换行。
altitude
类型number
返回海拔高度。
lat
类型number
返回纬度。
lng
类型number
返回经度。
equals
equals(other)
参数
返回值boolean 两个对象是否相等。
比较函数。
toJSON
toJSON()
参数:无
返回值LatLngAltitudeLiteral 此对象的 JSON 表示法。

LatLngAltitudeLiteral 接口

google.maps.LatLngAltitudeLiteral 接口

在许多地方,为了方便起见,系统接受对象字面量代替 LatLngAltitude 对象。当 Maps API 遇到这些对象时,系统会将其转换为 LatLngAltitude 对象。

此接口扩展了 LatLngLiteral

altitude
类型number
默认值0
地面以上距离(以米为单位)。负值表示地表下。
lat
类型number
纬度(以度为单位)。值将限制在 [-90, 90] 范围内。这意味着,如果指定的值小于 -90,则会被设为 -90。如果值大于 90,则会被设置为 90。
lng
类型number
经度(以度为单位)。[-180, 180] 范围之外的值将会自动换行,以纳入其中。例如,值 -190 将被转换为 170。值 190 将转换为 -170。这反映了经度环绕地球的事实。

Point

google.maps.Point

通过调用 const {Point} = await google.maps.importLibrary("core") 进行访问。请参阅 Maps JavaScript API 中的库

Point
Point(x, y)
参数
  • xnumber
  • ynumber
二维平面上的点。
x
类型number
X 坐标
y
类型number
Y 坐标
equals
equals(other)
参数
返回值boolean
比较两个点
toString
toString()
参数:无
返回值string
传回该点的字符串表示。

Size

google.maps.Size

通过调用 const {Size} = await google.maps.importLibrary("core") 进行访问。请参阅 Maps JavaScript API 中的库

Size
Size(width, height[, widthUnit, heightUnit])
参数
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring optional
二维尺寸,其中“宽”是指 x 轴上的距离,“高度”是指 y 轴上的距离。
height
类型number
沿 y 轴的高度(以像素为单位)。
width
类型number
沿 X 轴的宽度(以像素为单位)。
equals
equals(other)
参数
返回值boolean
比较两个大小。
toString
toString()
参数:无
返回值string
传回该大小的字符串表示。

Padding 接口

google.maps.Padding 接口

bottom optional
类型number optional
下内边距(以像素为单位)。
left optional
类型number optional
左侧内边距(以像素为单位)。
right optional
类型number optional
右侧内边距(以像素为单位)。
top optional
类型number optional
上边距(以像素为单位)。

CircleLiteral 接口

google.maps.CircleLiteral 接口

表示圆形的对象字面量。

此接口扩展了 CircleOptions

center
圆的中心。
radius
类型number
地球表面的半径(以米为单位)。
继承clickabledraggableeditablefillColorfillOpacitymapstrokeColorstrokeOpacitystrokePositionstrokeWeightvisiblezIndex