класс кодирования
google.maps.geometry . encoding
Утилиты для кодирования и декодирования полилиний.
Доступ осуществляется путем вызова const {encoding} = await google.maps.importLibrary("geometry") .
См. Библиотеки в Maps JavaScript API .
Статические методы | |
|---|---|
decodePath | decodePath(encodedPath) Параметры:
Декодирует закодированную строку пути в последовательность 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×пи×радиус²]. Вычисленная площадь измеряется в тех же единицах, что и радиус. Значение radiusOfSphere по умолчанию равно радиусу Земли в метрах, в этом случае площадь измеряется в квадратных метрах. Для передачи значения Circle необходимо задать radius неотрицательным значением. Кроме того, Circle не должен покрывать более 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×пи×радиус², 2×пи×радиус²]. Вычисленная площадь измеряется в тех же единицах, что и радиус. Радиус по умолчанию равен радиусу Земли в метрах, в этом случае площадь измеряется в квадратных метрах. Площадь вычисляется методом параллельного переноса : параллельный перенос по замкнутому контуру на единичной сфере закручивается на угол, равный площади, охватываемой этим контуром. Это проще, точнее и надёжнее, чем триангуляция с использованием методов Жирара, Люилье или Эрикссона для каждого треугольника. В частности, поскольку метод не триангулирует, он не подвержен неустойчивости, за исключением неизбежного случая, когда ребро (а не диагональ) многоугольника охватывает 180 градусов. |
interpolate | interpolate(from, to, fraction) Параметры:
Возвращаемое значение: LatLng Возвращает LatLng, который находится на заданной части пути между исходной точкой LatLng и конечной точкой LatLng. |
поли класс
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 градуса. |