Marker

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Marker

Clase google.maps.Marker

Esta clase extiende MVCObject.

Cuando se usa v=beta, se puede acceder a él llamando a const {Marker} = await google.map.importLibrary("marker"). Consulta Bibliotecas en la API de Maps JavaScript.

Marker
Marker([opts])
Parámetros:
Crea un marcador con las opciones especificadas. Si se especifica un mapa, el marcador se agrega al mapa en el momento de la construcción. Ten en cuenta que la posición se debe establecer para que se muestre el marcador.
getAnimation
getAnimation()
Parámetros: ninguno
Valor que se muestra: Animation|null|undefined
Obtén la animación que se está ejecutando actualmente.
getClickable
getClickable()
Parámetros: ninguno
Valor que se muestra: boolean "True" si se puede hacer clic en el Marcador.
Obtén el estado en el que se puede hacer clic de Marker.
getCursor
getCursor()
Parámetros: ninguno
Valor que se muestra: string|null|undefined
Obtén el tipo de cursor del mouse que se muestra cuando se coloca el cursor sobre un elemento.
getDraggable
getDraggable()
Parámetros: ninguno
Return Value: boolean Verdadero si el marcador es arrastrable.
Obtén el estado arrastrable de Marker.
getIcon
getIcon()
Parámetros: ninguno
Valor que se muestra: string|Icon|null|Symbol|undefined
Obtén el ícono de Marker. Consulta los MarkerOptions.icon.
getLabel
getLabel()
Parámetros: ninguno
Valor que se muestra: MarkerLabel|null|string|undefined
Obtén la etiqueta de Marker. Consulta los MarkerOptions.label.
getMap
getMap()
Parámetros: ninguno
Valor que se muestra: Map|StreetViewPanorama
Obtén el mapa o el Panaroama en el que se renderiza el Marker.
getOpacity
getOpacity()
Parámetros: ninguno
Valor que se muestra: number|null|undefined Un número entre 0.0 y 1.0.
Obtén la opacidad de Marker.
getPosition
getPosition()
Parámetros: ninguno
Valor que se muestra: LatLng|null|undefined
Obtén la posición de Marker.
getShape
getShape()
Parámetros: ninguno
Valor que se muestra: MarkerShape|null|undefined
Obtén la forma del Marker que se usa para la interacción. Consulta MarkerOptions.shape y MarkerShape.
getTitle
getTitle()
Parámetros: ninguno
Valor que se muestra: string|null|undefined
Obtén el título de la información sobre la herramienta de Marker. Consulta los MarkerOptions.title.
getVisible
getVisible()
Parámetros: ninguno
Return Value: boolean True si el marcador está visible.
Obtén la visibilidad del Marker.
getZIndex
getZIndex()
Parámetros: ninguno
Valor que se muestra: number|null|undefined zIndex del marcador.
Obtén el zIndex de Marker. Consulta los MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
Parámetros:
  • animation: Animation optional La animación que se reproducirá.
Valor que se muestra: Ninguno
Inicia una animación. Se cancelará cualquier animación en curso. Actualmente, las animaciones admitidas son: Animation.BOUNCE, Animation.DROP. Si pasas null, se detendrá cualquier animación.
setClickable
setClickable(flag)
Parámetros:
  • flagboolean Si es true, se puede hacer clic en el marcador.
Valor que se muestra: Ninguno
Establece si se puede hacer clic en la Marker.
setCursor
setCursor([cursor])
Parámetros:
  • cursorstring optional Tipo de cursor del mouse.
Valor que se muestra: Ninguno
Establece el tipo de cursor del mouse que se muestra cuando se coloca el cursor sobre un elemento.
setDraggable
setDraggable(flag)
Parámetros:
  • flagboolean optional Si es true, se puede arrastrar el marcador.
Valor que se muestra: Ninguno
Configura si Marker es arrastrable.
setIcon
setIcon([icon])
Parámetros:
Valor que se muestra: Ninguno
Establece el ícono de Marker. Consulta los MarkerOptions.icon.
setLabel
setLabel([label])
Parámetros:
Valor que se muestra: Ninguno
Configura la etiqueta para Marker. Consulta los MarkerOptions.label.
setMap
setMap(map)
Parámetros:
Valor que se muestra: Ninguno
Renderiza Marker en el mapa o la panorámica especificados. Si el mapa se establece en null, se quitará el marcador.
setOpacity
setOpacity([opacity])
Parámetros:
  • opacity: number optional Un número entre 0.0, transparente y 1.0, opaco.
Valor que se muestra: Ninguno
Configura la opacidad de Marker.
setOptions
setOptions(options)
Parámetros:
Valor que se muestra: Ninguno
Establece las opciones para Marker.
setPosition
setPosition([latlng])
Parámetros:
Valor que se muestra: Ninguno
Establece la posición para el Marker.
setShape
setShape([shape])
Parámetros:
Valor que se muestra: Ninguno
Configura la forma de Marker que se usa para la interacción. Consulta MarkerOptions.shape y MarkerShape.
setTitle
setTitle([title])
Parámetros:
  • titlestring optional
Valor que se muestra: Ninguno
Establece el título de la información sobre la herramienta de Marker. Consulta los MarkerOptions.title.
setVisible
setVisible(visible)
Parámetros:
  • visibleboolean Si es true, el marcador estará visible.
Valor que se muestra: Ninguno
Configura si Marker es visible.
setZIndex
setZIndex([zIndex])
Parámetros:
  • zIndexnumber optional
Valor que se muestra: Ninguno
Configura el zIndex de Marker. Consulta los MarkerOptions.zIndex.
Heredada: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
MAX_ZINDEX El valor Z máximo predeterminado que la API asignará a un marcador. Puedes establecer un índice Z superior para acercar un marcador.
animation_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad de animación Marker.
click
function(event)
Argumentos:
Este evento se activa cuando se hace clic en el ícono Marker.
clickable_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad de Marker en la que se puede hacer clic.
contextmenu
function(event)
Argumentos:
Este evento se activa cuando el evento del menú contextual DOM se activa en el Marker.
cursor_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad del cursor Marker.
dblclick
function(event)
Argumentos:
Este evento se activa cuando se hace doble clic en el ícono Marker.
drag
function(event)
Argumentos:
Este evento se activa de forma repetida mientras el usuario arrastra el elemento Marker.
dragend
function(event)
Argumentos:
Este evento se activa cuando el usuario deja de arrastrar el elemento Marker.
draggable_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad arrastrable de Marker.
dragstart
function(event)
Argumentos:
Este evento se activa cuando el usuario comienza a arrastrar la Marker.
flat_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad plana Marker.
icon_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad del ícono Marker.
mousedown
function(event)
Argumentos:
Este evento se activa cuando se coloca el mouse sobre el Marker.
mouseout
function(event)
Argumentos:
Este evento se activa cuando el mouse abandona el área del ícono de Marker.
mouseover
function(event)
Argumentos:
Este evento se activa cuando el mouse ingresa en el área del ícono Marker.
mouseup
function(event)
Argumentos:
Este evento se activa para un mouseup en el Marker.
position_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad de posición Marker.
shape_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad de la forma Marker.
title_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad del título Marker.
visible_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad visible de Marker.
zindex_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad Marker de zIndex.
rightclick
function(event)
Argumentos:
Este evento se activa cuando se hace clic con el botón derecho en la Marker.

MarkerOptions

Interfaz de google.maps.MarkerOptions

MarkerOptions utilizado para definir las propiedades que se pueden establecer en un marcador.

anchorPoint optional
Tipo: Point optional
El desplazamiento desde la posición del marcador hasta la punta de un objeto InfoWindow que se abrió con el marcador como anclaje.
animation optional
Tipo: Animation optional
Predeterminado: null
Animación que se reproducirá cuando se agregue el marcador a un mapa
clickable optional
Tipo: boolean optional
Predeterminado: true
Si es true, el marcador recibe eventos del mouse y táctiles.
BetacollisionBehavior optional
Tipo: string|CollisionBehavior optional
Predeterminado: null
Establece un comportamiento de colisión para los marcadores en mapas de vectores.
crossOnDrag optional
Tipo: boolean optional
Predeterminado: true
Si el valor es false, inhabilita la cruz que aparece debajo del marcador cuando se arrastra.
cursor optional
Tipo: string optional
Predeterminado: pointer
Tipo de cursor del mouse para mostrar cuando se coloca el cursor sobre un elemento.
draggable optional
Tipo: boolean optional
Predeterminado: false
Si es true, se podrá arrastrar el marcador.
icon optional
Tipo: string|Icon|Symbol optional
Ícono de primer plano. Si se proporciona una string, se trata como si fuera una Icon con la string como url.
label optional
Tipo: string|MarkerLabel optional
Predeterminado: null
Agrega una etiqueta al marcador. Una etiqueta de marcador es una letra o un número que aparecen dentro de un marcador. La etiqueta puede ser una string o un objeto MarkerLabel. Si se proporciona y MarkerOptions.title no se proporciona, se agregará un texto de accesibilidad (p.ej., para usar con lectores de pantalla) al marcador con el texto de la etiqueta proporcionada. Ten en cuenta que, actualmente, label solo se usa para el texto de accesibilidad de marcadores no optimizados.
map optional
Tipo: Map|StreetViewPanorama optional
Mapa en el que se muestra el marcador. Se requiere el mapa para mostrar el marcador y se puede proporcionar con Marker.setMap si no se proporciona en el momento de su construcción.
opacity optional
Tipo: number optional
Predeterminado: 1.0
Un número entre 0.0, transparente y 1.0, opaco.
optimized optional
Tipo: boolean optional
La optimización mejora el rendimiento al representar muchos marcadores como un único elemento estático. Esto resulta útil en los casos en los que se requiere una gran cantidad de marcadores. Obtén más información acerca de la optimización de marcadores.
position optional
Tipo: LatLng|LatLngLiteral optional
Establece la posición del marcador. Un marcador se puede construir, pero no se muestra hasta que se proporciona su posición, por ejemplo, por las acciones o las elecciones del usuario. Se puede proporcionar una posición del marcador con Marker.setPosition si no se proporciona al construir el marcador.
shape optional
Tipo: MarkerShape optional
Definición de la región del mapa de la imagen que se usa para arrastrar/hacer clic.
title optional
Tipo: string optional
Predeterminado: undefined
texto de sustitución. Si se proporciona, se agregará al marcador el texto de accesibilidad (p.ej., para usarlo con lectores de pantalla) con el valor proporcionado. Ten en cuenta que, actualmente, title solo se usa para el texto de accesibilidad de marcadores no optimizados.
visible optional
Tipo: boolean optional
Predeterminado: true
Si es true, el marcador es visible.
zIndex optional
Tipo: number optional
Todos los marcadores se muestran en el mapa en el orden de su zIndex, con valores más altos frente a los marcadores con valores más bajos. De forma predeterminada, los marcadores se muestran según su posición vertical en la pantalla, con marcadores más bajos delante de los marcadores más arriba en la pantalla.

Constantes de CollisionBehavior

google.maps.CollisionBehavior constantes

Cuando se usa v=beta, se puede acceder a él llamando a const {CollisionBehavior} = await google.map.importLibrary("marker"). Consulta Bibliotecas en la API de Maps JavaScript.

OPTIONAL_AND_HIDES_LOWER_PRIORITY Mostrar el marcador solo si no se superpone con otros. Si dos marcadores de este tipo se superponen, se muestra el que tiene el zIndex más alto. Si tienen el mismo zIndex, se mostrará el que tenga la posición de pantalla vertical inferior.
REQUIRED Mostrar siempre el marcador independientemente de la colisión. Este es el comportamiento predeterminado.
REQUIRED_AND_HIDES_OPTIONAL Mostrar siempre el marcador independientemente de su colisión y ocultar todos los marcadores OPTIONAL_AND_HIDES_LOWER_PRIORITY o etiquetas que puedan superponerse con el marcador.

Icon

Interfaz de google.maps.Icon

Estructura que representa una imagen del ícono de marcador.

url
Tipo: string
Corresponde a la URL de la hoja de imagen o del sprite.
anchor optional
Tipo: Point optional
Posición en la que se ancla una imagen en correspondencia con la ubicación del marcador en el mapa. De forma predeterminada, el anclaje se encuentra en el punto central de la parte inferior de la imagen.
labelOrigin optional
Tipo: Point optional
Origen de la etiqueta en relación con la esquina superior izquierda de la imagen del ícono, si el marcador proporciona una etiqueta De forma predeterminada, el origen se encuentra en el punto central de la imagen.
origin optional
Tipo: Point optional
La posición de la imagen dentro de un sprite, si la hubiera. De forma predeterminada, el origen se encuentra en la esquina superior izquierda de la imagen (0, 0).
scaledSize optional
Tipo: Size optional
Tamaño de toda la imagen después de escalar, si la hay. Usa esta propiedad para estirar o contraer una imagen o un sprite.
size optional
Tipo: Size optional
El tamaño de visualización del sprite o imagen. Cuando usas sprites, debes especificar su tamaño. Si no se proporciona el tamaño, se establecerá cuando se cargue la imagen.

MarkerLabel

Interfaz de google.maps.MarkerLabel

Estas opciones especifican la apariencia de una etiqueta de marcador. Una etiqueta de marcador es una cadena (con frecuencia, un solo carácter) que aparece dentro del marcador. Si la usas con un marcador personalizado, puedes volver a colocarla con la propiedad labelOrigin en la clase Icon.

text
Tipo: string
Texto que se mostrará en la etiqueta
className optional
Tipo: string optional
Valor predeterminado: '' (string vacía)
La propiedad className del elemento de la etiqueta (equivalente al atributo de clase del elemento). Se pueden agregar varias clases de CSS separadas por espacios. El color, el tamaño, el grosor y la familia de las fuentes solo pueden establecerse mediante las demás propiedades de MarkerLabel. Las clases CSS no se deben usar para cambiar la posición ni la orientación de la etiqueta (p.ej., mediante traducciones y rotaciones) si también se utiliza la administración de colisiones de marcadores.
color optional
Tipo: string optional
Predeterminado: 'black'
El color del texto de la etiqueta.
fontFamily optional
Tipo: string optional
La familia de fuentes del texto de la etiqueta (equivalente a la propiedad de familia de fuentes de CSS).
fontSize optional
Tipo: string optional
Predeterminado: '14px'
El tamaño de la fuente del texto de la etiqueta (equivalente a la propiedad de tamaño de fuente de CSS)
fontWeight optional
Tipo: string optional
El grosor de fuente del texto de la etiqueta (equivalente a la propiedad de grosor de fuente de CSS)

MarkerShape.

Interfaz de google.maps.MarkerShape

Este objeto define la región en la que se puede hacer clic de una imagen de marcador. La forma consta de dos propiedades, type y coord, que definen la región no transparente de una imagen.

coords
Tipo: Array<number>
El formato de este atributo depende del valor de type y sigue la especificación w3 AREA coords que se encuentra en http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords.
El atributo coords es un array de números enteros que especifica la posición de píxeles de la forma en relación con la esquina superior izquierda de la imagen objetivo. Las coordenadas dependen del valor de type de la siguiente manera:
- circle: coords es [x1,y1,r], donde x1,y2 son las coordenadas del centro del círculo, y r es el radio del círculo.
- poly: coords es [x1,y1,x2,y2...xn,yn], donde cada par x,y contiene las coordenadas de un vértice del polígono.
- rect: los valores son [x1,y1,x2,y2], donde x1,y1 son las coordenadas de la esquina superior izquierda del rectángulo y x2,y2 son las coordenadas de las coordenadas inferior derecha del rectángulo.
type
Tipo: string
Describe el tipo de forma y puede ser circle, poly o rect.

Symbol

Interfaz de google.maps.Symbol

Describe un símbolo, que consiste en un trazado vectorial con ajustes de estilo. Un símbolo se puede utilizar como el icono de un marcador o colocar en una polilínea.

path
Tipo: SymbolPath|string
La ruta del símbolo, que es una ruta de símbolo integrada o una ruta personalizada expresada con la notación de ruta SVG. Obligatorio.
anchor optional
Tipo: Point optional
Predeterminado: google.maps.Point(0,0)
Posición del símbolo en relación con el marcador o la polilínea. Las coordenadas del trazado del símbolo se convierten a la izquierda y arriba a través de las coordenadas de X e Y del anclaje. La posición se expresa en el mismo sistema de coordenadas que la ruta del símbolo.
fillColor optional
Tipo: string optional
El color de relleno del símbolo. Se admiten todos los colores CSS3, salvo aquellos con nombres extendidos. En el caso de los marcadores de símbolos, la configuración predeterminada es “black”. En el caso de los símbolos de las polilíneas, el valor predeterminado es el color de trazo de la polilínea correspondiente.
fillOpacity optional
Tipo: number optional
Predeterminado: 0
Opacidad de relleno del símbolo.
labelOrigin optional
Tipo: Point optional
Predeterminado: google.maps.Point(0,0)
El origen de la etiqueta en relación con el origen de la ruta, si la etiqueta suministra la etiqueta. El origen se expresa en el mismo sistema de coordenadas que el trazado del símbolo. Esta propiedad no se utiliza para los símbolos de polilíneas.
rotation optional
Tipo: number optional
Predeterminado: 0
El ángulo de rotación del símbolo, expresado en grados en sentido horario. Un símbolo en un IconSequence en el que fixedRotation es false se rota con respecto al ángulo del borde en el que se encuentra.
scale optional
Tipo: number optional
La cantidad en la que se ajusta el tamaño del símbolo En el caso de los marcadores de símbolos, el valor predeterminado es 1; después del ajuste, el símbolo puede ser de cualquier tamaño. En el caso de los símbolos de una polilínea, el valor predeterminado es el grosor de trazo de la polilínea. Después del ajuste, el símbolo debe caber dentro de un cuadrado de 22 píxeles de tamaño centrado en el anclaje del símbolo.
strokeColor optional
Tipo: string optional
El color de trazo del símbolo. Se admiten todos los colores CSS3, salvo aquellos con nombres extendidos. En el caso de los marcadores de símbolos, la configuración predeterminada es “black”. En el caso de los símbolos de una polilínea, el valor predeterminado es el color de trazo de la polilínea.
strokeOpacity optional
Tipo: number optional
Opacidad del trazo del símbolo. En el caso de los marcadores de símbolos, el valor predeterminado es 1. En el caso de los símbolos de una polilínea, se establece de forma predeterminada la opacidad de trazo de la polilínea.
strokeWeight optional
Tipo: number optional
Predeterminado: El Symbol.scale del símbolo.
El peso del trazo del símbolo.

SymbolPath constantes.

google.maps.SymbolPath constantes

Rutas de símbolos integradas.

Cuando se usa v=beta, se puede acceder a él llamando a const {SymbolPath} = await google.map.importLibrary("core"). Consulta Bibliotecas en la API de Maps JavaScript.

BACKWARD_CLOSED_ARROW Una flecha cerrada que apunta hacia atrás
BACKWARD_OPEN_ARROW Una flecha abierta que apunta hacia atrás
CIRCLE Un círculo
FORWARD_CLOSED_ARROW Una flecha cerrada que apunta hacia delante
FORWARD_OPEN_ARROW Una flecha abierta que apunta hacia delante

Constantes de animación

google.maps.Animation constantes

Animaciones que se pueden reproducir en un marcador. Usa el método Marker.setAnimation en el Marcador o la opción MarkerOptions.animation para reproducir una animación.

Cuando se usa v=beta, se puede acceder a él llamando a const {Animation} = await google.map.importLibrary("marker"). Consulta Bibliotecas en la API de Maps JavaScript.

BOUNCE El marcador rebota hasta que se detiene la animación llamando a Marker.setAnimation con null.
DROP El marcador va desde la parte superior del mapa hasta su ubicación final. La animación finalizará una vez que el marcador esté en su posición y Marker.getAnimation mostrará null. Este tipo de animación generalmente se especifica durante la creación del marcador.