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
Возвращает строку в формате "lat,lng" для этого объекта LatLng. Значения широты/долготы по умолчанию округляются до 6 цифр после запятой.

Интерфейс LatLngLiteral

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

Во многих случаях вместо объектов LatLng можно использовать объектные литералы. При обнаружении Maps API преобразует их в объекты LatLng.

Примеры:

 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
Долгота в градусах. Значения, которые находятся вне указанного диапазона, пересчитываются так, чтобы уместиться в него. Например, значение -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). Например, значение -190 будет преобразовано в 170. Значение 190 будет преобразовано в -170. Это связано с тем, что долгота измеряется по всей окружности земного шара.
north
Тип:  number
Северная широта в градусах. Значения будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено на -90. Если значение больше 90, оно будет установлено на 90.
south
Тип:  number
Южная широта в градусах. Значения будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено на -90. Если значение больше 90, оно будет установлено на 90.
west
Тип:  number
Западная долгота в градусах. Значения, которые находятся вне указанного диапазона, пересчитываются так, чтобы уместиться в него [-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 можно использовать объектные литералы. При обнаружении Maps API преобразует их в объекты LatLngAltitude.

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

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

Класс 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)
Параметры: 
  • other:  Point optional
Возвращаемое значение:  boolean
Сравнивает две точки.
toString
toString()
Параметры: нет.
Возвращаемое значение:  string
Возвращает строковое представление данной точки.

Класс 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)
Параметры: 
  • other:  Size optional
Возвращаемое значение:  boolean
Сравнивает два размера.
toString
toString()
Параметры: нет.
Возвращаемое значение:  string
Возвращает строковое представление данного размера.

Интерфейс Padding

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 – трехмерный вектор, используемый для стандартных математических преобразований вращения по курсу, наклону и крену.

  • heading – угол в диапазоне [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 интерфейс

Во многих случаях вместо объектов Orientation3D можно использовать объектные литералы. При обнаружении Maps API преобразует их в объекты Orientation3D.

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 можно использовать объектные литералы. При обнаружении Maps API преобразует их в объекты Vector3D.

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