Geometry Library

编码

google.maps.geometry.encoding

折线编码和解码实用工具

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

decodePath
decodePath(encodedPath)
参数: 
  • encodedPathstring
返回值:  Array<LatLng>
用于将编码路径字符串解码为一系列 LatLng。
encodePath
encodePath(path)
返回值:  string
用于将一系列 LatLng 编码为编码路径字符串。

球面

google.maps.geometry.spherical

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

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

computeArea
computeArea(path[, radiusOfSphere])
返回值:  number
返回闭合路径的无符号面积,范围为 [0, 2×pi×半径²]。计算出的面积与半径使用相同的单位。radiusOfSphere 默认为地球半径(以米为单位),在这种情况下,面积以平方米为单位。传递 Circle 需要将 radius 设置为非负值。此外,圆圈覆盖的球面面积不得超过球面的 100%。传递 LatLngBounds 时,南方的 LatLng 不能比北方的 LatLng 更靠北。
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×radius², 2×pi×radius²]。计算出的面积与半径使用相同的单位。半径默认为地球半径(以米为单位),在这种情况下,面积以平方米为单位。

面积是使用平行输运方法计算的;单位球面上闭合路径周围的平行输运会扭曲一个角度,该角度等于路径所围成的面积。与在每个三角形上使用 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 度。