Coordinates

Класс LatLng

google.maps . LatLng

LatLng — это точка в географических координатах: широта и долгота.

  • Широта находится в диапазоне от -90 до 90 градусов включительно. Значения выше или ниже этого диапазона будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено равным -90. А если значение больше 90, оно будет установлено равным 90.
  • Диапазон долготы составляет от -180 до 180 градусов включительно. Значения выше или ниже этого диапазона будут преобразованы таким образом, чтобы попасть в него. Например, значение -190 будет преобразовано в 170. Значение 190 будет преобразовано в -170. Это отражает тот факт, что долгота циклически повторяется вокруг земного шара.
Хотя проекция карты по умолчанию связывает долготу с x-координатой карты, а широту с y-координатой, координата широты всегда записывается первой , а затем долгота.
Обратите внимание, что вы не можете изменить координаты LatLng . Если вы хотите вычислить другую точку, вам придётся создать новую.

Большинство методов, принимающих объекты LatLng , также принимают объект LatLngLiteral , поэтому следующие операторы эквивалентны:

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151});

Конструктор также принимает объекты LatLngLiteral и LatLng . Если конструктору передан экземпляр LatLng , создаётся его копия.

Возможные вызовы конструктора приведены ниже:

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);

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

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Параметры:
  • latOrLatLngOrLatLngLiteral : number| LatLngLiteral | LatLng
  • lngOrNoClampNoWrap : number|boolean optional
  • noClampNoWrap : boolean optional
Создаёт объект LatLng , представляющий географическую точку. Широта указывается в градусах в диапазоне [-90, 90]. Долгота указывается в градусах в диапазоне [-180, 180]. Установите noClampNoWrap в true , чтобы включить значения за пределами этого диапазона. Обратите внимание на порядок широты и долготы.
equals
equals(other)
Параметры:
Возвращаемое значение: boolean
Функция сравнения.
lat
lat()
Параметры: нет
Возвращаемое значение: number
Возвращает широту в градусах.
lng
lng()
Параметры: нет
Возвращаемое значение: number
Возвращает долготу в градусах.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: LatLngLiteral
Преобразует в JSON-представление. Эта функция предназначена для использования через JSON.stringify .
toString
toString()
Параметры: нет
Возвращаемое значение: string
Преобразует в строковое представление.
toUrlValue
toUrlValue([precision])
Параметры:
  • precision : number optional
Возвращаемое значение: string
Возвращает строку в формате «широта, долгота» для данного значения LatLng. По умолчанию значения широты и долготы округляются до 6 знаков после запятой.

Интерфейс LatLngLiteral

google.maps . LatLngLiteral

Во многих местах для удобства вместо объектов LatLng принимаются литералы объектов. Они преобразуются в объекты LatLng при их обнаружении API Карт.

Примеры: 

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

Литералы объектов LatLng не поддерживаются в библиотеке Geometry.

lat
Тип: number
Широта в градусах. Значения будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено равным -90. А если значение больше 90, оно будет установлено равным 90.
lng
Тип: number
Долгота в градусах. Значения вне диапазона [-180, 180] будут преобразованы таким образом, чтобы попасть в этот диапазон. Например, значение -190 будет преобразовано в 170. Значение 190 будет преобразовано в -170. Это отражает тот факт, что долгота циклически перемещается вокруг земного шара.

Класс LatLngBounds

google.maps . LatLngBounds

Экземпляр LatLngBounds представляет собой прямоугольник в географических координатах, включая тот, который пересекает 180-градусный долготный меридиан.

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

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Параметры:
Строит прямоугольник по точкам в его юго-западном и северо-восточном углах.
MAX_BOUNDS LatLngBounds — максимальные границы Земли. Эти границы будут охватывать весь земной шар.
contains
contains(latLng)
Параметры:
Возвращаемое значение: boolean
Возвращает значение true если заданные широта/долгота находятся в указанных пределах.
equals
equals(other)
Параметры:
Возвращаемое значение: boolean
Возвращает значение true , если эти границы приблизительно равны заданным границам.
extend
extend(point)
Параметры:
Возвращаемое значение: LatLngBounds
Расширяет эти границы, чтобы включить заданную точку.
getCenter
getCenter()
Параметры: нет
Возвращаемое значение: LatLng
Вычисляет центр этого LatLngBounds
getNorthEast
getNorthEast()
Параметры: нет
Возвращаемое значение: LatLng
Возвращает северо-восточный угол данной границы.
getSouthWest
getSouthWest()
Параметры: нет
Возвращаемое значение: LatLng
Возвращает юго-западный угол данной границы.
intersects
intersects(other)
Параметры:
Возвращаемое значение: boolean
Возвращает значение true , если эта граница имеет общие точки с другими границами.
isEmpty
isEmpty()
Параметры: нет
Возвращаемое значение: boolean
Возвращает, если границы пусты.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: LatLngBoundsLiteral
Преобразует в JSON-представление. Эта функция предназначена для использования через JSON.stringify .
toSpan
toSpan()
Параметры: нет
Возвращаемое значение: LatLng
Преобразует заданные границы карты в диапазон широты и долготы.
toString
toString()
Параметры: нет
Возвращаемое значение: string
Преобразует в строку.
toUrlValue
toUrlValue([precision])
Параметры:
  • precision : number optional
Возвращаемое значение: string
Возвращает строку вида «lat_lo,lng_lo,lat_hi,lng_hi» для этих границ, где «lo» соответствует юго-западному углу ограничивающего прямоугольника, а «hi» соответствует северо-восточному углу этого прямоугольника.
union
union(other)
Параметры:
Возвращаемое значение: LatLngBounds
Расширяет эти границы, чтобы они включали объединение этих и заданных границ.

Интерфейс LatLngBoundsLiteral

google.maps . LatLngBoundsLiteral

Вместо объектов LatLngBounds в API принимаются литералы объектов. Они автоматически преобразуются в объекты LatLngBounds . Необходимо задать все south , west , north и east , иначе будет выдано исключение.

east
Тип: number
Восточная долгота в градусах. Значения вне диапазона [-180, 180] будут преобразованы в диапазон [-180, 180]. Например, значение -190 будет преобразовано в 170. Значение 190 будет преобразовано в -170. Это отражает тот факт, что долгота циклически перемещается вокруг земного шара.
north
Тип: number
Северная широта в градусах. Значения будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено равным -90. А если значение больше 90, оно будет установлено равным 90.
south
Тип: number
Южная широта в градусах. Значения будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено равным -90. А если значение больше 90, оно будет установлено равным 90.
west
Тип: number
Западная долгота в градусах. Значения вне диапазона [-180, 180] будут преобразованы в диапазон [-180, 180]. Например, значение -190 будет преобразовано в 170. Значение 190 будет преобразовано в -170. Это отражает тот факт, что долгота циклически перемещается по всему земному шару.

Класс LatLngAltitude

google.maps . LatLngAltitude

LatLngAltitude — это трехмерная точка в географических координатах: широта, долгота и высота.

  • Широта находится в диапазоне от -90 до 90 градусов включительно. Значения выше или ниже этого диапазона будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено равным -90. А если значение больше 90, оно будет установлено равным 90.
  • Диапазон долготы составляет от -180 до 180 градусов включительно. Значения выше или ниже этого диапазона будут преобразованы таким образом, чтобы попасть в него. Например, значение -190 будет преобразовано в 170. Значение 190 будет преобразовано в -170. Это отражает тот факт, что долгота циклически повторяется вокруг земного шара.
  • Высота измеряется в метрах. Положительные значения обозначают высоту над уровнем земли, отрицательные — высоту под поверхностью земли.

Этот класс реализует LatLngAltitudeLiteral .

Этот класс реализует LatLngLiteral .

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

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Параметры:
  • value : LatLngAltitude | LatLngAltitudeLiteral | LatLng | LatLngLiteral Инициализирующее значение.
  • noClampNoWrap : boolean optional Сохранять ли значения инициализации, даже если они не обязательно являются допустимыми значениями широты в диапазоне [-90, 90] или допустимыми значениями долготы в диапазоне [-180, 180]. Значение по умолчанию — false , что включает фиксацию широты и перенос долготы.
altitude
Тип: number
Возвращает высоту.
lat
Тип: number
Возвращает широту.
lng
Тип: number
Возвращает долготу.
equals
equals(other)
Параметры:
  • other : LatLngAltitude optional Другой объект LatLngAltitude.
Возвращаемое значение: boolean Равны ли два объекта.
Функция сравнения.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: LatLngAltitudeLiteral JSON-представление этого объекта.

Интерфейс LatLngAltitudeLiteral

google.maps . LatLngAltitudeLiteral

Для удобства во многих местах вместо объектов LatLngAltitude принимаются литералы объектов. Они преобразуются в объекты LatLngAltitude при их обнаружении API Карт.

Этот интерфейс расширяет LatLngLiteral .

altitude
Тип: number
По умолчанию: 0
Расстояние (в метрах) над поверхностью земли. Отрицательное значение означает расстояние под поверхностью земли.
lat
Тип: number
Широта в градусах. Значения будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено равным -90. А если значение больше 90, оно будет установлено равным 90.
lng
Тип: number
Долгота в градусах. Значения вне диапазона [-180, 180] будут преобразованы таким образом, чтобы попасть в этот диапазон. Например, значение -190 будет преобразовано в 170. Значение 190 будет преобразовано в -170. Это отражает тот факт, что долгота циклически перемещается вокруг земного шара.

класс точки

google.maps . Point

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

Point
Point(x, y)
Параметры:
  • x : number
  • y : number
Точка на двумерной плоскости.
x
Тип: number
Координата X
y
Тип: number
Координата Y
equals
equals(other)
Параметры:
Возвращаемое значение: boolean
Сравнивает две точки
toString
toString()
Параметры: нет
Возвращаемое значение: string
Возвращает строковое представление этой точки.

Размерный класс

google.maps . Size

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

Size
Size(width, height[, widthUnit, heightUnit])
Параметры:
  • width : number
  • height : number
  • widthUnit : string optional
  • heightUnit : string optional
Двумерный размер, где ширина — это расстояние по оси x, а высота — это расстояние по оси y.
height
Тип: number
Высота по оси Y в пикселях.
width
Тип: number
Ширина по оси x, в пикселях.
equals
equals(other)
Параметры:
Возвращаемое значение: boolean
Сравнивает два размера.
toString
toString()
Параметры: нет
Возвращаемое значение: string
Возвращает строковое представление этого размера.

Интерфейс заполнения

google.maps . Padding

bottom optional
Тип: number optional
Отступ снизу, в пикселях.
left optional
Тип: number optional
Отступ слева, в пикселях.
right optional
Тип: number optional
Отступ справа, в пикселях.
top optional
Тип: number optional
Отступ сверху, в пикселях.

Интерфейс CircleLiteral

google.maps . CircleLiteral

Литерал объекта, представляющий собой круг.

Этот интерфейс расширяет CircleOptions .

center
Центр Круга.
radius
Тип: number
Радиус в метрах на поверхности Земли.
Наследуется: clickable , draggable , editable , fillColor , fillOpacity , map , strokeColor , strokeOpacity , strokePosition , strokeWeight , visible , zIndex

Класс Orientation3D

google.maps . Orientation3D

Orientation3D — это трехмерный вектор, используемый для стандартных математических преобразований вращения по направлению, наклону и крену.

  • Направление — это угол в диапазоне [0, 360) градусов.
  • Наклон — это угол в диапазоне [0, 360) градусов.
  • крен — это угол в диапазоне [0, 360) градусов.

Этот класс реализует Orientation3DLiteral .

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

Orientation3D
Orientation3D(value)
Параметры:
heading
Тип: number
По умолчанию: 0
Вращение вокруг оси Z (перпендикулярной поверхности Земли). Значение 0 (по умолчанию) соответствует направлению на север. Положительное вращение происходит по часовой стрелке вокруг оси Z и задаётся в градусах от 0 до 360. Значения выше или ниже этого диапазона будут свернуты так, чтобы попасть в этот диапазон. Например, значение -190 будет преобразовано в 170. Значение 530 также будет преобразовано в 170.
roll
Тип: number
По умолчанию: 0
Вращение вокруг оси Y. Положительное вращение происходит по часовой стрелке вокруг оси Y и задаётся в градусах от 0 до 360. Значения выше или ниже этого диапазона будут свернуты так, чтобы попасть в него. Например, значение -190 будет преобразовано в 170. Значение 530 также будет преобразовано в 170.
tilt
Тип: number
По умолчанию: 0
Вращение вокруг оси X. Положительное вращение происходит по часовой стрелке вокруг оси X и задаётся в градусах от 0 до 360. Значения выше или ниже этого диапазона будут свернуты так, чтобы попасть в него. Например, значение -190 будет преобразовано в 170. Значение 530 также будет преобразовано в 170.
equals
equals(other)
Параметры:
Возвращаемое значение: boolean Равны ли два объекта.
Функция сравнения.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Orientation3DLiteral
Преобразует в JSON-представление. Эта функция предназначена для использования через JSON.stringify.

Интерфейс Orientation3DLiteral

google.maps . Orientation3DLiteral interface

Во многих случаях для удобства вместо объектов Orientation3D принимаются литералы объектов. Они преобразуются в объекты Orientation3D при их обнаружении API Карт.

heading optional
Тип: number optional
Вращение вокруг оси Z (перпендикулярно поверхности Земли). Значение 0 (по умолчанию) соответствует направлению на север. Положительное вращение происходит по часовой стрелке вокруг оси Z и задаётся в градусах от 0 до 360.
roll optional
Тип: number optional
Вращение вокруг оси Y. Положительное вращение происходит по часовой стрелке вокруг оси Y и задаётся в градусах от 0 до 360.
tilt optional
Тип: number optional
Вращение вокруг оси X. Положительное вращение происходит по часовой стрелке вокруг оси X и задаётся в градусах от 0 до 360.

Класс Vector3D

google.maps . Vector3D

Vector3D — это трехмерный вектор, используемый для стандартных математических операций, таких как масштабирование границ трехмерного объекта вдоль локальных осей x, y и z.

  • x — действительное число.
  • y — действительное число.
  • z — действительное число.

Этот класс реализует Vector3DLiteral .

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

Vector3D
Vector3D(value)
Параметры:
x
Тип: number
X-компонента трехмерного вектора.
y
Тип: number
Y-компонента трехмерного вектора.
z
Тип: number
Z-компонента трехмерного вектора.
equals
equals(other)
Параметры:
Возвращаемое значение: boolean
Функция сравнения.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Vector3DLiteral
Преобразует в JSON-представление. Эта функция предназначена для использования через JSON.stringify.

Интерфейс Vector3DLiteral

google.maps . Vector3DLiteral

Во многих местах для удобства вместо объектов Vector3D принимаются литералы объектов. Они преобразуются в объекты Vector3D при обнаружении их API Карт.

x
Тип: number
X-компонента трехмерного вектора.
y
Тип: number
Y-компонента трехмерного вектора.
z
Тип: number
Z-компонента трехмерного вектора.