Geometry Library

пространство имен кодирования

google.maps.geometry . 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) Параметры: 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×pi×radius²]. Вычисленная площадь использует те же единицы измерения, что и радиус. По умолчанию radiusOfSphere равен радиусу Земли в метрах, и в этом случае площадь указывается в квадратных метрах. Прохождение Circle требует, чтобы radius был установлен на неотрицательное значение. Кроме того, Круг не должен покрывать более 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 Возвращает исходное местоположение, если предоставлена ​​широта и долгота пункта назначения, пройденные метры и первоначальный курс. Заголовки выражены в градусах по часовой стрелке с севера. Эта функция возвращает null , если решение недоступно.
computeSignedArea	computeSignedArea(loop[, radius]) Параметры: loop : Array < LatLng | LatLngLiteral >| MVCArray < LatLng | LatLngLiteral > radius : number optional Возвращаемое значение: number Возвращает область со знаком замкнутого контура, где против часовой стрелки положительное значение, в диапазоне [-2×pi×радиус², 2×pi×радиус²]. Вычисленная площадь использует те же единицы измерения, что и радиус. Радиус по умолчанию равен радиусу Земли в метрах, и в этом случае площадь выражается в квадратных метрах. Площадь вычисляется методом параллельного переноса ; параллельный транспорт по замкнутому пути на единичной сфере закручивается на угол, равный площади, ограниченной путем. Это проще, точнее и надежнее, чем триангуляция с использованием Жирара, Л'Юилье или Эрикссона для каждого треугольника. В частности, поскольку он не триангулируется, он не подвержен нестабильности, за исключением неизбежного случая, когда ребро (не диагональ) многоугольника простирается на 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 градусов.