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
Вы можете создавать повторно используемые компоненты на основе веб-компонентов JavaScript Maps, таких как AdvancedMarkerElement , используя пользовательские элементы. По умолчанию любые пользовательские элементы, добавленные непосредственно в MapElement , будут помещены в слоты и отрисованы в MapPanes.overlayMouseTarget . Однако веб-компоненты JavaScript API Maps могут быть перенесены во внутренние слоты MapElement .
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener .
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .
gmp-zoomchange
function(event)
Аргументы:
Это событие срабатывает при изменении свойства масштабирования карты.

Интерфейс MapElementOptions

google.maps . MapElementOptions

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

center optional
Тип: LatLng | LatLngLiteral optional
См. MapElement.center .
headingInteractionDisabled optional
Тип: boolean optional
См. MapElement.headingInteractionDisabled .
internalUsageAttributionIds optional
Тип: Iterable <string> optional
См. MapElement.internalUsageAttributionIds .
mapId optional
Тип: string optional
См. MapElement.mapId .
renderingType optional
Тип: RenderingType optional
См. MapElement.renderingType .
tiltInteractionDisabled optional
Тип: boolean optional
См. MapElement.tiltInteractionDisabled .
zoom optional
Тип: number optional
См. MapElement.zoom .

Класс ZoomChangeEvent

google.maps . ZoomChangeEvent

Это событие создается в результате мониторинга изменения масштаба.

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

Доступ осуществляется путем вызова const {ZoomChangeEvent} = await google.maps.importLibrary("maps") .
См. Библиотеки в Maps JavaScript API .

Класс карты

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
Тип: 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 Заполнение в пикселях. Границы будут помещены в ту часть карты, которая останется после удаления отступов. Числовое значение обеспечит одинаковый отступ со всех четырёх сторон. Укажите здесь 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. Если идентификатор набора данных не связан со стилем карты или если стилизация, управляемая данными, недоступна (нет идентификатора карты, нет векторных фрагментов, нет слоёв объектов, управляемых данными, или наборов данных, настроенных в стиле карты), регистрируется ошибка, а результирующее значение FeatureLayer.isAvailable будет равно false.
getDiv
getDiv()
Параметры: нет
Возвращаемое значение: HTMLElement Элемент mapDiv карты.
getFeatureLayer
getFeatureLayer(featureType)
Параметры:
Возвращаемое значение: FeatureLayer
Возвращает FeatureLayer указанного типа FeatureType . FeatureLayer должен быть включён в консоли Google Cloud. Если 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
Возвращаемое значение: нет
Управляет возможностью нажатия на значки карты. Значок карты представляет собой точку интереса (POI). Чтобы отключить возможность нажатия на значки карты, передайте этому методу значение 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° недоступно (это поведение по умолчанию). Изображение под углом 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)
Аргументы:
Это событие вызывается, когда в контейнере карты вызывается событие DOM contextmenu.
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 значки карты неактивны. Значок карты обозначает точку интереса (POI).
colorScheme optional
Тип: ColorScheme |string optional
По умолчанию: ColorScheme.LIGHT
Начальная цветовая схема карты. Этот параметр можно задать только при инициализации карты.
controlSize optional
Тип: number optional
Размер элементов управления, отображаемых на карте, в пикселях. Это значение необходимо указать непосредственно при создании карты. Последующее изменение этого значения может привести к undefined состоянию элементов управления. Управляет только элементами управления, созданными самим 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 курсора, отображаемого при наведении указателя мыши на перетаскиваемую карту. Это свойство использует атрибут 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
Направление для аэрофотоснимка в градусах, измеряемое по часовой стрелке от направления на север. Направления привязаны к ближайшему доступному углу, для которого доступны изображения.
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
Включенное/выключенное состояние элемента управления Pan.

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

renderingType optional
Тип: RenderingType optional
По умолчанию: RenderingType.RASTER
Должна ли карта быть растровой или векторной? Этот параметр нельзя задать или изменить после создания экземпляра карты. Если параметр не задан, тип рендеринга (если доступен) будет определяться облачной конфигурацией для идентификатора карты. Обратите внимание, что векторные карты могут быть доступны не для всех устройств и браузеров, и при необходимости карта будет преобразована в растровую.
restriction optional
Тип: MapRestriction optional
Определяет границу, ограничивающую доступную пользователям область карты. Если эта граница установлена, пользователь может панорамировать и масштабировать карту, только пока камера находится в пределах этой границы.
rotateControl optional
Тип: boolean optional
Включенное/выключенное состояние элемента управления поворотом.
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 , которая будет отображаться при перемещении человечка Street View на карту. Если панорама не указана, при перемещении человечка в div карты будет отображаться панорама StreetViewPanorama по умолчанию.
streetViewControl optional
Тип: boolean optional
Начальное состояние элемента управления Street View Pegman (включено/выключено). Этот элемент управления является частью пользовательского интерфейса по умолчанию и должен быть установлен в false при отображении типа карты, на котором наложение дорог Street View не должно отображаться (например, карты типа, отличного от Earth).
streetViewControlOptions optional
Тип: StreetViewControlOptions optional
Первоначальные параметры отображения элемента управления Street View 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 ; это может привести к непредсказуемым последствиям.
tiltInteractionEnabled optional
Тип: boolean optional
По умолчанию: false
Должна ли карта позволять пользователю управлять наклоном камеры. Этот параметр действует только для векторной карты. Если не задано в коде, будет использоваться облачная конфигурация для идентификатора карты (при наличии).
zoom optional
Тип: number optional
Начальный уровень масштабирования карты. Допустимые значения масштабирования — числа от нуля до поддерживаемого максимального уровня масштабирования . Большие значения масштабирования соответствуют более высокому разрешению.
zoomControl optional
Тип: boolean optional
Включенное/выключенное состояние элемента управления Zoom.
zoomControlOptions optional
Тип: ZoomControlOptions optional
Параметры отображения для элемента управления Zoom.

Интерфейс 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 внутренней реализации API Карт. Из-за внутреннего сопоставления событий семантика domEvent может отличаться от семантики MapMouseEvent (например, событие MapMouseEvent «click» может иметь domEvent типа KeyboardEvent ).
latLng optional
Тип: LatLng optional
Широта/долгота, которая находилась под курсором в момент возникновения события.
stop
stop()
Параметры: нет
Возвращаемое значение: void
Предотвращает дальнейшее распространение этого события.

Интерфейс IconMouseEvent

google.maps . IconMouseEvent

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

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

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

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

Наследуется: 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

Интерфейс ограничения карты

google.maps . MapRestriction

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

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

Класс ТрафикЛайер

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

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

google.maps . CameraOptions

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

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

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

google.maps . VisibleRegion

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

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

Константы типа рендеринга

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
Если это правда, эта карта настроена правильно, чтобы можно было использовать расширенные маркеры. Обратите внимание, что вам все равно необходимо импортировать библиотеку marker , чтобы использовать расширенные маркеры. См. https://goo.gle/gmp-isAdvancedMarkersAvailable для получения дополнительной информации.
isDataDrivenStylingAvailable optional
Тип: boolean optional
Если это правда, эта карта настроена правильно, чтобы разрешить использование стилей на основе данных хотя бы для одного FeatureLayer. См. https://goo.gle/gmp-data-driven-styling и https://goo.gle/gmp-FeatureLayerIsAvailable для получения дополнительной информации.
isWebGLOverlayViewAvailable optional
Тип: boolean optional
Если это правда, эта карта настроена правильно, чтобы разрешить использование WebGLOverlayView .