Maps

Класс карты

google.maps . Map Класс google.maps . Map

Этот класс расширяет MVCObject .

Получите доступ, вызвав const {Map} = await google.maps.importLibrary("maps") . См. Библиотеки в Maps JavaScript API .

Map
Map(mapDiv[, opts])
Параметры:
  • mapDiv : HTMLElement Карта будет отображаться, чтобы заполнить этот элемент.
  • opts : MapOptions optional
Создает новую карту внутри заданного HTML-контейнера, который обычно представляет собой элемент DIV .
controls
Тип: Array < MVCArray < HTMLElement >>
Дополнительные элементы управления для прикрепления к карте. Чтобы добавить элемент управления на карту, добавьте <div> элемента управления в MVCArray , соответствующий ControlPosition , в котором он должен отображаться.
data
Тип: Data
Экземпляр Data , привязанный к карте. Добавьте объекты к этому объекту Data , чтобы удобно отображать их на этой карте.
mapTypes
Реестр экземпляров MapType по идентификатору строки.
overlayMapTypes
Тип: MVCArray < MapType optional >
Дополнительные типы карт для наложения. Типы наложенных карт будут отображаться поверх базовой карты, к которой они прикреплены, в том порядке, в котором они появляются в массиве overlayMapTypes (наложения с более высокими значениями индекса отображаются перед наложениями с более низкими значениями индекса).
fitBounds
fitBounds(bounds[, padding])
Параметры:
  • bounds : LatLngBounds | LatLngBoundsLiteral Границы для отображения.
  • padding : number| Padding optional Отступ в пикселях. Границы будут соответствовать той части карты, которая останется после удаления отступов. Числовое значение даст одинаковое заполнение на всех 4 сторонах. Укажите здесь 0, чтобы сделать fitBounds идемпотентом результата getBounds.
Возвращаемое значение: нет
Устанавливает область просмотра, чтобы она содержала заданные границы.
Примечание. Когда для карты установлено значение display: none , функция fitBounds считывает размер карты как 0x0 и, следовательно, ничего не делает. Чтобы изменить область просмотра, когда карта скрыта, установите для карты visibility: hidden , тем самым гарантируя, что div карты имеет реальный размер. Для векторных карт этот метод устанавливает нулевые значения наклона и направления карты по умолчанию. Вызов этого метода может вызвать плавную анимацию, поскольку карта перемещается и масштабируется, чтобы соответствовать границам. Будет ли этот метод анимировать, зависит от внутренней эвристики.
getBounds
getBounds()
Параметры: Нет
Возвращаемое значение: LatLngBounds |undefined Границы широты/долготы текущего окна просмотра.
Возвращает границы широты/долготы текущего окна просмотра. Если видно более одной копии мира, границы по долготе варьируются от -180 до 180 градусов включительно. Если карта еще не инициализирована или центр и масштаб не установлены, результат undefined . Для векторных карт с ненулевым наклоном или направлением возвращаемые границы широты/долготы представляют собой наименьшую ограничивающую рамку, включающую видимую область окна просмотра карты. См. MapCanvasProjection.getVisibleRegion для получения точной видимой области окна просмотра карты.
getCenter
getCenter()
Параметры: Нет
Возвращаемое значение: LatLng |undefined
Возвращает положение, отображаемое в центре карты. Обратите внимание, что этот объект LatLng не упакован. См. LatLng для получения дополнительной информации. Если центр или границы не установлены, результат undefined .
getClickableIcons
getClickableIcons()
Параметры: Нет
Возвращаемое значение: boolean|undefined
Возвращает кликабельность значков карты. Значок карты обозначает достопримечательность, также известную как POI. Если возвращаемое значение равно true , значки на карте можно щелкнуть.
Beta getDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Параметры:
  • datasetId : string
Возвращаемое значение: FeatureLayer
Возвращает FeatureLayer для указанного datasetId . Идентификаторы наборов данных должны быть настроены в Google Cloud Console. Если идентификатор набора данных не связан со стилем карты или стиль, управляемый данными, недоступен (нет идентификатора карты, нет векторных листов, векторных слоев стиля, управляемого данными, или наборов данных, настроенных в стиле карты), это регистрирует ошибка, и результирующий FeatureLayer.isAvailable будет ложным.
getDiv
getDiv()
Параметры: Нет
Возвращаемое значение: HTMLElement Объект mapDiv карты.
getFeatureLayer
getFeatureLayer(featureType)
Параметры:
Возвращаемое значение: FeatureLayer
Возвращает FeatureLayer определенного FeatureType . FeatureLayer должен быть включен в Google Cloud Console. Если FeatureLayer указанного FeatureType не существует на этой карте или стиль на основе данных недоступен (нет идентификатора карты, нет векторных листов и нет FeatureLayer , включенного в стиле карты), это регистрирует ошибку, и в результате FeatureLayer.isAvailable будет ложным.
getHeading
getHeading()
Параметры: Нет
Возвращаемое значение: number|undefined
Возвращает направление карты по компасу. Значение курса измеряется в градусах (по часовой стрелке) от основного направления на север. Если карта еще не инициализирована, результат undefined .
getMapCapabilities
getMapCapabilities()
Параметры: Нет
Возвращаемое значение: MapCapabilities
Информирует вызывающую сторону о текущих возможностях, доступных для карты, на основе предоставленного идентификатора карты.
getMapTypeId
getMapTypeId()
Параметры: Нет
Возвращаемое значение: MapTypeId |string|undefined
getProjection
getProjection()
Параметры: Нет
Возвращаемое значение: Projection |undefined
Возвращает текущую Projection . Если карта еще не инициализирована, результат undefined . Прослушайте событие projection_changed и проверьте его значение, чтобы убедиться, что оно не является undefined .
getRenderingType
getRenderingType()
Параметры: Нет
Возвращаемое значение: RenderingType
Возвращает текущий RenderingType карты.
getStreetView
getStreetView()
Параметры: Нет
Возвращаемое значение: StreetViewPanorama Панорама, привязанная к карте.
Возвращает StreetViewPanorama по умолчанию, привязанную к карте, которая может быть панорамой по умолчанию, встроенной в карту, или панорамой, установленной с помощью setStreetView() . Изменения в streetViewControl карты будут отражены в отображении такой связанной панорамы.
getTilt
getTilt()
Параметры: Нет
Возвращаемое значение: number|undefined
Возвращает текущий угол наклона карты в градусах от плоскости окна просмотра к плоскости карты. Для растровых карт результатом будет 0 для изображений, сделанных прямо над головой, или 45 для изображений под углом 45°. Этот метод не возвращает значение, установленное setTilt . Подробнее см. setTilt .
getZoom
getZoom()
Параметры: Нет
Возвращаемое значение: number|undefined
Возвращает масштаб карты. Если масштаб не был установлен, то результат undefined .
moveCamera
moveCamera(cameraOptions)
Параметры:
Возвращаемое значение: нет
Немедленно устанавливает камеру карты в параметры целевой камеры, без анимации.
panBy
panBy(x, y)
Параметры:
  • x : number Количество пикселей для перемещения карты в направлении x.
  • y : number Количество пикселей для перемещения карты в направлении y.
Возвращаемое значение: нет
Изменяет центр карты на заданное расстояние в пикселях. Если расстояние меньше ширины и высоты карты, переход будет плавно анимирован. Обратите внимание, что система координат карты увеличивается с запада на восток (для значений x) и с севера на юг (для значений y).
panTo
panTo(latLng)
Параметры:
  • latLng : LatLng | LatLngLiteral Широта/долгота нового центра карты.
Возвращаемое значение: нет
Изменяет центр карты на заданный LatLng . Если изменение меньше ширины и высоты карты, переход будет плавно анимирован.
panToBounds
panToBounds(latLngBounds[, padding])
Параметры:
  • latLngBounds : LatLngBounds | LatLngBoundsLiteral Границы для панорамирования карты.
  • padding : number| Padding optional Отступ в пикселях. Числовое значение даст одинаковое заполнение на всех 4 сторонах. Значение по умолчанию — 0.
Возвращаемое значение: нет
Панорамирует карту на минимальную величину, необходимую для содержания данного LatLngBounds . Это не гарантирует, где на карте будут границы, за исключением того, что карта будет панорамирована, чтобы показать как можно больше границ внутри {currentMapSizeInPx} - {padding} . Как для растровых, так и для векторных карт масштабирование, наклон и направление карты не изменяются.
setCenter
setCenter(latlng)
Параметры:
Возвращаемое значение: нет
setClickableIcons
setClickableIcons(value)
Параметры:
  • value : boolean
Возвращаемое значение: нет
Определяет, кликабельны ли значки карты. Значок карты обозначает достопримечательность, также известную как POI. Чтобы отключить кликабельность значков карты, передайте этому методу значение false .
setHeading
setHeading(heading)
Параметры:
  • heading : number
Возвращаемое значение: нет
Устанавливает направление компаса для карты, измеренное в градусах от кардинального направления на север. Для растровых карт этот метод применим только к аэрофотоснимкам.
setMapTypeId
setMapTypeId(mapTypeId)
Параметры:
Возвращаемое значение: нет
setOptions
setOptions(options)
Параметры:
Возвращаемое значение: нет
setStreetView
setStreetView(panorama)
Параметры:
  • panorama : StreetViewPanorama optional Панорама для привязки к карте.
Возвращаемое значение: нет
Привязывает StreetViewPanorama к карте. Эта панорама переопределяет StreetViewPanorama по умолчанию, позволяя карте привязываться к внешней панораме за пределами карты. Установка для панорамы значения null привязывает встроенную панораму по умолчанию обратно к карте.
setTilt
setTilt(tilt)
Параметры:
  • tilt : number
Возвращаемое значение: нет
Для векторных карт задает угол падения карты. Допустимые значения ограничены в зависимости от уровня масштабирования карты. Для растровых карт управляет поведением автоматического переключения для угла падения карты. Единственными допустимыми значениями являются 0 и 45 . setTilt(0) заставляет карту всегда использовать вид сверху под углом 0° независимо от уровня масштабирования и окна просмотра. setTilt(45) заставляет угол наклона автоматически переключаться на 45 всякий раз, когда изображение под углом 45° доступно для текущего уровня масштабирования и окна просмотра, и переключаться обратно на 0 всякий раз, когда изображение под углом 45° недоступно (это поведение по умолчанию). Изображения под углом 45° доступны только для satellite и hybrid типов карт, в некоторых местах и ​​при некоторых уровнях масштабирования. Примечание: getTilt возвращает текущий угол наклона, а не значение, установленное setTilt . Поскольку getTilt и setTilt относятся к разным вещам, не bind() свойство tilt ; это может привести к непредсказуемым последствиям.
setZoom
setZoom(zoom)
Параметры:
  • zoom : number Большие значения масштабирования соответствуют более высокому разрешению.
Возвращаемое значение: нет
Устанавливает масштаб карты.
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll
DEMO_MAP_ID Идентификатор карты, который можно использовать для примеров кода, для которых требуется идентификатор карты. Этот идентификатор карты не предназначен для использования в рабочих приложениях и не может использоваться для функций, требующих облачной настройки (например, Cloud Styling).
bounds_changed
function()
Аргументы: Нет
Это событие запускается, когда границы области просмотра изменились.
center_changed
function()
Аргументы: Нет
Это событие запускается при изменении свойства центра карты.
click
function(event)
Аргументы:
Это событие запускается, когда пользователь щелкает карту. MapMouseEvent со свойствами для выбранного местоположения возвращается, если только не был нажат значок места, и в этом случае возвращается IconMouseEvent с идентификатором места. IconMouseEvent и MapMouseEvent идентичны, за исключением того, что IconMouseEvent имеет поле идентификатора места. Событие всегда можно рассматривать как MapMouseEvent, если идентификатор места не важен. Событие щелчка не запускается, если был нажат маркер или информационное окно.
contextmenu
function(event)
Аргументы:
Это событие запускается, когда событие контекстного меню DOM запускается в контейнере карты.
dblclick
function(event)
Аргументы:
Это событие запускается, когда пользователь дважды щелкает карту. Обратите внимание, что событие щелчка также сработает прямо перед этим.
drag
function()
Аргументы: Нет
Это событие повторяется, пока пользователь перетаскивает карту.
dragend
function()
Аргументы: Нет
Это событие запускается, когда пользователь перестает перетаскивать карту.
dragstart
function()
Аргументы: Нет
Это событие запускается, когда пользователь начинает перетаскивать карту.
heading_changed
function()
Аргументы: Нет
Это событие запускается при изменении свойства заголовка карты.
idle
function()
Аргументы: Нет
Это событие запускается, когда карта становится бездействующей после панорамирования или масштабирования.
isfractionalzoomenabled_changed
function()
Аргументы: Нет
Это событие запускается при изменении свойства isFractionalZoomEnabled.
mapcapabilities_changed
function()
Аргументы: Нет
Это событие запускается при изменении возможностей карты.
maptypeid_changed
function()
Аргументы: Нет
Это событие запускается при изменении свойства mapTypeId.
mousemove
function(event)
Аргументы:
Это событие запускается всякий раз, когда мышь пользователя перемещается по контейнеру карты.
mouseout
function(event)
Аргументы:
Это событие запускается, когда мышь пользователя выходит из контейнера карты.
mouseover
function(event)
Аргументы:
Это событие запускается, когда мышь пользователя входит в контейнер карты.
projection_changed
function()
Аргументы: Нет
Это событие запускается при изменении проекции.
renderingtype_changed
function()
Аргументы: Нет
Это событие запускается при изменении renderingType.
tilesloaded
function()
Аргументы: Нет
Это событие запускается после завершения загрузки видимых плиток.
tilt_changed
function()
Аргументы: Нет
Это событие запускается при изменении свойства наклона карты.
zoom_changed
function()
Аргументы: Нет
Это событие запускается при изменении свойства масштабирования карты.
rightclick
function(event)
Аргументы:
Это событие запускается, когда пользователь щелкает правой кнопкой мыши карту.

Интерфейс MapOptions

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

Объект MapOptions, используемый для определения свойств, которые можно установить на карте.

backgroundColor optional
Тип: string optional
Цвет, используемый для фона раздела карты. Этот цвет будет виден, когда плитки еще не загружены при панорамировании пользователем. Этот параметр можно установить только при инициализации карты.
center optional
Тип: LatLng | LatLngLiteral optional
Начальный центр карты.
clickableIcons optional
Тип: boolean optional
По умолчанию: true
При false значки карты не кликабельны. Значок карты обозначает достопримечательность, также известную как POI.
controlSize optional
Тип: number optional
Размер в пикселях элементов управления, появляющихся на карте. Это значение должно быть указано непосредственно при создании карты, обновление этого значения позже может привести к тому, что элементы управления перейдут в undefined состояние. Управляет только элементами управления, созданными самим API Карт. Не масштабирует пользовательские элементы управления, созданные разработчиком.
disableDefaultUI optional
Тип: boolean optional
Включает/отключает все кнопки пользовательского интерфейса по умолчанию. Может быть переопределен индивидуально. Не отключает элементы управления клавиатурой, которые отдельно управляются параметром MapOptions.keyboardShortcuts . Не отключает элементы управления жестами, которые отдельно управляются параметром MapOptions.gestureHandling .
disableDoubleClickZoom optional
Тип: boolean optional
Включает/отключает масштабирование и центрирование по двойному щелчку. Включено по умолчанию.

Примечание . Это свойство не рекомендуется . Чтобы отключить масштабирование при двойном щелчке, вы можете использовать gestureHandling и установить для него значение "none" .

draggable optional draggable optional
Тип: boolean optional
Если false , запрещает перетаскивание карты. Перетаскивание включено по умолчанию.
draggableCursor optional
Тип: string optional
Имя или URL-адрес курсора, который будет отображаться при наведении курсора на карту, которую можно перетаскивать. Это свойство использует атрибут cursor css для изменения значка. Как и в случае со свойством css, вы должны указать хотя бы один резервный курсор, который не является URL-адресом. Например: draggableCursor: 'url( http://www.example.com/icon.png ), auto;' .
draggingCursor optional
Тип: string optional
Имя или URL-адрес курсора для отображения при перетаскивании карты. Это свойство использует атрибут cursor css для изменения значка. Как и в случае со свойством css, вы должны указать хотя бы один резервный курсор, который не является URL-адресом. Например: draggingCursor: 'url( http://www.example.com/icon.png ), auto;' .
fullscreenControl optional
Тип: boolean optional
Включенное/отключенное состояние полноэкранного управления.
fullscreenControlOptions optional
Тип: FullscreenControlOptions optional
Параметры отображения для полноэкранного элемента управления.
gestureHandling optional
Тип: string optional
Этот параметр определяет, как API обрабатывает жесты на карте. Допустимые значения:
  • "cooperative" : события прокрутки и жесты касания одним пальцем прокручивают страницу, но не масштабируют и не панорамируют карту. Жесты касания двумя пальцами перемещают и масштабируют карту. Прокрутите события с помощью клавиши ctrl или нажатой клавиши ⌘, чтобы увеличить карту.
    В этом режиме карта взаимодействует со страницей.
  • "greedy" : все сенсорные жесты и события прокрутки перемещают или масштабируют карту.
  • "none" : карта не может перемещаться или масштабироваться с помощью жестов пользователя.
  • "auto" : (по умолчанию) Обработка жестов является совместной или жадной, в зависимости от того, является ли страница прокручиваемой или находится в iframe.
heading optional
Тип: number optional
Направление аэрофотосъемки в градусах по часовой стрелке от основного направления на север. Заголовки привязаны к ближайшему доступному углу, для которого доступно изображение.
isFractionalZoomEnabled optional
Тип: boolean optional
По умолчанию: true для векторных карт и false для растровых карт.
Должна ли карта разрешать дробные уровни масштабирования. Прослушайте isfractionalzoomenabled_changed , чтобы узнать, когда было установлено значение по умолчанию.
keyboardShortcuts optional
Тип: boolean optional
Если false , запрещает управление картой с клавиатуры. Сочетания клавиш включены по умолчанию.
mapId optional
Тип: string optional
Идентификатор карты карты. Этот параметр нельзя установить или изменить после создания экземпляра карты.
mapTypeControl optional
Тип: boolean optional
Начальное включенное/отключенное состояние элемента управления «Тип карты».
mapTypeControlOptions optional
Тип: MapTypeControlOptions optional
Начальные параметры отображения для элемента управления Тип карты.
mapTypeId optional
Тип: MapTypeId |string optional
Исходный Map MapTypeId. По умолчанию ROADMAP .
maxZoom optional
Тип: number optional
Максимальный уровень масштабирования, который будет отображаться на карте. Если он опущен или установлен в null , вместо этого используется максимальное масштабирование текущего типа карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования .
minZoom optional
Тип: number optional
Минимальный уровень масштабирования, который будет отображаться на карте. Если он опущен или установлен в null , вместо этого используется минимальный масштаб текущего типа карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования .
noClear optional
Тип: boolean optional
Если true , не очищайте содержимое div карты.
panControl optional
Тип: boolean optional
Включенное/отключенное состояние элемента управления панорамированием.

Примечание. Элемент управления Pan недоступен в новом наборе элементов управления, представленном в версии 3.22 API Google Maps JavaScript. При использовании версий 3.22 и 3.23 вы можете использовать более ранний набор элементов управления, а не новые элементы управления, что делает элемент управления панорамированием доступным как часть старого набора элементов управления. См. Что нового в элементах управления картой версии 3.22 .

panControlOptions optional
Тип: PanControlOptions optional
Параметры отображения для элемента управления панорамированием.

Примечание. Элемент управления Pan недоступен в новом наборе элементов управления, представленном в версии 3.22 API Google Maps JavaScript. При использовании версий 3.22 и 3.23 вы можете использовать более ранний набор элементов управления, а не новые элементы управления, что делает элемент управления панорамированием доступным как часть старого набора элементов управления. См. Что нового в элементах управления картой версии 3.22 .

restriction optional
Тип: MapRestriction optional
Определяет границу, которая ограничивает область карты, доступную для пользователей. Если установлено, пользователь может только панорамировать и масштабировать, пока вид камеры остается в пределах границ.
rotateControl optional
Тип: boolean optional
Включенное/отключенное состояние элемента управления Rotate.
rotateControlOptions optional
Тип: RotateControlOptions optional
Параметры отображения для элемента управления поворотом.
scaleControl optional
Тип: boolean optional
Начальное включенное/выключенное состояние элемента управления Scale.
scaleControlOptions optional
Тип: ScaleControlOptions optional
Начальные параметры отображения для элемента управления Масштаб.
scrollwheel optional
Тип: boolean optional
При значении false отключает масштабирование карты с помощью колеса прокрутки мыши. Колесо прокрутки включено по умолчанию.

Примечание . Это свойство не рекомендуется . Чтобы отключить масштабирование с помощью колеса прокрутки, вы можете использовать gestureHandling и установить для него значение "cooperative" или "none" .

streetView optional
Тип: StreetViewPanorama optional
StreetViewPanorama , которая отображается, когда человечек Просмотра улиц перетаскивается на карту. Если панорама не указана, StreetViewPanorama по умолчанию будет отображаться в div карты при опускании человечка.
streetViewControl optional
Тип: boolean optional
Начальное включенное/отключенное состояние элемента управления Pegman в Просмотре улиц. Этот элемент управления является частью пользовательского интерфейса по умолчанию, и для него следует установить значение false при отображении типа карты, на котором не должно отображаться наложение дорог в Просмотре улиц (например, тип карты, отличный от Земли).
streetViewControlOptions optional
Тип: StreetViewControlOptions optional
Начальные параметры отображения для элемента управления Pegman в Просмотре улиц.
styles optional
Тип: Array < MapTypeStyle > optional
Стили, применяемые к каждому из типов карт по умолчанию. Обратите внимание, что для satellite / hybrid и terrain режимов эти стили будут применяться только к надписям и геометрии.
tilt optional
Тип: number optional
Для векторных карт задает угол падения карты. Допустимые значения ограничены в зависимости от уровня масштабирования карты. Для растровых карт управляет поведением автоматического переключения для угла падения карты. Единственными допустимыми значениями являются 0 и 45 . Значение 0 заставляет карту всегда использовать вид сверху под углом 0° независимо от уровня масштабирования и окна просмотра. Значение 45 приводит к тому, что угол наклона автоматически переключается на 45 всякий раз, когда для текущего уровня масштабирования и окна просмотра доступно изображение под углом 45°, и переключается обратно на 0, когда изображение под углом 45° недоступно (это поведение по умолчанию). Изображения под углом 45° доступны только для satellite и hybrid типов карт, в некоторых местах и ​​при некоторых уровнях масштабирования. Примечание: getTilt возвращает текущий угол наклона, а не значение, заданное этой опцией. Поскольку getTilt и этот параметр относятся к разным вещам, не bind() свойство tilt ; это может привести к непредсказуемым последствиям.
zoom optional
Тип: number optional
Начальный уровень масштабирования карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования . Большие значения масштабирования соответствуют более высокому разрешению.
zoomControl optional
Тип: boolean optional
Включенное/отключенное состояние элемента управления масштабированием.
zoomControlOptions optional
Тип: ZoomControlOptions optional
Параметры отображения для элемента управления масштабированием.

Класс MapElement

google.maps . MapElement Класс google.maps . MapElement

MapElement — это подкласс HTMLElement для рендеринга карт. После загрузки библиотеки maps можно создать карту в формате HTML. Например:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID"></gmp-map>

Внутри он использует Map , доступ к которому можно получить с помощью свойства innerMap .

Пользовательский элемент:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

Этот класс расширяет HTMLElement .

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

Получите доступ, вызвав const {MapElement} = await google.maps.importLibrary("maps") . См. Библиотеки в Maps JavaScript API .

center
Тип: LatLng | LatLngLiteral optional
HTML-атрибут:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Тип: Map
Ссылка на Map , которую MapElement использует внутри.
mapId
Тип: string optional
HTML-атрибут:
  • <gmp-map map-id="string"></gmp-map>
zoom
Тип: number optional
HTML-атрибут:
  • <gmp-map zoom="number"></gmp-map>
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string с учетом регистра, представляющая тип ожидаемого события.
  • listener : EventListener | EventListenerObject Объект, который получает уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. параметры . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Настраивает функцию, которая будет вызываться всякий раз, когда указанное событие доставляется цели. См. addEventListener
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. параметры
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из цели. См. RemoveEventListener

Интерфейс MapElementOptions

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

Объект MapElementOptions, используемый для определения свойств, которые можно задать для MapElement.

center optional
Тип: LatLng | LatLngLiteral optional
Начальный центр карты.
mapId optional
Тип: string optional
Идентификатор карты карты. Этот параметр нельзя установить или изменить после создания экземпляра карты.
zoom optional
Тип: number optional
Начальный уровень масштабирования карты. Допустимые значения масштабирования — это числа от нуля до поддерживаемого максимального уровня масштабирования . Большие значения масштабирования соответствуют более высокому разрешению.

Интерфейс MapTypeStyle

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

MapTypeStyle — это набор селекторов и стилей, которые определяют стиль карты. Селекторы определяют функции и/или элементы карты, на которые следует воздействовать, а стили указывают, как следует изменять эти функции и элементы. Подробнее см. в справочнике по стилю .

stylers
Тип: Array < Object >
Правила стиля, применяемые к выбранным объектам и элементам карты. Правила применяются в том порядке, который вы указываете в этом массиве. Рекомендации по использованию и допустимые значения см. в справочнике по стилю .
elementType optional
Тип: string optional
Элемент, к которому следует применить стиль. Элемент — это визуальный аспект объекта на карте. Пример: метка, значок, обводка или заливка, примененные к геометрии, и т. д. Необязательный. Если elementType не указан, предполагается, что значение равно 'all' . Подробнее об использовании и допустимых значениях см. в справочнике по стилю .
featureType optional
Тип: string optional
Элемент или группа элементов, к которым следует применить стиль. Необязательный. Если featureType не указан, предполагается, что значение равно 'all' . Подробнее об использовании и допустимых значениях см. в справочнике по стилю .

Интерфейс MapMouseEvent

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

Этот объект возвращается из различных событий мыши на карте и наложениях и содержит все поля, показанные ниже.

domEvent
Соответствующее собственное событие DOM. Разработчики не должны полагаться на то, что свойства target , currentTarget , relatedTarget и path определены и непротиворечивы. Разработчикам также не следует полагаться на структуру DOM внутренней реализации Maps API. Из-за внутреннего сопоставления событий domEvent может отличаться от семантики MapMouseEvent (например, «щелчок» MapMouseEvent может иметь domEvent типа KeyboardEvent ).
latLng optional
Тип: LatLng optional
Широта/долгота, которые были ниже курсора, когда произошло событие.
stop
stop()
Параметры: Нет
Возвращаемое значение: void
Предотвращает дальнейшее распространение этого события.

Интерфейс IconMouseEvent

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

Этот объект отправляется в событии, когда пользователь щелкает значок на карте. Идентификатор места этого места хранится в элементе placeId. Чтобы информационное окно по умолчанию не отображалось, вызовите метод stop() для этого события, чтобы предотвратить его распространение. Узнайте больше об идентификаторах мест в руководстве для разработчиков Places API.

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

placeId optional
Тип: string optional
Идентификатор места, на которое нажали. Этот идентификатор места можно использовать для запроса дополнительной информации о выбранном объекте.

Узнайте больше об идентификаторах мест в руководстве для разработчиков Places API.

Унаследовано: domEvent , latLng
Унаследовано: stop

Константы MapTypeId

google.maps . MapTypeId Константы google.maps . MapTypeId

Идентификаторы для общих типов карт. Укажите их по значению или по имени константы. Например, 'satellite' или google.maps.MapTypeId.SATELLITE .

Получите доступ, вызвав const {MapTypeId} = await google.maps.importLibrary("maps") . См. Библиотеки в Maps JavaScript API .

HYBRID Этот тип карты отображает прозрачный слой основных улиц на спутниковых снимках.
ROADMAP Этот тип карты отображает обычную карту улиц.
SATELLITE Этот тип карты отображает спутниковые изображения.
TERRAIN Этот тип карты отображает карты с физическими характеристиками, такими как рельеф и растительность.

Класс MapTypeRegistry

google.maps . MapTypeRegistry Класс google.maps . MapTypeRegistry

Реестр для экземпляров MapType с ключом по идентификатору MapType.

Этот класс расширяет MVCObject .

Получите доступ, вызвав const {MapTypeRegistry} = await google.maps.importLibrary("maps") . См. Библиотеки в Maps JavaScript API .

MapTypeRegistry
MapTypeRegistry()
Параметры: Нет
MapTypeRegistry содержит коллекцию пользовательских типов карт, доступных для использования картой. API обращается к этому реестру, например, при предоставлении списка доступных типов карт в элементах управления.
set
set(id, mapType)
Параметры:
  • id : string Идентификатор MapType для добавления в реестр.
  • mapType : MapType |* Объект MapType для добавления в реестр.
Возвращаемое значение: нет
Задает для реестра связь переданного строкового идентификатора с переданным MapType.
Унаследовано: addListener , bindTo , get , notify , setValues , unbind , unbindAll

Интерфейс MapRestriction

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

Ограничение, которое может быть применено к Карте. Окно просмотра карты не будет выходить за эти ограничения.

latLngBounds
Когда установлено, пользователь может панорамировать и масштабировать только в пределах заданных границ. Границы могут ограничивать как долготу, так и широту, или могут ограничивать только широту. Для границ только по широте используйте западную и восточную долготы -180 и 180 соответственно, например, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} .
strictBounds optional
Тип: boolean optional
Границы можно сделать более строгими, установив для флага strictBounds значение true . Это уменьшает масштаб, на который пользователь может уменьшить масштаб, гарантируя, что все, что находится за пределами ограниченных границ, останется скрытым. Значение по умолчанию — false , что означает, что пользователь может уменьшать масштаб до тех пор, пока не будет видна вся ограниченная область, возможно, включая области за пределами ограниченной области.

Класс TrafficLayer

google.maps . TrafficLayer Класс google.maps . TrafficLayer

Слой трафика.

Этот класс расширяет MVCObject .

Получите доступ, вызвав const {TrafficLayer} = await google.maps.importLibrary("maps") . См. Библиотеки в Maps JavaScript API .

TrafficLayer
TrafficLayer([opts])
Параметры:
Слой, отображающий текущий дорожный трафик.
getMap
getMap()
Параметры: Нет
Возвращаемое значение: Map
Возвращает карту, на которой отображается этот слой.
setMap
setMap(map)
Параметры:
Возвращаемое значение: нет
Визуализирует слой на указанной карте. Если для карты задано значение null , слой будет удален.
setOptions
setOptions(options)
Параметры:
Возвращаемое значение: нет
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll

Интерфейс TrafficLayerOptions

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

Объект TrafficLayerOptions, используемый для определения свойств, которые можно задать для TrafficLayer.

autoRefresh optional
Тип: boolean optional
По умолчанию: true
Обновляется ли уровень трафика с обновленной информацией автоматически.
map optional
Тип: Map optional
Карта, на которой отображать слой трафика.

Класс TransitLayer

google.maps . TransitLayer Класс google.maps . TransitLayer

Транзитный слой.

Этот класс расширяет MVCObject .

Получите доступ, вызвав const {TransitLayer} = await google.maps.importLibrary("maps") . См. Библиотеки в Maps JavaScript API .

TransitLayer
TransitLayer()
Параметры: Нет
Слой, отображающий линии общественного транспорта.
getMap
getMap()
Параметры: Нет
Возвращаемое значение: Map
Возвращает карту, на которой отображается этот слой.
setMap
setMap(map)
Параметры:
Возвращаемое значение: нет
Визуализирует слой на указанной карте. Если для карты задано значение null , слой будет удален.
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll

Класс BicyclingLayer

google.maps . BicyclingLayer Класс google.maps . BicyclingLayer

Слой, показывающий велосипедные дорожки и дорожки.

Этот класс расширяет MVCObject .

Получите доступ, вызвав const {BicyclingLayer} = await google.maps.importLibrary("maps") . См. Библиотеки в Maps JavaScript API .

BicyclingLayer
BicyclingLayer()
Параметры: Нет
Слой, который отображает велосипедные дорожки и дорожки и понижает большие дороги.
getMap
getMap()
Параметры: Нет
Возвращаемое значение: Map
Возвращает карту, на которой отображается этот слой.
setMap
setMap(map)
Параметры:
Возвращаемое значение: нет
Визуализирует слой на указанной карте. Если для карты задано значение null , слой будет удален.
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll

Интерфейс опций камеры

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

Используется для настройки параметров камеры карты.

center optional
Тип: LatLngLiteral | LatLng optional
heading optional
Тип: number optional
tilt optional
Тип: number optional
zoom optional
Тип: number optional

Интерфейс видимой области

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

Содержит четыре точки, определяющие четырехсторонний многоугольник, который является видимой областью карты. На векторной карте этот многоугольник может быть трапецией, а не прямоугольником, когда векторная карта имеет наклон.

farLeft
Тип: LatLng
farRight
Тип: LatLng
latLngBounds
Тип: LatLngBounds
Наименьшая ограничивающая рамка, включающая видимую область.
nearLeft
Тип: LatLng
nearRight
Тип: LatLng

Константы RenderingType

google.maps . RenderingType Константы google.maps . RenderingType

Получите доступ, вызвав const {RenderingType} = await google.maps.importLibrary("maps") . См. Библиотеки в Maps JavaScript API .

RASTER Указывает, что карта является растровой.
UNINITIALIZED Указывает, что пока неизвестно, является ли карта векторной или растровой, поскольку инициализация карты еще не завершена.
VECTOR Указывает, что карта является векторной картой.

Интерфейс MapCapabilities

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

Объект, содержащий снимок того, какие возможности в настоящее время доступны для Карты. See the properties for a list of possible capabilities.

isAdvancedMarkersAvailable optional
Type: boolean optional
isDataDrivenStylingAvailable optional
Type: boolean optional