Coordinates

Класс LatLng

google.maps . 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
Возвращает строку вида "lat,lng" для данного LatLng. По умолчанию мы округляем значения широты и долготы до 6 десятичных знаков.

Интерфейс LatLngLiteral

google.maps . 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 Класс 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 Интерфейс 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 Класс 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 Интерфейс 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 Класс 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 Класс 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 Интерфейс google.maps . Padding

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

Интерфейс CircleLiteral

google.maps . CircleLiteral Интерфейс google.maps . CircleLiteral

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

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

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

Класс Ориентация3D

google.maps . 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.

Ориентация3DLiteral интерфейс

google.maps . Orientation3DLiteral интерфейс

Вместо объектов 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.

Класс Вектор3D

google.maps . Vector3D Класс google.maps . Vector3D

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

  • х — действительное число.
  • у — действительное число.
  • 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 Интерфейс google.maps . Vector3DLiteral

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

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