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×radius², 2×pi×radius²]. Вычисленная площадь использует те же единицы измерения, что и радиус. По умолчанию радиус равен радиусу Земли в метрах, и в этом случае площадь указывается в квадратных метрах. Площадь рассчитывается методом параллельного переноса ; параллельный транспорт по замкнутому пути на единичной сфере скручивается на угол, равный площади, заключенной в пути. Это проще, точнее и надежнее, чем триангуляция с использованием Жирара, Л'Юилье или Эрикссона для каждого треугольника. В частности, поскольку он не триангулируется, он не испытывает нестабильности, за исключением неизбежного случая, когда край (а не диагональ) многоугольника охватывает 180 градусов.
interpolate	interpolate(from, to, fraction) Параметры: from : LatLng | LatLngLiteral to : LatLng | LatLngLiteral fraction : number Возвращаемое значение: LatLng Возвращает LatLng, который находится на заданной части пути между исходным LatLng и конечным LatLng.

пространство имен поли

google.maps.geometry . poly пространство имен 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 градусов.