Geometry Library

encoding 命名空间

google.maps.geometry.encoding 命名空间

折线编码和解码实用工具

通过调用 const {encoding} = await google.maps.importLibrary("geometry") 进行访问。请参阅 Maps JavaScript API 中的库。
decodePath
decodePath(encodedPath)
参数： 
  • encodedPath：string
返回值：  Array<LatLng>
用于将编码路径字符串解码为一系列 LatLng。
encodePath
encodePath(path)
参数： 
返回值：  string
用于将一系列 LatLng 编码为编码路径字符串。

spherical 命名空间

google.maps.geometry.spherical 命名空间

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

通过调用 const {spherical} = await google.maps.importLibrary("geometry") 进行访问。请参阅 Maps JavaScript API 中的库。
computeArea
computeArea(path[, radiusOfSphere])
参数： 
返回值：  number
返回闭合路径的无符号面积，范围为 [0, 2×π×半径²]。计算出的面积使用与半径相同的单位。radiusOfSphere 默认为地球的半径（以米为单位），在这种情况下，面积以平方米为单位。如需传递 Circle，必须将 radius 设置为非负值。此外，圆形不得超过球体的 100%。传递 LatLngBounds 时，南纬度不能比北纬度更高。
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×π×半径², 2×π×半径²]。计算出的面积使用与半径相同的单位。半径默认为地球的半径（以米为单位），在这种情况下，面积以平方米为单位。

面积是使用平行运输方法计算得出的；在单位球面上围绕封闭路径的平行运输会扭转一个角度，该角度等于路径所围合的面积。与对每个三角形使用 Girard、l'Huilier 或 Eriksson 进行三角化相比，这种方法更简单、更准确、更稳健。具体而言，由于它不会进行三角剖分，因此不会出现不稳定的情况，除非多边形的边（而非对角线）跨度达到 180 度，这种情况不可避免。
interpolate
interpolate(from, to, fraction)
参数： 
返回值：  LatLng
返回位于起始 LatLng 和目标 LatLng 之间给定路程分之一处的 LatLng。

poly 命名空间

google.maps.geometry.poly 命名空间

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

通过调用 const {poly} = await google.maps.importLibrary("geometry") 进行访问。请参阅 Maps JavaScript API 中的库。
containsLocation
containsLocation(point, polygon)
参数： 
返回值：  boolean
计算给定点是否位于指定多边形内。
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
参数： 
返回值：  boolean
计算给定点是否位于多段线或多边形边缘上或附近（在指定公差范围内）。如果所提供点的经纬度与边缘上最近点的经纬度之差小于公差，则返回 true。公差默认为 10-9 度。