Advanced Markers

Clase AdvancedMarkerElement

Clase google.maps.marker.AdvancedMarkerElement

Muestra una posición en un mapa. Ten en cuenta que se debe establecer position para que se muestre AdvancedMarkerElement.

Nota: El uso como componente web (p.ej., con el elemento HTML <gmp-advanced-marker> personalizado, solo está disponible en el canal v=beta).

Elemento personalizado:
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>

Esta clase extiende HTMLElement.

Esta clase implementa AdvancedMarkerElementOptions.

Para acceder, llama a const {AdvancedMarkerElement} = await google.maps.importLibrary("marker"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

Constructor
AdvancedMarkerElement	AdvancedMarkerElement([options]) Parámetros:  options:  AdvancedMarkerElementOptions optional Crea un AdvancedMarkerElement con las opciones especificadas. Si se especifica un mapa, el AdvancedMarkerElement se agrega al mapa durante la construcción.

Propiedades
collisionBehavior	Tipo:  CollisionBehavior optional Consulta los AdvancedMarkerElementOptions.collisionBehavior.
content	Tipo:  Node optional Consulta los AdvancedMarkerElementOptions.content.
element	Tipo:  HTMLElement Este campo es de solo lectura. El elemento DOM que respalda la vista.
gmpDraggable	Tipo:  boolean optional Consulta los AdvancedMarkerElementOptions.gmpDraggable.
map	Tipo:  Map optional Consulta los AdvancedMarkerElementOptions.map.
position	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Consulta los AdvancedMarkerElementOptions.position. Atributo HTML: <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker> <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title	Tipo:  string Consulta los AdvancedMarkerElementOptions.title. Atributo HTML: <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	Tipo:  number optional Consulta los AdvancedMarkerElementOptions.zIndex.

Métodos
addEventListener	Aviso: Solo disponible en el canal v=beta. addEventListener(type, listener[, options]) Parámetros:  type:  string Es una cadena que distingue mayúsculas de minúsculas, que representa el tipo de evento que se debe escuchar. listener:  EventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent. options:  boolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive. Valor que se devuelve:  void Configura una función a la que se llamará cada vez que se entregue el evento especificado al destino. Consulta addEventListener.
addListener	addListener(eventName, handler) Parámetros:  eventName:  string evento observado. handler:  Es la función Function para controlar los eventos. Valor que se devuelve:  MapsEventListener Es el objeto de escucha de eventos resultante. Agrega la función de objeto de escucha determinada al nombre de evento determinado en el sistema de eventos de Maps.
removeEventListener	Aviso: Solo disponible en el canal v=beta. removeEventListener(type, listener[, options]) Parámetros:  type:  string Es una cadena que especifica el tipo de evento del que se quitará un objeto de escucha de eventos. listener:  EventListener|EventListenerObject Es el objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento. options:  boolean|EventListenerOptions optional Consulta las opciones Valor que se devuelve:  void Elimina del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Eventos
click	function(event) Argumentos:  event:  MapMouseEvent Este evento se activa cuando se hace clic en el elemento AdvancedMarkerElement. No está disponible con addEventListener() (usa gmp-click en su lugar).
drag	function(event) Argumentos:  event:  MapMouseEvent Este evento se activa de manera repetida mientras el usuario arrastra el AdvancedMarkerElement. No está disponible con addEventListener().
dragend	function(event) Argumentos:  event:  MapMouseEvent Este evento se activa cuando el usuario deja de arrastrar AdvancedMarkerElement. No está disponible con addEventListener().
dragstart	function(event) Argumentos:  event:  MapMouseEvent Este evento se activa cuando el usuario comienza a arrastrar AdvancedMarkerElement. No está disponible con addEventListener().
gmp-click	Aviso: Solo disponible en el canal v=beta. function(event) Argumentos:  event:  AdvancedMarkerClickEvent Este evento se activa cuando se hace clic en el elemento AdvancedMarkerElement. Se recomienda usarlo con addEventListener() (en lugar de addListener()).

AdvancedMarkerElementOptions

Interfaz de google.maps.marker.AdvancedMarkerElementOptions

Opciones para construir un AdvancedMarkerElement.

Propiedades
collisionBehavior optional	Tipo:  CollisionBehavior optional Es una enumeración que especifica cómo debe comportarse una AdvancedMarkerElement cuando colisiona con otra AdvancedMarkerElement o con las etiquetas del mapa base en un mapa de vectores. Nota: La colisión AdvancedMarkerElement a AdvancedMarkerElement funciona tanto en los mapas de trama como en los de vectores. Sin embargo, AdvancedMarkerElement para la colisión de etiquetas del mapa base solo funciona en mapas de vectores.
content optional	Tipo:  Node optional Valor predeterminado: PinElement.element El elemento DOM que respalda la imagen de un AdvancedMarkerElement Nota: AdvancedMarkerElement no clona el elemento DOM que se pasó. Una vez que se pasa el elemento del DOM a un AdvancedMarkerElement, cuando se pasa el mismo elemento del DOM a otro AdvancedMarkerElement, se moverá el elemento del DOM y la AdvancedMarkerElement anterior quedará vacía.
gmpDraggable optional	Tipo:  boolean optional Valor predeterminado: false Si es true, se puede arrastrar el AdvancedMarkerElement. Nota: No se puede arrastrar AdvancedMarkerElement con altitud.
map optional	Tipo:  Map optional Mapa en el que se muestra el AdvancedMarkerElement. Es necesario que el mapa muestre el AdvancedMarkerElement, y se puede proporcionar configurando AdvancedMarkerElement.map si no se proporciona durante la construcción.
position optional	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Establece la posición de AdvancedMarkerElement. Un objeto AdvancedMarkerElement se puede construir sin una posición, pero no se mostrará hasta que se proporcione su posición; por ejemplo, a través de las acciones o elecciones de un usuario. Para proporcionar la posición de un AdvancedMarkerElement, se configura AdvancedMarkerElement.position si no se proporciona durante la construcción. Nota: AdvancedMarkerElement con altitud solo se admite en los mapas de vectores.
title optional	Tipo:  string optional texto de sustitución. Si se proporciona, se agregará un texto de accesibilidad (p.ej., para uso con lectores de pantalla) a AdvancedMarkerElement con el valor proporcionado.
zIndex optional	Tipo:  number optional Todas las AdvancedMarkerElement se muestran en el mapa en el orden de su zIndex, y los valores más altos se muestran delante de los AdvancedMarkerElement con valores más bajos. De forma predeterminada, los objetos AdvancedMarkerElement se muestran según su posición vertical en la pantalla, y los elementos AdvancedMarkerElement más bajos aparecen delante de los objetos AdvancedMarkerElement más arriba en la pantalla. Ten en cuenta que zIndex también se utiliza para ayudar a determinar la prioridad relativa entre CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY Marcadores avanzados. Un valor de zIndex más alto indica una prioridad más alta.

Clase AdvancedMarkerClickEvent

Clase google.maps.marker.AdvancedMarkerClickEvent

Aviso: Solo disponible en el canal v=beta.

Este evento se crea al hacer clic en un marcador avanzado. Accede a la posición del marcador con event.target.position.

Esta clase extiende Event.

Para acceder, llama a const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

Clase PinElement

Clase google.maps.marker.PinElement

Un objeto PinElement representa un elemento del DOM que consta de una forma y un glifo. La forma tiene el mismo estilo de globo que se ve en el elemento AdvancedMarkerElement predeterminado. El glifo es un elemento opcional del DOM que se muestra en la forma del globo. Un PinElement puede tener una relación de aspecto diferente según su PinElement.scale.

Nota: Aún no se admite el uso como componente web (p.ej., como subclase HTMLElement o HTML).

Esta clase extiende HTMLElement.

Esta clase implementa PinElementOptions.

Para acceder, llama a const {PinElement} = await google.maps.importLibrary("marker"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.

Constructor
PinElement	PinElement([options]) Parámetros:  options:  PinElementOptions optional

Propiedades
background	Tipo:  string optional Consulta los PinElementOptions.background.
borderColor	Tipo:  string optional Consulta los PinElementOptions.borderColor.
element	Tipo:  HTMLElement Este campo es de solo lectura. El elemento DOM que respalda la vista.
glyph	Tipo:  string|Element|URL optional Consulta los PinElementOptions.glyph.
glyphColor	Tipo:  string optional Consulta los PinElementOptions.glyphColor.
scale	Tipo:  number optional Consulta los PinElementOptions.scale.

Métodos
addEventListener	Aviso: Solo disponible en el canal v=beta. addEventListener(type, listener[, options]) Parámetros:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional Valor que se devuelve:  void Esta función aún no se encuentra disponible para su uso.
removeEventListener	Aviso: Solo disponible en el canal v=beta. removeEventListener(type, listener[, options]) Parámetros:  type:  string Es una cadena que especifica el tipo de evento del que se quitará un objeto de escucha de eventos. listener:  EventListener|EventListenerObject Es el objeto de escucha de eventos del controlador de eventos que se quitará del destino del evento. options:  boolean|EventListenerOptions optional Consulta las opciones Valor que se devuelve:  void Elimina del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

PinElementOptions

Interfaz de google.maps.marker.PinElementOptions

Opciones para crear un PinElement.

Propiedades
background optional	Tipo:  string optional El color de fondo de la forma de pin. Admite cualquier valor de color de CSS.
borderColor optional	Tipo:  string optional El color del borde de la forma de marcador. Admite cualquier valor de color de CSS.
glyph optional	Tipo:  string|Element|URL optional Es el elemento DOM que se muestra en el marcador.
glyphColor optional	Tipo:  string optional El color del glifo. Admite cualquier valor de color de CSS.
scale optional	Tipo:  number optional Valor predeterminado: 1 Es la escala del pin.