Geometry Library

编码命名空间

google.maps.geometry.encoding命名空间

折线编码和解码实用工具

需要 &libraries=geometry 网址参数。请参阅 Maps JavaScript API 中的库。
decodePath
decodePath(encodedPath)
参数：
  • encodedPath：string
返回值：Array<LatLng>
用于将编码路径字符串解码为一系列 LatLng。
encodePath
encodePath(path)
参数：
返回值：string
用于将一系列 LatLng 编码为编码路径字符串。

球形命名空间

google.maps.geometry.spherical命名空间

用于计算测地线角度、距离和面积的实用函数。默认半径为地球半径（即 6378137 米）。

需要 &libraries=geometry 网址参数。请参阅 Maps JavaScript API 中的库。
computeArea
computeArea(path[, radius])
参数：
返回值：number
返回闭合路径的无符号区域，范围为 [0, -2×pi×radius2]。计算出的区域使用与半径相同的单位。半径默认为地球半径（以米为单位），在这种情况下，面积以平方米为单位。
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
参数：
返回值：number
用于返回两个 LatLng 之间的距离（以米为单位）。您可以选择指定自定义半径。半径默认为地球的半径。
computeHeading
computeHeading(from, to)
参数：
返回值：number
用于从一个 LatLng 返回另一个 LatLng 的方向。在 [-180,180] 的范围内，方位以与北方所呈的顺时针角度表示。
computeLength
computeLength(path[, radius])
参数：
返回值：number
返回给定路径的长度。
computeOffset
computeOffset(from, distance, heading[, radius])
参数：
返回值：LatLng
返回从与指定的方向的起点移动一定距离（以与北方所呈顺时针角度表示）后所得的 LatLng 。
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
参数：
返回值：LatLng|null
如果提供 LatLng 目标、已行驶米数和原始方向，则返回原点的位置。方位以与北方所呈的顺时针角度来表示。如果没有可用的解决方案，此函数将返回 null。
computeSignedArea
computeSignedArea(loop[, radius])
参数：
返回值：number
返回闭合路径的有符号区域，其中逆时针方向为正数，范围为 [-2×pi×radius2, 2×pi×radius2]。计算出的区域使用与半径相同的单位。半径默认为地球半径（以米为单位），在这种情况下，面积以平方米为单位。

面积使用平行传输方法计算得出；在球面上，绕封闭路径的平行传输将按与路径封闭面积相等的角度扭转。与使用吉拉德、l'Huilier 或 Eriksson 在每个三角形上使用的三角函数相比，这种三脚架更简单、更准确、更可靠。特别要指出的是，由于它不会进行三角测量，除非多边形的边缘（不是对角线）跨度为 180 度，否则不可避免的是不稳定。
interpolate
interpolate(from, to, fraction)
参数：
返回值：LatLng
用于返回 LatLng，位于源 LatLng 和目标 LatLng 之间的指定比例。

poly 命名空间

google.maps.geometry.poly命名空间

用于涉及多边形和多段线的计算的实用函数。

需要 &libraries=geometry 网址参数。请参阅 Maps JavaScript API 中的库。
containsLocation
containsLocation(point, polygon)
参数：
返回值：boolean
用于计算给定点是否位于指定多边形内。
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
参数：
返回值：boolean
用于计算指定点位于多段线的指定范围内，还是位于多段线的边缘或指定范围内。如果提供的点的纬度和经度与边缘最近的点之间的差小于公差，则返回 true。公差默认为 10-9 度。