encoding 命名空间
google.maps.geometry.encoding 命名空间
折线编码和解码实用工具
通过调用 const {encoding} = await google.maps.importLibrary("geometry") 进行访问。请参阅 Maps JavaScript API 中的库。
静态方法 | |
|---|---|
decodePath |
decodePath(encodedPath)参数：
用于将编码路径字符串解码为一系列 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 度。 |