Geometry Library

класс кодирования

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) Параметры: path : Array < LatLng | LatLngLiteral >| MVCArray < LatLng | LatLngLiteral > Возвращаемое значение: string Кодирует последовательность LatLng в закодированную строку пути.

сферический класс

google.maps.geometry . spherical класс

Вспомогательные функции для вычисления геодезических углов, расстояний и площадей. Радиус по умолчанию равен радиусу Земли, равному 6378137 метрам.

Доступ осуществляется путем вызова const {spherical} = await google.maps.importLibrary("geometry") .
См. Библиотеки в Maps JavaScript API .

Статические методы
computeArea	computeArea(path[, radiusOfSphere]) Параметры: path : Array < LatLng | LatLngLiteral >| MVCArray < LatLng | LatLngLiteral >| Circle | CircleLiteral | LatLngBounds | LatLngBoundsLiteral radiusOfSphere : number optional Возвращаемое значение: number Возвращает беззнаковую площадь замкнутого контура в диапазоне [0, 2×пи×радиус²]. Вычисленная площадь измеряется в тех же единицах, что и радиус. Значение radiusOfSphere по умолчанию равно радиусу Земли в метрах, в этом случае площадь измеряется в квадратных метрах. Для передачи значения Circle необходимо задать radius неотрицательным значением. Кроме того, Circle не должен покрывать более 100% сферы. При передаче значения LatLngBounds южная LatLng не может быть севернее северной LatLng.
computeDistanceBetween	computeDistanceBetween(from, to[, radius]) Параметры: from : LatLng | LatLngLiteral to : LatLng | LatLngLiteral radius : number optional Возвращаемое значение: number Возвращает расстояние в метрах между двумя точками LatLng. При желании можно указать свой радиус. По умолчанию радиус равен радиусу Земли.
computeHeading	computeHeading(from, to) Параметры: from : LatLng | LatLngLiteral to : LatLng | LatLngLiteral Возвращаемое значение: number Возвращает направление из одной системы координат LatLng в другую систему координат LatLng. Направления выражаются в градусах по часовой стрелке от севера в диапазоне [-180,180].
computeLength	computeLength(path[, radius]) Параметры: path : Array < LatLng | LatLngLiteral >| MVCArray < LatLng | LatLngLiteral > radius : number optional Возвращаемое значение: number Возвращает длину заданного пути.
computeOffset	computeOffset(from, distance, heading[, radius]) Параметры: from : LatLng | LatLngLiteral distance : number heading : number radius : number optional Возвращаемое значение: LatLng Возвращает LatLng, полученный в результате перемещения на расстояние от начала координат в указанном направлении (выраженном в градусах по часовой стрелке от севера).
computeOffsetOrigin	computeOffsetOrigin(to, distance, heading[, radius]) Параметры: to : LatLng | LatLngLiteral distance : number heading : number radius : number optional Возвращаемое значение: LatLng |null Возвращает местоположение исходной точки при наличии координат LatLng пункта назначения, пройденного расстояния в метрах и исходного направления. Направления выражаются в градусах по часовой стрелке от севера. Эта функция возвращает null если решение недоступно.
computeSignedArea	computeSignedArea(loop[, radius]) Параметры: loop : Array < LatLng | LatLngLiteral >| MVCArray < LatLng | LatLngLiteral > radius : number optional Возвращаемое значение: number Возвращает площадь замкнутого контура со знаком, где направление против часовой стрелки положительно, в диапазоне [-2×пи×радиус², 2×пи×радиус²]. Вычисленная площадь измеряется в тех же единицах, что и радиус. Радиус по умолчанию равен радиусу Земли в метрах, в этом случае площадь измеряется в квадратных метрах. Площадь вычисляется методом параллельного переноса : параллельный перенос по замкнутому контуру на единичной сфере закручивается на угол, равный площади, охватываемой этим контуром. Это проще, точнее и надёжнее, чем триангуляция с использованием методов Жирара, Люилье или Эрикссона для каждого треугольника. В частности, поскольку метод не триангулирует, он не подвержен неустойчивости, за исключением неизбежного случая, когда ребро (а не диагональ) многоугольника охватывает 180 градусов.
interpolate	interpolate(from, to, fraction) Параметры: from : LatLng | LatLngLiteral to : LatLng | LatLngLiteral fraction : number Возвращаемое значение: LatLng Возвращает LatLng, который находится на заданной части пути между исходной точкой LatLng и конечной точкой LatLng.

поли класс

google.maps.geometry . poly

Вспомогательные функции для вычислений с участием многоугольников и полилиний.

Доступ осуществляется путем вызова const {poly} = await google.maps.importLibrary("geometry") .
См. Библиотеки в Maps JavaScript API .

Статические методы
containsLocation	containsLocation(point, polygon) Параметры: point : LatLng | LatLngLiteral polygon : Polygon Возвращаемое значение: boolean Вычисляет, лежит ли заданная точка внутри указанного многоугольника.
isLocationOnEdge	isLocationOnEdge(point, poly[, tolerance]) Параметры: point : LatLng | LatLngLiteral poly : Polygon | Polyline tolerance : number optional Возвращаемое значение: boolean Вычисляет, лежит ли заданная точка на ломаной линии или на краю многоугольника или вблизи них в пределах заданного допуска. Возвращает значение true , если разница между широтой и долготой указанной точки и ближайшей точки на краю меньше допуска. Допуск по умолчанию равен ^10-9 градуса.