Se usó la API de Cloud Translation para traducir esta página.

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.

Constructor
`Marker`	`Marker([opts])` Parámetros: `opts`: `MarkerOptions optional` argumentos opcionales con nombre 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.

Métodos
`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: `flag`: `boolean` 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: `cursor`: `string 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: `flag`: `boolean optional` Si es `true`, se puede arrastrar el marcador. Valor que se muestra: Ninguno Configura si `Marker` es arrastrable.
`setIcon`	`setIcon([icon])` Parámetros: `icon`: `string\|Icon\|Symbol optional` Valor que se muestra: Ninguno Establece el ícono de `Marker`. Consulta los `MarkerOptions.icon`.
`setLabel`	`setLabel([label])` Parámetros: `label`: `string\|MarkerLabel optional` La etiqueta puede ser una string de caracteres o un objeto `MarkerLabel`. Valor que se muestra: Ninguno Configura la etiqueta para `Marker`. Consulta los `MarkerOptions.label`.
`setMap`	`setMap(map)` Parámetros: `map`: `Map\|StreetViewPanorama` 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: `options`: `MarkerOptions` Valor que se muestra: Ninguno Establece las opciones para `Marker`.
`setPosition`	`setPosition([latlng])` Parámetros: `latlng`: `LatLng\|LatLngLiteral optional` La nueva posición. Valor que se muestra: Ninguno Establece la posición para el `Marker`.
`setShape`	`setShape([shape])` Parámetros: `shape`: `MarkerShape optional` 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: `title`: `string 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: `visible`: `boolean` Si es `true`, el marcador estará visible. Valor que se muestra: Ninguno Configura si `Marker` es visible.
`setZIndex`	`setZIndex([zIndex])` Parámetros: `zIndex`: `number optional` Valor que se muestra: Ninguno Configura el zIndex de `Marker`. Consulta los `MarkerOptions.zIndex`.
Heredada: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Constantes
`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.

Eventos
`animation_changed`	`function()` Argumentos: Ninguno Este evento se activa cuando cambia la propiedad de animación `Marker`.
`click`	`function(event)` Argumentos: `event`: `MapMouseEvent` 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: `event`: `MapMouseEvent` 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: `event`: `MapMouseEvent` Este evento se activa cuando se hace doble clic en el ícono `Marker`.
`drag`	`function(event)` Argumentos: `event`: `MapMouseEvent` Este evento se activa de forma repetida mientras el usuario arrastra el elemento `Marker`.
`dragend`	`function(event)` Argumentos: `event`: `MapMouseEvent` 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: `event`: `MapMouseEvent` 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: `event`: `MapMouseEvent` Este evento se activa cuando se coloca el mouse sobre el `Marker`.
`mouseout`	`function(event)` Argumentos: `event`: `MapMouseEvent` Este evento se activa cuando el mouse abandona el área del ícono de `Marker`.
`mouseover`	`function(event)` Argumentos: `event`: `MapMouseEvent` Este evento se activa cuando el mouse ingresa en el área del ícono `Marker`.
`mouseup`	`function(event)` Argumentos: `event`: `MapMouseEvent` 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`	Obsoleto: En su lugar, usa el evento `Marker.contextmenu` para admitir patrones de uso, como control y clic en macOS. `function(event)` Argumentos: `event`: `MapMouseEvent` 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.

Propiedades
`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.
`collisionBehavior optional`	Aviso: Solo está disponible en el canal v=beta. 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.

Constantes
`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.

Propiedades
`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.

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.

Propiedades
`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.

Propiedades
`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`.

Propiedades

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.

Propiedades
`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.

Constantes
`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.

Constantes
`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.

Marker

Marker

Constructor

Métodos

Constantes

Eventos

MarkerOptions

Propiedades

Constantes de CollisionBehavior

Constantes

Icon

Propiedades

MarkerLabel

Propiedades

MarkerShape.

Propiedades

Symbol

Propiedades

SymbolPath constantes.

Constantes

Constantes de animación

Constantes