Advanced Markers

Класс AdvancedMarkerElement

google.maps.marker . AdvancedMarkerElement Класс google.maps.marker . AdvancedMarkerElement

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

Примечание. Использование в качестве веб-компонента (например, с использованием специального 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
content
Тип: Node optional
element
Тип: HTMLElement
Это поле доступно только для чтения. Элемент DOM, поддерживающий представление.
Beta gmpClickable
Тип: boolean optional
gmpDraggable
Тип: boolean optional
map
Тип: Map optional
position
HTML-атрибут:
  • <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker>
  • <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title
Тип: string
HTML-атрибут:
  • <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex
Тип: number optional
Beta addEventListener
addEventListener(type, listener[, options])
Параметры:
  • type : string с учетом регистра, представляющая тип события, которое необходимо прослушивать.
  • listener : EventListener | EventListenerObject Объект, который получает уведомление. Это должна быть функция или объект с методом handleEvent.
  • options : boolean| AddEventListenerOptions optional См. параметры . Пользовательские события поддерживают только 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 См. параметры.
Возвращаемое значение: 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 Интерфейс 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 Класс google.maps.marker . AdvancedMarkerClickEvent

Это событие создается при нажатии расширенного маркера. Получите доступ к позиции маркера с помощью event.target.position .

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

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

Класс ПинЭлемент

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

Интерфейс PinElementOptions

google.maps.marker . 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
Масштаб штифта.