Advanced Markers

Класс AdvancedMarkerElement

google.maps.marker . AdvancedMarkerElement

Показывает положение на карте. Обратите внимание, что для отображения AdvancedMarkerElement position должно быть задано.

Примечание: использование в качестве веб-компонента (например, с использованием настраиваемого HTML-элемента <gmp-advanced-marker> доступно только в канале v=beta ).

Пользовательский элемент:
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>

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

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

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

AdvancedMarkerElement
AdvancedMarkerElement([options])
Параметры:
Создаёт элемент AdvancedMarkerElement с указанными параметрами. Если указана карта, элемент AdvancedMarkerElement добавляется к ней при построении.
collisionBehavior
Тип: CollisionBehavior optional
См. AdvancedMarkerElementOptions.collisionBehavior .
content
Тип: Node optional
См. AdvancedMarkerElementOptions.content .
element
Тип: HTMLElement
Это поле доступно только для чтения. Элемент DOM, поддерживающий представление.
Beta gmpClickable
Тип: boolean optional
Видеть Beta AdvancedMarkerElementOptions.gmpClickable .
gmpDraggable
Тип: boolean optional
См. AdvancedMarkerElementOptions.gmpDraggable .
map
Тип: Map optional
См. AdvancedMarkerElementOptions.map .
position
См. AdvancedMarkerElementOptions.position .
HTML-атрибут:
  • <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker>
  • <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title
Тип: string
См. AdvancedMarkerElementOptions.title .
HTML-атрибут:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Тип: number optional
См. AdvancedMarkerElementOptions.zIndex .
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string Чувствительная к регистру строка, представляющая тип события, которое нужно отслеживать.
  • listener : EventListener | EventListenerObject — объект, получающий уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. options . Пользовательские события поддерживают только capture и passive .
Возвращаемое значение: void
Устанавливает функцию, которая будет вызываться при каждой доставке указанного события целевому объекту. См. addEventListener.
addListener
addListener(eventName, handler)
Параметры:
  • eventName : string Наблюдаемое событие.
  • handler : Function Функция для обработки событий.
Возвращаемое значение: MapsEventListener Результирующий прослушиватель событий.
Добавляет заданную функцию прослушивателя к заданному имени события в системе событий Maps.
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .
click
function(event)
Аргументы:
Это событие вызывается при щелчке по элементу AdvancedMarkerElement .

Недоступно с addEventListener() (вместо этого используйте gmp-click ).
drag
function(event)
Аргументы:
Это событие многократно запускается, пока пользователь перетаскивает AdvancedMarkerElement .

Недоступно с addEventListener() .
dragend
function(event)
Аргументы:
Это событие срабатывает, когда пользователь прекращает перетаскивание AdvancedMarkerElement .

Недоступно с addEventListener() .
dragstart
function(event)
Аргументы:
Это событие вызывается, когда пользователь начинает перетаскивать AdvancedMarkerElement .

Недоступно с addEventListener() .
Beta gmp-click
function(event)
Аргументы:
Это событие срабатывает при щелчке по элементу AdvancedMarkerElement . Лучше всего использовать с addEventListener() (вместо addListener() ).

Интерфейс AdvancedMarkerElementOptions

google.maps.marker . AdvancedMarkerElementOptions

Варианты построения AdvancedMarkerElement .

collisionBehavior optional
Тип: CollisionBehavior optional
Перечисление, указывающее, как должен вести себя AdvancedMarkerElement при столкновении с другим AdvancedMarkerElement или с метками базовой карты на векторной карте.

Примечание : столкновение AdvancedMarkerElement с AdvancedMarkerElement работает как на растровых, так и на векторных картах, однако столкновение AdvancedMarkerElement с меткой базовой карты работает только на векторных картах.

content optional
Тип: Node optional
По умолчанию: PinElement.element
Элемент DOM, поддерживающий визуальный элемент AdvancedMarkerElement .

Примечание : AdvancedMarkerElement не клонирует переданный DOM-элемент. После передачи DOM-элемента в AdvancedMarkerElement передача того же DOM-элемента в другой AdvancedMarkerElement приведёт к перемещению DOM-элемента и к тому, что предыдущий AdvancedMarkerElement станет выглядеть пустым.

Beta gmpClickable optional
Тип: boolean optional
По умолчанию: false
Если true , элемент AdvancedMarkerElement можно будет щелкать, он вызовет событие gmp-click и будет интерактивным для обеспечения доступности (например, позволит навигацию с помощью клавиатуры с помощью клавиш со стрелками).
gmpDraggable optional
Тип: boolean optional
По умолчанию: false
Если true , AdvancedMarkerElement можно перетаскивать.

Примечание : AdvancedMarkerElement с указанием высоты перетаскивать нельзя.

map optional
Тип: Map optional
Карта, на которой будет отображаться AdvancedMarkerElement . Карта необходима для отображения AdvancedMarkerElement и может быть предоставлена ​​путем установки AdvancedMarkerElement.map , если она не указана при построении.
position optional
Задаёт позицию элемента AdvancedMarkerElement . Элемент AdvancedMarkerElement может быть создан без позиции, но не будет отображаться, пока её не укажет пользователь, например, в результате действий или выбора. Позицию элемента AdvancedMarkerElement можно задать, установив свойство AdvancedMarkerElement.position , если оно не было задано при создании.

Примечание : AdvancedMarkerElement с высотой поддерживается только на векторных картах.

title optional
Тип: string optional
Текст, отображаемый при наведении курсора. Если он указан, текст для специальных возможностей (например, для использования программами чтения с экрана) будет добавлен в элемент AdvancedMarkerElement с указанным значением.
zIndex optional
Тип: number optional
Все элементы AdvancedMarkerElement отображаются на карте в порядке их zIndex: элементы с более высокими значениями отображаются перед элементами AdvancedMarkerElement с более низкими. По умолчанию элементы AdvancedMarkerElement отображаются в соответствии с их вертикальным положением на экране: элементы AdvancedMarkerElement с более низкими значениями отображаются перед элементами AdvancedMarkerElement , расположенными выше по экрану. Обратите внимание, что zIndex также используется для определения относительного приоритета расширенных маркеров CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY . Чем больше значение zIndex , тем выше приоритет.

Класс AdvancedMarkerClickEvent

google.maps.marker . AdvancedMarkerClickEvent

Это событие создаётся при нажатии на расширенный маркер. Чтобы узнать положение маркера, используйте event.target.position .

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

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

Класс PinElement

google.maps.marker . PinElement

PinElement представляет собой DOM-элемент, состоящий из фигуры и глифа. Фигура имеет тот же стиль выноски, что и стандартный AdvancedMarkerElement . Глиф — необязательный элемент DOM, отображаемый в форме выноски. PinElement может иметь другое соотношение сторон в зависимости от его PinElement.scale .

Примечание: использование в качестве веб-компонента (например, использование в качестве подкласса HTMLElement или через HTML) пока не поддерживается.

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

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

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

PinElement
PinElement([options])
Параметры:
background
Тип: string optional
См. PinElementOptions.background .
borderColor
Тип: string optional
См. PinElementOptions.borderColor .
element
Тип: HTMLElement
Это поле доступно только для чтения. Элемент DOM, поддерживающий представление.
glyph
Тип: string| Element | URL optional
См. PinElementOptions.glyph .
glyphColor
Тип: string optional
См. PinElementOptions.glyphColor .
scale
Тип: number optional
См. PinElementOptions.scale .
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
Возвращаемое значение: void
Эта функция пока недоступна для использования.
Beta removeEventListener
removeEventListener(type, listener[, options])
Параметры:
  • type : string Строка, указывающая тип события, для которого следует удалить прослушиватель событий.
  • listener : EventListener | EventListenerObject Прослушиватель событий обработчика событий, который необходимо удалить из цели события.
  • options : boolean| EventListenerOptions optional См. options .
Возвращаемое значение: void
Удаляет прослушиватель событий, ранее зарегистрированный с помощью addEventListener, из целевого объекта. См. removeEventListener .

Интерфейс PinElementOptions

google.maps.marker . PinElementOptions

Варианты создания PinElement .

background optional
Тип: string optional
Цвет фона булавки. Поддерживает любое значение цвета CSS.
borderColor optional
Тип: string optional
Цвет границы булавки. Поддерживает любое значение цвета CSS.
glyph optional
Тип: string| Element | URL optional
Элемент DOM, отображаемый в пине.
glyphColor optional
Тип: string optional
Цвет глифа. Поддерживает любое значение цвета CSS.
scale optional
Тип: number optional
По умолчанию: 1
Масштаб булавки.