Объявление. Скоро на платформе Google Maps появится новый стиль базовой карты. Это обновление стиля карты включает новую цветовую палитру по умолчанию, модернизированные булавки, а также улучшения интерфейса и удобства использования карты. Все стили карт будут автоматически обновлены в марте 2025 г. Дополнительную информацию о доступности и о том, как принять участие раньше, см. в разделе Новый стиль карты для платформы Google Maps .

Эта страница переведена с помощью Cloud Translation API.

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 класс

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

Доступ осуществляется путем вызова 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 градусов.

Статические методы

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 градусов.