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});

构造函数还接受 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])
参数： 
  • latOrLatLngOrLatLngLiteral：number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap：number|boolean optional
  • noClampNoWrap：boolean 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])
参数： 
  • precision：number 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});

Geometry 库不支持 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()
参数：无
返回值：  LatLngBoundsLiteral
转换为 JSON 表示形式。此函数旨在通过 JSON.stringify 使用。
toSpan
toSpan()
参数：无
返回值：  LatLng
将指定的地图范围转换为纬度/经度跨度。
toString
toString()
参数：无
返回值：  string
转换为字符串。
toUrlValue
toUrlValue([precision])
参数： 
  • precision：number optional
返回值：  string
返回相应边界的字符串，格式为“lat_lo,lng_lo,lat_hi,lng_hi”，其中“lo”对应于边界框的西南角，而“hi”对应于该框的东北角。
union
union(other)
参数： 
返回值：  LatLngBounds
延伸此范围以包含此范围和指定范围的并集。

LatLngBoundsLiteral 接口

google.maps.LatLngBoundsLiteral 接口

在整个 API 中，对象字面量可代替 LatLngBounds 对象。这些内容会自动转换为 LatLngBounds 对象。必须设置所有 south、west、north 和 east，否则会抛出异常。
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])
参数： 
  • value：LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 初始值。
  • noClampNoWrap：boolean 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)
参数： 
  • x：number
  • y：number
二维平面上的点。
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])
参数： 
  • width：number
  • height：number
  • widthUnit：string optional
  • heightUnit：string optional
二维尺寸，其中宽度是 x 轴上的距离，高度是 y 轴上的距离。
height
类型：  number
沿 y 轴的高度（以像素为单位）。
width
类型：  number
沿 X 轴的宽度（以像素为单位）。
equals
equals(other)
参数： 
返回值：  boolean
比较两个大小。
toString
toString()
参数：无
返回值：  string
传回该大小的字符串表示。

填充接口

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
类型：  LatLng|LatLngLiteral
圆的中心。
radius
类型：  number
地球表面的半径（以米为单位）。
继承自： clickable、draggable、editable、fillColor、fillOpacity、map、strokeColor、strokeOpacity、strokePosition、strokeWeight、visible、zIndex

Orientation3D 类

google.maps.Orientation3D 类

Orientation3D 是一个三维矢量，用于沿航向、倾斜度和横滚进行标准数学旋转转换。

  • 航向是介于 [0, 360) 度范围内的角度。
  • 倾斜角度是介于 [0, 360) 度之间的角度。
  • 滚转角是介于 [0, 360) 度范围内的角度。

此类实现了 Orientation3DLiteral。

通过调用 const {Orientation3D} = await google.maps.importLibrary("core") 进行访问。
请参阅 Maps JavaScript API 中的库。
Orientation3D
Orientation3D(value)
参数： 
heading
类型：  number
默认值： 0
绕 z 轴（垂直于地球表面）的旋转。值为 0（默认值）表示正北。正旋转是绕 z 轴顺时针旋转，以度为单位，范围为 0 到 360。不在此范围内的值会被换算为该范围内的值。例如，值 -190 将转换为 170。值 530 也会转换为 170。
roll
类型：  number
默认值： 0
绕 y 轴旋转。正旋转是绕 y 轴顺时针旋转，以度为单位，范围为 0 到 360。不在此范围内的值会被换算为该范围内的值。例如，值 -190 将转换为 170。值 530 也会转换为 170。
tilt
类型：  number
默认值： 0
绕 x 轴旋转。正旋转是绕 x 轴顺时针旋转，以度为单位，范围为 0 到 360。不在此范围内的值会被换算为该范围内的值。例如，值 -190 将转换为 170。值 530 也会转换为 170。
equals
equals(other)
参数： 
返回值：  boolean 两个对象是否相等。
比较函数。
toJSON
toJSON()
参数：无
返回值：  Orientation3DLiteral
转换为 JSON 表示形式。此函数旨在通过 JSON.stringify 使用。

Orientation3DLiteral 接口

google.maps.Orientation3DLiteral 接口

为了方便起见，在许多地方，对象字面量可代替 Orientation3D 对象。当 Maps API 遇到这些对象时，会将它们转换为 Orientation3D 对象。
heading optional
类型：  number optional
绕 z 轴（垂直于地球表面）的旋转。值为 0（默认值）表示正北。正旋转是绕 z 轴顺时针旋转，以度为单位，范围为 0 到 360。
roll optional
类型：  number optional
绕 y 轴旋转。正旋转是绕 y 轴顺时针旋转，以度为单位，范围为 0 到 360。
tilt optional
类型：  number optional
绕 x 轴旋转。正旋转是绕 x 轴顺时针旋转，以度为单位，范围为 0 到 360。

Vector3D 类

google.maps.Vector3D 类

Vector3D 是一个三维向量，用于执行标准数学运算，例如沿局部 x 轴、y 轴和 z 轴缩放三维对象的边界。

  • x 是实数。
  • y 是实数。
  • z 是一个实数。

此类实现了 Vector3DLiteral。

通过调用 const {Vector3D} = await google.maps.importLibrary("core") 进行访问。
请参阅 Maps JavaScript API 中的库。
Vector3D
Vector3D(value)
参数： 
x
类型：  number
三维向量的 X 分量。
y
类型：  number
三维向量的 Y 分量。
z
类型：  number
三维向量的 Z 分量。
equals
equals(other)
参数： 
返回值：  boolean
比较函数。
toJSON
toJSON()
参数：无
返回值：  Vector3DLiteral
转换为 JSON 表示形式。此函数旨在通过 JSON.stringify 使用。

Vector3DLiteral 接口

google.maps.Vector3DLiteral 接口

为了方便起见，在许多地方，对象字面量可代替 Vector3D 对象。当 Maps API 遇到这些对象时，会将它们转换为 Vector3D 对象。
x
类型：  number
三维向量的 X 分量。
y
类型：  number
三维向量的 Y 分量。
z
类型：  number
三维向量的 Z 分量。