此页面由 Cloud Translation API 翻译。

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` 可启用超出此范围的值。请注意纬度和经度的顺序。

构造函数

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)` 参数： `other`：`LatLng` 返回值：`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});

几何图形库不支持 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])` 参数： `swOrLatLngBounds`：`LatLng\|LatLngLiteral\|LatLngBounds\|LatLngBoundsLiteral optional` `ne`：`LatLng\|LatLngLiteral optional` 基于矩形的西南角和东北角处的点构造矩形。

方法
`contains`	`contains(latLng)` 参数： `latLng`：`LatLng\|LatLngLiteral` 返回值：`boolean` 如果此纬度/经度位于此范围内，则返回 `true`。
`equals`	`equals(other)` 参数： `other`：`LatLngBounds\|LatLngBoundsLiteral optional` 返回值：`boolean` 如果此范围大致等于指定范围，则返回 `true`。
`extend`	`extend(point)` 参数： `point`：`LatLng\|LatLngLiteral` 返回值：`LatLngBounds` 延伸此范围以包含指定点。
`getCenter`	`getCenter()` 参数：无返回值：`LatLng` 计算该 LatLngBounds 的中心。
`getNorthEast`	`getNorthEast()` 参数：无返回值：`LatLng` 用于传回此范围的东北角。
`getSouthWest`	`getSouthWest()` 参数：无返回值：`LatLng` 用于传回此范围的西南角。
`intersects`	`intersects(other)` 参数： `other`：`LatLngBounds\|LatLngBoundsLiteral` 返回值：`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)` 参数： `other`：`LatLngBounds\|LatLngBoundsLiteral` 返回值：`LatLngBounds` 延伸此范围以包含此范围和指定范围的并集。

常量
`MAX_BOUNDS`	用于地球最大边界的 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)` 参数： `other`：`LatLngAltitude optional`另一个 LatLngAltitude 对象。返回值：`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)` 参数： `other`：`Point` 返回值：`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)` 参数： `other`：`Size` 返回值：`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`

Coordinates

LatLng 类

构造函数

方法

LatLngLiteral 接口

属性

LatLngBounds 类

构造函数

方法

常量

LatLngBoundsLiteral 接口

属性

LatLngAltitude 类

构造函数

属性

方法

LatLngAltitudeLiteral 接口

属性

Point 类

构造函数

属性

方法

Size 类

构造函数

属性

方法

内边距接口

属性

CircleLiteral 接口

属性