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.