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

сферическое пространство имен

google.maps.geometry . spherical пространство имен

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

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

computeArea
computeArea(path[, radiusOfSphere])
Параметры:
Возвращаемое значение: number
Возвращает беззнаковую область замкнутого пути в диапазоне [0, 2×pi×radius²]. Вычисленная площадь использует те же единицы измерения, что и радиус. По умолчанию radiusOfSphere равен радиусу Земли в метрах, и в этом случае площадь указывается в квадратных метрах. Для прохождения Circle необходимо, чтобы radius был установлен на неотрицательное значение. Кроме того, Круг не должен охватывать более 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
Возвращает исходное местоположение, если указано место назначения по широте, пройденные метры и исходный курс. Курсы выражаются в градусах по часовой стрелке от севера. Эта функция возвращает null , если решение недоступно.
computeSignedArea
computeSignedArea(loop[, radius])
Параметры:
Возвращаемое значение: number
Возвращает область со знаком замкнутого пути, где движение против часовой стрелки является положительным, в диапазоне [-2×pi×radius², 2×pi×radius²]. Вычисленная площадь использует те же единицы измерения, что и радиус. По умолчанию радиус равен радиусу Земли в метрах, и в этом случае площадь указывается в квадратных метрах.

Площадь рассчитывается методом параллельного переноса ; параллельный транспорт по замкнутому пути на единичной сфере скручивается на угол, равный площади, заключенной в пути. Это проще, точнее и надежнее, чем триангуляция с использованием Жирара, Л'Юилье или Эрикссона для каждого треугольника. В частности, поскольку он не триангулируется, он не испытывает нестабильности, за исключением неизбежного случая, когда край (а не диагональ) многоугольника охватывает 180 градусов.
interpolate
interpolate(from, to, fraction)
Параметры:
Возвращаемое значение: 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)
Параметры:
Возвращаемое значение: boolean значение
Вычисляет, находится ли данная точка внутри указанного многоугольника.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Параметры:
Возвращаемое значение: boolean значение
Вычисляет, находится ли данная точка на полилинии или рядом с ней или на краю многоугольника в пределах указанного допуска. Возвращает значение true , если разница между широтой и долготой предоставленной точки и ближайшей точкой на краю меньше допуска. Допуск по умолчанию составляет 10 -9 градусов.