Coordinates

Класс LatLng

class google.maps.LatLng
library "core"

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");
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
Функция сравнения двух объектов LatLng. Возвращает true, если координаты находятся в пределах 1e-9 друг от друга, и false в противном случае.
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
расширен DirectionalLocationLiteral, LatLngAltitudeLiteral
реализован DirectionalLocation, LatLngAltitude

Во многих случаях вместо объектов 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

class google.maps.LatLngBounds
library "core"

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

const {LatLngBounds} = await google.maps.importLibrary("core");
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 реализует LatLngAltitudeLiteral, LatLngLiteral
расширен DirectionalLocation
библиотека "core"

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

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

const {LatLngAltitude} = await google.maps.importLibrary("core");
LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Параметры:
  • value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Начальное значение.
  • noClampNoWrap: boolean optional Сохранять ли значения инициализации, даже если они не являются допустимыми значениями широты в диапазоне [-90, 90] или допустимыми значениями долготы в диапазоне [-180, 180]. По умолчанию используется значение false, которое включает ограничение широты и перенос долготы.
altitude
readonly
Тип: number
Возвращает высоту.
lat
readonly
Тип: number
Возвращает широту.
lng
readonly
Тип: number
Возвращает долготу.
equals
equals(other)
Параметры:
Возвращаемое значение: boolean (равны ли два объекта).
Функция сравнения для двух объектов LatLngAltitude. Возвращает true, если координаты находятся в пределах 1e-9 друг от друга, и false в противном случае.
toJSON
toJSON([key])
Параметры:
  • key: string optional
Возвращаемое значение: LatLngAltitudeLiteral
Преобразует в простой объект.

Интерфейс LatLngAltitudeLiteral

interface google.maps.LatLngAltitudeLiteral extends LatLngLiteral
extended by DirectionalLocationLiteral
implemented by DirectionalLocation, LatLngAltitude

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

Класс Point

class google.maps.Point
library "core" 

const {Point} = await google.maps.importLibrary("core");
Point
Point(x, y)
Параметры:
  • x: number
  • y: number
Точка на двумерной плоскости.
x
Тип: number
Координата X
y
Тип: number
Координата Y
equals
equals(other)
Параметры:
Возвращаемое значение: boolean
Сравнивает две точки.
toString
toString()
Параметры: нет.
Возвращаемое значение: string
Возвращает строковое представление данной точки.

Класс Size

class google.maps.Size
library "core" 

const {Size} = await google.maps.importLibrary("core");
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
необязательно
Тип: number optional
Нижнее поле в пикселях.
left
необязательно
Тип: number optional
Поле слева в пикселях.
right
необязательно
Тип: number optional
Поле справа в пикселях.
top
необязательно
Тип: number optional
Отступ сверху в пикселях.

Интерфейс CircleLiteral

interface google.maps.CircleLiteral extends CircleOptions

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

Класс Orientation3D

класс google.maps.Orientation3D реализует Orientation3DLiteral
библиотека "core"

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

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

const {Orientation3D} = await google.maps.importLibrary("core");
Orientation3D
Orientation3D(value)
Параметры:
heading
readonly
Тип: number
По умолчанию: 0.
Вращение вокруг оси Z (перпендикулярно поверхности Земли). Значение 0 (по умолчанию) соответствует северу. Положительное значение соответствует повороту по часовой стрелке вокруг оси Z и указывается в градусах от 0 до 360. Значения, которые находятся вне указанного диапазона, пересчитываются так, чтобы уместиться в него. Например, значение -190 будет преобразовано в 170. Значение 530 также будет преобразовано в 170.
roll
readonly
Тип: number
По умолчанию: 0.
Поворот вокруг оси Y. Положительное значение соответствует повороту по часовой стрелке вокруг оси Y и указывается в градусах от 0 до 360. Значения, которые находятся вне указанного диапазона, пересчитываются так, чтобы уместиться в него. Например, значение -190 будет преобразовано в 170. Значение 530 также будет преобразовано в 170.
tilt
readonly
Тип: number
По умолчанию: 0.
Вращение вокруг оси X. Положительное значение соответствует повороту по часовой стрелке вокруг оси X и указывается в градусах от 0 до 360. Значения, которые находятся вне указанного диапазона, пересчитываются так, чтобы уместиться в него. Например, значение -190 будет преобразовано в 170. Значение 530 также будет преобразовано в 170.
equals
equals(other)
Параметры:
Возвращаемое значение: boolean (равны ли два объекта).
Функция сравнения.
toJSON
toJSON([key])
Параметры:
  • key: string optional
Возвращаемое значение: Orientation3DLiteral
Преобразует в простой объект.

Интерфейс Orientation3DLiteral

интерфейс google.maps.Orientation3DLiteral
реализован Orientation3D

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

Класс Vector3D

класс google.maps.Vector3D реализует Vector3DLiteral
библиотека "core"

Vector3D – это трехмерный вектор, используемый для стандартных математических операций, таких как масштабирование границ трехмерного объекта по локальным осям X, Y и Z.

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

const {Vector3D} = await google.maps.importLibrary("core");
Vector3D
Vector3D(value)
Параметры:
x
readonly
Тип: number
X-компонент трехмерного вектора.
y
readonly
Тип: number
Y-компонент трехмерного вектора.
z
readonly
Тип: number
Z-компонент трехмерного вектора.
equals
equals(other)
Параметры:
Возвращаемое значение: boolean
Функция сравнения.
toJSON
toJSON([key])
Параметры:
  • key: string optional
Возвращаемое значение: Vector3DLiteral
Преобразует в простой объект.

Интерфейс Vector3DLiteral

интерфейс google.maps.Vector3DLiteral
реализован Vector3D

Во многих случаях вместо объектов Vector3D можно использовать объектные литералы. При обнаружении Maps API преобразует их в объекты Vector3D.
x
Тип: number
X-компонент трехмерного вектора.
y
Тип: number
Y-компонент трехмерного вектора.
z
Тип: number
Z-компонент трехмерного вектора.