Maps

Класс MapElement

google.maps.MapElement класс

MapElement – это подкласс HTMLElement для отрисовки карт. После загрузки библиотеки maps можно создать карту в HTML. Пример:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

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

Специальный элемент:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

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

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

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

MapElement
MapElement([options])
Параметры: 
center
Тип:  LatLng|LatLngLiteral optional
Широта и долгота центра карты.
HTML-атрибут:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
Тип:  boolean optional
По умолчанию: false.
Определяет, может ли пользователь управлять направлением камеры (поворотом). Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
HTML-атрибут:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
Тип:  Map
Ссылка на Map, который MapElement использует внутри.
internalUsageAttributionIds
Тип:  Iterable<string> optional
По умолчанию: null.
Добавляет идентификатор атрибуции использования в инициализатор, что помогает Google понять, какие библиотеки и примеры полезны для разработчиков, например использование библиотеки кластеризации маркеров. Чтобы отказаться от отправки идентификатора атрибуции использования, можно удалить это свойство или заменить его значение пустой строкой. Будут отправлены только уникальные значения. Изменения этого значения после создания экземпляра могут игнорироваться.
HTML-атрибут:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
Тип:  string optional
Идентификатор карты. Этот параметр нельзя задать или изменить после создания экземпляра карты. Map.DEMO_MAP_ID можно использовать, чтобы попробовать функции, для которых требуется идентификатор карты, но не требуется включение облачных сервисов.
HTML-атрибут:
  • <gmp-map map-id="string"></gmp-map>
renderingType
Тип:  RenderingType optional
По умолчанию: RenderingType.VECTOR.
Тип карты: растровая или векторная. Этот параметр нельзя задать или изменить после создания экземпляра карты. Если он не задан, тип отрисовки будет определяться облачной конфигурацией для идентификатора карты (если доступно). Обратите внимание, что векторные карты могут быть доступны не на всех устройствах и не во всех браузерах. В таких случаях будет использоваться растровая карта.
HTML-атрибут:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
Тип:  boolean optional
По умолчанию: false.
Определяет, может ли пользователь управлять наклоном камеры. Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
HTML-атрибут:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
Тип:  number optional
Уровень масштабирования карты. Допустимые значения масштабирования – это числа от нуля до поддерживаемого максимального уровня масштабирования. Чем больше значение масштаба, тем выше разрешение.
HTML-атрибут:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Размещает элемент в позиции ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Размещает элемент в позиции ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Размещает элемент в позиции ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Размещает элемент в позиции ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Размещает элемент в позиции ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Размещает элемент в позиции ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Размещает элемент в позиции ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Размещает элемент в позиции ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Размещает элемент в позиции ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Размещает элемент в позиции ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Размещает элемент в позиции ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Размещает элемент в позиции ControlPosition.INLINE_START_BLOCK_START.
default
Вы можете создавать многократно используемые компоненты на основе веб-компонентов Maps JavaScript, например AdvancedMarkerElement, используя пользовательские элементы. По умолчанию любые пользовательские элементы, добавленные непосредственно в MapElement, будут размещены и отображены в MapPanes.overlayMouseTarget. Однако веб-компоненты Maps JavaScript API могут быть переназначены внутренним слотам MapElement.
addEventListener
addEventListener(type, listener[, options])
Параметры: 
  • type:  string Строка с учетом регистра, представляющая тип события, которое нужно отслеживать.
  • listener:  EventListener|EventListenerObject Объект, который получает уведомление. Это должна быть функция или объект с методом handleEvent.
  • options:  boolean|AddEventListenerOptions optional Посмотрите варианты. Специальные события поддерживают только capture и passive.
Возвращаемое значение:  void
Настраивает функцию, которая будет вызываться каждый раз, когда указанное событие доставляется целевому объекту. Подробнее addEventListener…
removeEventListener
removeEventListener(type, listener[, options])
Параметры: 
  • type:  string Строка, указывающая тип события, для которого нужно удалить прослушиватель событий.
  • listener:  EventListener|EventListenerObject Прослушиватель событий обработчика событий, который нужно удалить из целевого объекта события.
  • options:  boolean|EventListenerOptions optional Посмотрите варианты.
Возвращаемое значение:  void
Удаляет из целевого объекта прослушиватель событий, ранее зарегистрированный с помощью addEventListener. Подробнее removeEventListener…
gmp-zoomchange
function(event)
Аргументы: 
Это событие вызывается при изменении свойства масштабирования карты.

Интерфейс MapElementOptions

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

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

center optional
Тип:  LatLng|LatLngLiteral optional
Посмотрите MapElement.center.
headingInteractionDisabled optional
Тип:  boolean optional
internalUsageAttributionIds optional
Тип:  Iterable<string> optional
mapId optional
Тип:  string optional
Посмотрите MapElement.mapId.
renderingType optional
Тип:  RenderingType optional
Посмотрите MapElement.renderingType.
tiltInteractionDisabled optional
Тип:  boolean optional
zoom optional
Тип:  number optional
Посмотрите MapElement.zoom.

Класс ZoomChangeEvent

google.maps.ZoomChangeEvent класс

Это событие создается при отслеживании изменения масштаба.

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

Чтобы получить доступ, позвоните по номеру const {ZoomChangeEvent} = await google.maps.importLibrary("maps").
Подробнее о библиотеках Maps JavaScript API…

Класс 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).
DEMO_MAP_ID Идентификатор карты, который можно использовать в примерах кода, где он требуется. Этот идентификатор карты не предназначен для использования в рабочих приложениях и не может использоваться для функций, требующих облачной конфигурации (например, облачных стилей).
controls
Дополнительные элементы управления, присоединяемые к карте. Чтобы добавить элемент управления на карту, добавьте его узел <div> в массив MVCArray, соответствующий позиции ControlPosition, в которой он должен отображаться.
data
Тип:  Data
Экземпляр Data, привязанный к карте. Добавьте объекты в этот объект Data, чтобы удобно показывать их на карте.
mapTypes
Тип:  MapTypeRegistry
Реестр экземпляров MapType по строковому идентификатору.
overlayMapTypes
Тип:  MVCArray<MapType optional>
Дополнительные типы карт для наложения. Наложения отображаются поверх базовых карт, к которым они прикреплены, в том же порядке, в каком они перечислены в массиве overlayMapTypes (чем выше у наложения значение индекса, тем выше находится его слой).
fitBounds
fitBounds(bounds[, padding])
Параметры: 
  • bounds – LatLngBounds|LatLngBoundsLiteralграницы, которые нужно показать.
  • padding:  number|Padding optional Поле в пикселях. Границы будут вписаны в ту часть карты, которая останется после удаления отступов. Числовое значение задает одинаковые поля со всех четырех сторон. Укажите здесь 0, чтобы сделать fitBounds идемпотентным для результата getBounds.
Возвращаемое значение: нет.
Задает окно просмотра с указанными границами.
Примечание. Если для карты задано значение display: none, функция fitBounds считывает размер карты как 0 x 0 и поэтому ничего не делает. Чтобы изменить область просмотра, когда карта скрыта, задайте для карты значение visibility: hidden. Это позволит убедиться, что у элемента div карты есть фактический размер. Для векторных карт этот метод устанавливает наклон и ориентацию карты на нулевые значения по умолчанию. Вызов этого метода может привести к плавной анимации, когда карта панорамируется и масштабируется в соответствии с границами. Будет ли этот метод анимирован, зависит от внутренней эвристики.
getBounds
getBounds()
Параметры: нет.
Возвращаемое значение:  LatLngBounds|undefined границы широты и долготы текущей области просмотра.
Возвращает широту/долготу границ текущего окна просмотра. Если видно несколько копий мира, границы долготы находятся в диапазоне от -180 до 180 градусов включительно. Если карта ещё не инициализирована или не заданы центр и масштаб, возвращается значение undefined. Для векторных карт с ненулевым наклоном или направлением возвращаемые границы широты и долготы представляют собой наименьшую ограничивающую рамку, которая включает видимую область просмотра карты. Чтобы узнать, как получить точную видимую область просмотра карты, ознакомьтесь с разделом MapCanvasProjection.getVisibleRegion.
getCenter
getCenter()
Параметры: нет.
Возвращаемое значение:  LatLng|undefined
Возвращает позицию, отображаемую в центре карты. Обратите внимание, что этот объект LatLng не упакован. Подробнее: LatLng. Если центр или границы не заданы, возвращается значение undefined.
getClickableIcons
getClickableIcons()
Параметры: нет.
Возвращаемое значение:  boolean|undefined
Возвращает кликабельность значков на карте. Значок на карте обозначает объект инфраструктуры. Если возвращается значение true, то на значки на карте можно нажимать.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Параметры: 
  • datasetId:  string
Возвращаемое значение:  FeatureLayer
Возвращает FeatureLayer для указанного datasetId. Идентификаторы наборов данных необходимо настроить в консоли Google Cloud. Если идентификатор набора данных не связан со стилем карты или стили на основе данных недоступны (не настроены идентификатор карты, векторные фрагменты, слои объектов или наборы данных), будет зарегистрирована ошибка и возвращено значение FeatureLayer.isAvailable.
getDiv
getDiv()
Параметры: нет.
Возвращаемое значение:  HTMLElement mapDiv карты.
getFeatureLayer
getFeatureLayer(featureType)
Параметры: 
Возвращаемое значение:  FeatureLayer
Возвращает FeatureLayer определенного FeatureType. В консоли Google Cloud должен быть включен FeatureLayer. Если на карте нет слоя FeatureLayer указанного типа FeatureType или если стили на основе данных недоступны (нет идентификатора карты, векторных фрагментов и слоя FeatureLayer в стиле карты), регистрируется ошибка и возвращается значение FeatureLayer.isAvailable false.
getHeading
getHeading()
Параметры: нет.
Возвращаемое значение:  number|undefined
Возвращает направление карты по компасу. Значение направления измеряется в градусах (по часовой стрелке) от севера. Если карта ещё не инициализирована, результатом будет undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Параметры: нет.
Возвращаемое значение:  boolean|null
Возвращает значение, указывающее, включены ли взаимодействия с заголовками. Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Параметры: нет.
Возвращаемое значение:  Iterable<string>|null
Возвращает список идентификаторов атрибуции использования, которые помогают Google понять, какие библиотеки и примеры полезны для разработчиков, например использование библиотеки кластеризации маркеров.
getMapCapabilities
getMapCapabilities()
Параметры: нет.
Возвращаемое значение:  MapCapabilities
Сообщает вызывающему объекту о текущих возможностях, доступных для карты на основе предоставленного идентификатора карты.
getMapTypeId
getMapTypeId()
Параметры: нет.
Возвращаемое значение:  MapTypeId|string|undefined
getProjection
getProjection()
Параметры: нет.
Возвращаемое значение:  Projection|undefined
Возвращает текущее значение Projection. Если карта ещё не инициализирована, результатом будет undefined. Прослушайте событие projection_changed и проверьте его значение, чтобы убедиться, что оно не равно undefined.
getRenderingType
getRenderingType()
Параметры: нет.
Возвращаемое значение:  RenderingType
Возвращает текущий тип отрисовки карты.
getStreetView
getStreetView()
Параметры: нет.
Возвращаемое значение:  StreetViewPanorama – панорама, связанная с картой.
Возвращает объект StreetViewPanorama по умолчанию, связанный с картой. Это может быть панорама по умолчанию, встроенная в карту, или панорама, заданная с помощью метода setStreetView(). Изменения streetViewControl карты будут отражаться на отображении такой связанной панорамы.
getTilt
getTilt()
Параметры: нет.
Возвращаемое значение:  number|undefined
Возвращает текущий угол падения карты в градусах от плоскости области просмотра до плоскости карты. Для растровых карт результатом будет 0 для снимков, сделанных непосредственно сверху, или 45 для снимков под углом 45°. Этот метод не возвращает значение, заданное методом setTilt. Подробную информацию можно найти в статье setTilt.
getTiltInteractionEnabled
getTiltInteractionEnabled()
Параметры: нет.
Возвращаемое значение:  boolean|null
Возвращает значение, указывающее, включены ли взаимодействия с наклоном. Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
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 Поле в пикселях. Числовое значение задает одинаковые поля со всех четырех сторон. Значение по умолчанию – 0.
Возвращаемое значение: нет.
Панорамирует карту на минимальное расстояние, необходимое для отображения заданного объекта LatLngBounds. При этом не гарантируется, где именно на карте будут находиться границы, но карта будет панорамирована так, чтобы показать как можно больше границ внутри {currentMapSizeInPx} - {padding}. Для растровых и векторных карт масштаб, наклон и направление не изменятся.
setCenter
setCenter(latlng)
Параметры: 
Возвращаемое значение: нет.
setClickableIcons
setClickableIcons(value)
Параметры: 
  • value:  boolean
Возвращаемое значение: нет.
Определяет, можно ли нажимать на значки на карте. Значок на карте обозначает объект инфраструктуры. Чтобы отключить кликабельность значков на карте, передайте этому методу значение false.
setHeading
setHeading(heading)
Параметры: 
  • heading:  number
Возвращаемое значение: нет.
Задает направление по компасу для карты, измеряемое в градусах от направления на север. Для растровых карт этот метод применяется только к аэрофотоснимкам.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
Параметры: 
  • headingInteractionEnabled:  boolean
Возвращаемое значение: нет.
Определяет, включено ли взаимодействие с заголовками. Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
setMapTypeId
setMapTypeId(mapTypeId)
Параметры: 
Возвращаемое значение: нет.
setOptions
setOptions(options)
Параметры: 
Возвращаемое значение: нет.
setRenderingType
setRenderingType(renderingType)
Параметры: 
Возвращаемое значение: нет.
Задает текущий тип отрисовки карты.
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° доступны только для типов карт satellite и hybrid, в некоторых местоположениях и на некоторых уровнях масштабирования. Примечание. Метод getTilt возвращает текущий угол наклона, а не значение, заданное методом setTilt. Поскольку getTilt и setTilt относятся к разным вещам, не bind() свойство tilt, так как это может привести к непредсказуемым последствиям.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Параметры: 
  • tiltInteractionEnabled:  boolean
Возвращаемое значение: нет.
Указывает, включены ли взаимодействия с наклоном. Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
setZoom
setZoom(zoom)
Параметры: 
  • zoom:  number. Чем больше значение, тем выше разрешение.
Возвращаемое значение: нет.
Задает масштаб карты.
Унаследованные: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll.
bounds_changed
function()
Аргументы: нет
Это событие вызывается при изменении границ окна просмотра.
center_changed
function()
Аргументы: нет
Это событие вызывается при изменении свойства центра карты.
click
function(event)
Аргументы: 
Это событие активируется, когда пользователь нажимает на карту. Возвращается объект MapMouseEvent со свойствами нажатого местоположения, если только не был нажат значок места. В этом случае возвращается объект IconMouseEvent с идентификатором места. Классы IconMouseEvent и MapMouseEvent идентичны, за исключением того, что у IconMouseEvent есть поле идентификатора места. Если идентификатор места не важен, событие всегда можно обрабатывать как MapMouseEvent. Событие click не активируется, если пользователь нажал на маркер или информационное окно.
contextmenu
function(event)
Аргументы: 
Это событие активируется, когда в контейнере карты активируется событие contextmenu структуры DOM.
dblclick
function(event)
Аргументы: 
Это событие активируется, когда пользователь дважды нажимает на карту. Обратите внимание, что событие клика иногда срабатывает один раз, а иногда дважды, прямо перед этим.
drag
function()
Аргументы: нет
Это событие активируется многократно во время перетаскивания карты.
dragend
function()
Аргументы: нет
Это событие активируется, когда пользователь прекращает перетаскивать карту. Примечание. Событие dragend НЕ активируется, когда пользователь прекращает панорамирование карты с помощью клавиатуры. Чтобы определить, когда пользователь прекратил панорамирование или перетаскивание карты, используйте событие Map.idle.
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 интерфейс

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

backgroundColor optional
Тип:  string optional
Цвет фона для элемента div карты. Он будет виден, когда фрагменты ещё не загрузились при панорамировании. Этот параметр может быть задан только после инициализации карты.
cameraControl optional
Тип:  boolean optional
Состояние элемента управления камерой (включен или отключен).
cameraControlOptions optional
Тип:  CameraControlOptions optional
Параметры отображения для элемента управления камерой.
center optional
Тип:  LatLng|LatLngLiteral optional
Начальный центр карты.
clickableIcons optional
Тип:  boolean optional
По умолчанию: true.
Если false, значки на карте неактивны. Значок на карте обозначает объект инфраструктуры.
colorScheme optional
Тип:  ColorScheme|string optional
По умолчанию: ColorScheme.LIGHT.
Исходная цветовая схема карты. Этот параметр может быть задан только после инициализации карты.
controlSize optional
Тип:  number optional
Размер элементов управления на карте в пикселях. Это значение необходимо указать непосредственно при создании карты. Если вы измените его позже, элементы управления могут перейти в состояние undefined. Управляет только элементами, созданными самим Maps API. Не масштабирует созданные разработчиком элементы управления.
disableDefaultUI optional
Тип:  boolean optional
Включает или отключает все кнопки пользовательского интерфейса по умолчанию. Их можно переопределить по отдельности. Не отключает управление с клавиатуры, которое настраивается отдельно с помощью параметра MapOptions.keyboardShortcuts. Не отключает управление жестами, которое настраивается отдельно с помощью параметра MapOptions.gestureHandling.
disableDoubleClickZoom optional
Тип:  boolean optional
Включает/выключает масштабирование и размещение по центру при двойном нажатии. Включено по умолчанию.

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

draggable optional
Тип:  boolean optional
Если false, запрещает перетаскивание и масштабирование карты с помощью мыши и жестов. Перетаскивание включено по умолчанию.
draggableCursor optional
Тип:  string optional
Название или URL курсора, который будет показываться при наведении указателя мыши на перетаскиваемую карту. Это свойство использует атрибут CSS cursor, чтобы изменить значок. Как и в случае со свойством CSS, необходимо указать хотя бы один резервный курсор, который не является URL. Пример: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Тип:  string optional
Название или URL курсора, который будет показываться при перетаскивании карты. Это свойство использует атрибут CSS cursor, чтобы изменить значок. Как и в случае со свойством 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" (по умолчанию) – обработка жестов выполняется в режиме cooperative или greedy в зависимости от того, можно ли прокручивать страницу и находится ли она в окне iframe.
heading optional
Тип:  number optional
Направление для аэрофотоснимка в градусах по часовой стрелке относительно севера. Направление фиксируется под ближайшим углом, для которого доступен аэрофотоснимок.
headingInteractionEnabled optional
Тип:  boolean optional
По умолчанию: false.
Определяет, может ли пользователь управлять направлением камеры (поворотом). Этот параметр действует только для векторных карт. Если он не задан в коде, будет использоваться облачная конфигурация для идентификатора карты (если доступна).
internalUsageAttributionIds optional
Тип:  Iterable<string> optional
По умолчанию: null.
Добавляет идентификатор атрибуции использования в инициализатор, что помогает Google понять, какие библиотеки и примеры полезны для разработчиков, например использование библиотеки кластеризации маркеров. Чтобы отказаться от отправки идентификатора атрибуции использования, можно удалить это свойство или заменить его значение пустой строкой. Будут отправлены только уникальные значения. Изменения этого значения после создания экземпляра могут игнорироваться.
isFractionalZoomEnabled optional
Тип:  boolean optional
Значение по умолчанию: true для векторных карт и false для растровых карт.
Указывает, разрешены ли дробные уровни масштабирования. Прослушивайте isfractionalzoomenabled_changed, чтобы узнать, когда задан статус по умолчанию.
keyboardShortcuts optional
Тип:  boolean optional
Если задано значение false, картой нельзя управлять с клавиатуры. По умолчанию быстрые клавиши включены.
mapId optional
Тип:  string optional
Идентификатор карты. Этот параметр нельзя задать или изменить после создания экземпляра карты. Map.DEMO_MAP_ID можно использовать, чтобы попробовать функции, для которых требуется идентификатор карты, но не требуется включение облачных сервисов.
mapTypeControl optional
Тип:  boolean optional
Начальное состояние элемента управления типом карты (включен или отключен).
mapTypeControlOptions optional
Тип:  MapTypeControlOptions optional
Начальные параметры отображения для элемента управления типом карты.
mapTypeId optional
Тип:  MapTypeId|string optional
Начальный идентификатор mapTypeId карты. Значение по умолчанию – ROADMAP.
maxZoom optional
Тип:  number optional
Максимальный коэффициент масштабирования, который может использоваться для отображения карты. Если значение не указано или равно null, используется максимальный уровень масштабирования для текущего типа карты. Допустимые значения масштабирования – это числа от нуля до поддерживаемого максимального уровня масштабирования.
minZoom optional
Тип:  number optional
Минимальный коэффициент масштабирования, который может использоваться для отображения карты. Если значение не указано или равно null, используется минимальный масштаб для текущего типа карты. Допустимые значения масштабирования – это числа от нуля до поддерживаемого максимального уровня масштабирования.
noClear optional
Тип:  boolean optional
Если true, не очищайте содержимое div карты.
panControl optional
Тип:  boolean optional
Включенное/выключенное состояние элемента управления панорамированием.

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

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

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

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

Интерфейс MapTypeStyle

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

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

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

Интерфейс 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 интерфейс

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

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

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

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

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

Константы ColorScheme

google.maps.ColorScheme константы

Идентификаторы цветовых схем карт. Укажите их по значению или по названию константы. Примеры: 'FOLLOW_SYSTEM' или google.maps.ColorScheme.FOLLOW_SYSTEM.

Чтобы получить доступ, позвоните по номеру const {ColorScheme} = await google.maps.importLibrary("core").
Подробнее о библиотеках Maps JavaScript API…

DARK Темная цветовая схема для карты.
FOLLOW_SYSTEM Цветовая схема выбирается на основе системных настроек, которые проверяются один раз во время выполнения метода.
LIGHT Светлая цветовая схема для карты. Значение по умолчанию для устаревшей версии Maps JS.

Константы 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 класс

Реестр для экземпляров 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 интерфейс

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

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

Класс TrafficLayer

google.maps.TrafficLayer класс

Слой "Пробки".

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

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

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

Интерфейс TrafficLayerOptions

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

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

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

Класс TransitLayer

google.maps.TransitLayer класс

Слой общественного транспорта.

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

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

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

Класс BicyclingLayer

google.maps.BicyclingLayer класс

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

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

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

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

Интерфейс CameraOptions

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

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

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

Интерфейс VisibleRegion

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

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

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

Константы RenderingType

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

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

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

Интерфейс MapCapabilities

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

Объект, содержащий снимок возможностей, доступных в настоящее время для карты. Это не обязательно означает, что соответствующие модули загружены или инициализированы, а лишь то, что у текущей карты есть разрешение на использование этих API. Список возможных функций приведен в свойствах.

isAdvancedMarkersAvailable optional
Тип:  boolean optional
Если возвращается значение true, карта настроена правильно и на ней можно использовать расширенные маркеры. Обратите внимание, что для использования расширенных маркеров вам по-прежнему нужно импортировать библиотеку marker. Подробную информацию можно найти на странице https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional
Тип:  boolean optional
Если значение true, то карта настроена правильно и позволяет использовать стили на основе данных хотя бы для одного FeatureLayer. Дополнительную информацию можно найти на страницах https://goo.gle/gmp-data-driven-styling и https://goo.gle/gmp-FeatureLayerIsAvailable.
isWebGLOverlayViewAvailable optional
Тип:  boolean optional
Если задано значение True, карта настроена правильно и позволяет использовать WebGLOverlayView.