Maps

Clase MapElement

Clase google.maps.MapElement

MapElement es una subclase de HTMLElement para renderizar mapas. Después de cargar la biblioteca maps, se puede crear un mapa en HTML. Por ejemplo: 

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
De forma interna, usa Map, a la que se puede acceder con la propiedad MapElement.innerMap.

Elemento personalizado:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

Esta clase extiende HTMLElement.

Esta clase implementa MapElementOptions.

Para acceder, llama al const {MapElement} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.
MapElement
MapElement([options])
Parámetros: 
center
Tipo:  LatLng|LatLngLiteral optional
Es la latitud y longitud del centro del mapa.
Atributo HTML:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
Tipo:  boolean optional
La configuración predeterminada es false.
Indica si el mapa debe permitir que el usuario controle la orientación de la cámara (rotación). Esta opción solo se aplica cuando el mapa es de vectores. Si no se establece en el código, se usará la configuración de Cloud para el ID de mapa (si está disponible).
Atributo HTML:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
Tipo:  Map
Es una referencia al Map que MapElement usa de forma interna.
internalUsageAttributionIds
Tipo:  Iterable<string> optional
La configuración predeterminada es null.
Agrega un ID de atribución de uso al inicializador, lo que ayuda a Google a comprender qué bibliotecas y muestras son útiles para los desarrolladores, como el uso de una biblioteca de agrupamiento de marcadores en clústeres. Para inhabilitar el envío del ID de atribución de uso, puedes borrar esta propiedad o reemplazar el valor por una cadena vacía. Solo se enviarán valores únicos. Es posible que se ignoren los cambios que se realicen en este valor después de la creación de una instancia.
Atributo HTML:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
Tipo:  string optional
Es el ID de mapa del mapa. Este parámetro no se puede establecer ni cambiar después de que se crea una instancia del mapa. Map.DEMO_MAP_ID se puede usar para probar funciones que requieren un ID de mapa, pero que no requieren la habilitación de Cloud.
Atributo HTML:
  • <gmp-map map-id="string"></gmp-map>
renderingType
Tipo:  RenderingType optional
La configuración predeterminada es RenderingType.VECTOR.
Indica si el mapa debe ser de trama o de vectores. Este parámetro no se puede establecer ni cambiar después de que se crea una instancia del mapa. Si no se establece, la configuración de Cloud para el ID de mapa determinará el tipo de renderización (si está disponible). Ten en cuenta que es posible que los mapas de vectores no estén disponibles para todos los dispositivos y navegadores, y que el mapa recurra a un mapa de trama según sea necesario.
Atributo HTML:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
Tipo:  boolean optional
La configuración predeterminada es false.
Indica si el mapa debe permitir que el usuario controle la inclinación de la cámara. Esta opción solo tiene efecto cuando el mapa es un mapa de vectores. Si no se establece en el código, se usará la configuración de Cloud para el ID de mapa (si está disponible).
Atributo HTML:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
Tipo:  number optional
Es el nivel de zoom del mapa. Los valores de zoom válidos son números desde cero hasta el nivel de zoom máximo admitido. Los valores de zoom más altos corresponden a una resolución más alta.
Atributo HTML:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
Coloca el elemento asignado en la posición ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
Coloca el elemento asignado en la posición ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
Coloca el elemento con ranura en la posición ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
Coloca el elemento con ranura en la posición ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
Coloca el elemento con ranura en la posición ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
Coloca el elemento con ranura en la posición ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
Coloca el elemento asignado en la posición ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
Coloca el elemento asignado en la posición ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
Coloca el elemento con ranura en la posición ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
Coloca el elemento asignado en la posición ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
Coloca el elemento asignado en la posición ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
Coloca el elemento con ranura en la posición ControlPosition.INLINE_START_BLOCK_START.
default
Puedes crear componentes reutilizables en torno a los componentes web de la API de Maps JavaScript, como AdvancedMarkerElement, con elementos personalizados. De forma predeterminada, los elementos personalizados que se agreguen directamente a MapElement se asignarán y renderizarán en MapPanes.overlayMouseTarget. Sin embargo, los componentes web de la API de Maps JavaScript se pueden volver a asignar a los espacios internos de MapElement.
addEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • type:  string Es una cadena que distingue mayúsculas de minúsculas y 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 de retorno:  void
Configura una función a la que se llamará cada vez que se entregue el evento especificado al destino. Consulta addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • type:  string Es una cadena que especifica el tipo de evento para el 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 de retorno:  void
Quita del destino un objeto de escucha de eventos registrado anteriormente con addEventListener. Consulta removeEventListener.
gmp-zoomchange
function(event)
Argumentos: 
Este evento se activa cuando cambia la propiedad de zoom del mapa.

Interfaz MapElementOptions

Interfaz google.maps.MapElementOptions

Es el objeto MapElementOptions que se usa para definir las propiedades que se pueden establecer en un MapElement.
center optional
Tipo:  LatLng|LatLngLiteral optional
Consulta los MapElement.center.
headingInteractionDisabled optional
Tipo:  boolean optional
Consulta los MapElement.headingInteractionDisabled.
internalUsageAttributionIds optional
Tipo:  Iterable<string> optional
Consulta los MapElement.internalUsageAttributionIds.
mapId optional
Tipo:  string optional
Consulta los MapElement.mapId.
renderingType optional
Tipo:  RenderingType optional
Consulta los MapElement.renderingType.
tiltInteractionDisabled optional
Tipo:  boolean optional
Consulta los MapElement.tiltInteractionDisabled.
zoom optional
Tipo:  number optional
Consulta los MapElement.zoom.

Clase ZoomChangeEvent

Clase google.maps.ZoomChangeEvent

Este evento se crea a partir de la supervisión del cambio de zoom.

Esta clase extiende Event.

Para acceder, llama al const {ZoomChangeEvent} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.

Clase Map

Clase google.maps.Map

Esta clase extiende MVCObject.

Para acceder, llama al const {Map} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.
Map
Map(mapDiv[, opts])
Parámetros: 
  • mapDiv:  HTMLElement El mapa se renderizará para llenar este elemento.
  • opts: Opciones de MapOptions optional
Crea un mapa nuevo dentro del contenedor HTML en cuestión, que suele ser un elemento DIV.
DEMO_MAP_ID ID de mapa que se puede usar para las muestras de código que requieren un ID de mapa. Este ID de mapa no está diseñado para usarse en aplicaciones de producción y no se puede usar para funciones que requieran configuración de Cloud (como el diseño basado en Cloud).
controls
Son los controles adicionales que se adjuntarán al mapa. Para agregar un control al mapa, agrega el <div> del control al MVCArray correspondiente al ControlPosition en el que se debe renderizar.
data
Tipo:  Data
Es una instancia de Data vinculada al mapa. Agrega componentes a este objeto Data para mostrarlos de forma conveniente en este mapa.
mapTypes
Es un registro de instancias de MapType por ID de cadena.
overlayMapTypes
Tipo:  MVCArray<MapType optional>
Son tipos de mapas adicionales para superponer. Los tipos de mapas de superposición aparecen encima del mapa base al que se adjuntan, en el orden en que aparecen en el array overlayMapTypes (las superposiciones con valores de índices más altos se muestran encima de las superposiciones con valores de índices más bajos).
fitBounds
fitBounds(bounds[, padding])
Parámetros: 
  • bounds: Límites de LatLngBounds|LatLngBoundsLiteral que se mostrarán.
  • padding:  number|Padding optional Es el padding en píxeles. Los límites se ajustarán a la parte del mapa que quede después de quitar el padding. Un valor numérico producirá el mismo padding en los 4 lados. Proporciona 0 aquí para que fitBounds sea idempotente en el resultado de getBounds.
Valor de retorno: Ninguno
Establece el viewport para que contenga los límites dados.
Nota: Cuando el mapa se establece en display: none, la función fitBounds lee el tamaño del mapa como 0x0 y, por lo tanto, no hace nada. Para cambiar el viewport mientras el mapa está oculto, configúralo en visibility: hidden, lo que garantizará que el div del mapa tenga un tamaño real. En el caso de los mapas de vectores, este método establece la inclinación y la orientación del mapa en sus valores predeterminados de cero. Llamar a este método puede causar una animación fluida a medida que el mapa se desplaza y se acerca para ajustarse a los límites. Si este método se anima o no, depende de una heurística interna.
getBounds
getBounds()
Parámetros: Ninguno
Valor de retorno:  LatLngBounds|undefined Los límites de latitud y longitud del viewport actual.
Devuelve los límites de latitud y longitud del viewport actual. Si se puede ver más de una copia del mundo, los límites de la longitud varían entre -180 y 180 grados inclusive. Si el mapa aún no se inicializó o no se establecieron el centro y el zoom, el resultado es undefined. En el caso de los mapas de vectores con inclinación o rumbo distintos de cero, los límites de latitud y longitud devueltos representan el cuadro delimitador más pequeño que incluye la región visible del viewport del mapa. Consulta MapCanvasProjection.getVisibleRegion para obtener la región visible exacta del viewport del mapa.
getCenter
getCenter()
Parámetros: Ninguno
Valor de retorno:  LatLng|undefined
Devuelve la posición que se muestra en el centro del mapa. Ten en cuenta que este objeto LatLng no está unido. Consulta LatLng para obtener más información. Si no se establecieron el centro ni los límites, el resultado es undefined.
getClickableIcons
getClickableIcons()
Parámetros: Ninguno
Valor de retorno:  boolean|undefined
Devuelve la posibilidad de hacer clic en los íconos del mapa. Un ícono de mapa representa un lugar de interés, también conocido como POI. Si el valor que se muestra es true, se puede hacer clic en los íconos del mapa.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Parámetros: 
  • datasetId:  string
Valor de retorno:  FeatureLayer
Devuelve el FeatureLayer para el datasetId especificado. Los IDs de conjuntos de datos se deben configurar en la consola de Google Cloud. Si el ID del conjunto de datos no está asociado con el diseño de mapa, o si el diseño basado en datos no está disponible (no hay ID de mapa, tarjetas de vectores, capas de componentes de diseño basado en datos ni conjuntos de datos configurados en el diseño de mapa), se registrará un error y el FeatureLayer.isAvailable resultante será falso.
getDiv
getDiv()
Parámetros: Ninguno
Valor que se devuelve:  HTMLElement El mapDiv del mapa.
getFeatureLayer
getFeatureLayer(featureType)
Parámetros: 
Valor de retorno:  FeatureLayer
Devuelve el FeatureLayer del FeatureType específico. Se debe habilitar un FeatureLayer en la consola de Google Cloud. Si no existe un FeatureLayer del FeatureType especificado en este mapa o si el diseño basado en datos no está disponible (no hay un ID de mapa, no hay mosaicos vectoriales y no hay un FeatureLayer habilitado en el diseño de mapa), se registrará un error y el FeatureLayer.isAvailable resultante será falso.
getHeading
getHeading()
Parámetros: Ninguno
Valor de retorno:  number|undefined
Devuelve la orientación de la brújula del mapa. El valor de la orientación se mide en grados (en el sentido de las manecillas del reloj) desde el punto cardinal norte. Si el mapa aún no se inicializó, el resultado es undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Parámetros: Ninguno
Valor de retorno:  boolean|null
Indica si las interacciones de encabezado están habilitadas. Esta opción solo tiene efecto cuando el mapa es un mapa de vectores. Si no se establece en el código, se usará la configuración de Cloud para el ID de mapa (si está disponible).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Parámetros: Ninguno
Valor de retorno:  Iterable<string>|null
Devuelve la lista de IDs de atribución de uso, que ayudan a Google a comprender qué bibliotecas y muestras son útiles para los desarrolladores, como el uso de una biblioteca de agrupamiento de marcadores en clústeres.
getMapCapabilities
getMapCapabilities()
Parámetros: Ninguno
Valor de retorno:  MapCapabilities
Informa al emisor sobre las funciones actuales disponibles para el mapa según el ID de mapa que se proporcionó.
getMapTypeId
getMapTypeId()
Parámetros: Ninguno
Valor de retorno:  MapTypeId|string|undefined
getProjection
getProjection()
Parámetros: Ninguno
Valor de retorno:  Projection|undefined
Devuelve el Projection actual. Si el mapa aún no se inicializó, el resultado es undefined. Escucha el evento projection_changed y verifica su valor para asegurarte de que no sea undefined.
getRenderingType
getRenderingType()
Parámetros: Ninguno
Valor de retorno:  RenderingType
Devuelve el RenderingType actual del mapa.
getStreetView
getStreetView()
Parámetros: Ninguno
Valor de retorno:  StreetViewPanorama Es la panorámica vinculada al mapa.
Devuelve el objeto StreetViewPanorama predeterminado vinculado al mapa, que puede ser una panorámica predeterminada incorporada en el mapa o la panorámica establecida con setStreetView(). Los cambios en el streetViewControl del mapa se reflejarán en la visualización de ese panorama vinculado.
getTilt
getTilt()
Parámetros: Ninguno
Valor de retorno:  number|undefined
Devuelve el ángulo de incidencia actual del mapa, en grados, desde el plano del viewport hasta el plano del mapa. En el caso de los mapas de trama, el resultado será 0 para las imágenes tomadas directamente desde arriba o 45 para las imágenes de 45°. Este método no devuelve el valor establecido por setTilt. Consulta setTilt para obtener más información.
getTiltInteractionEnabled
getTiltInteractionEnabled()
Parámetros: Ninguno
Valor de retorno:  boolean|null
Indica si las interacciones de inclinación están habilitadas. Esta opción solo se aplica cuando el mapa es de vectores. Si no se establece en el código, se usará la configuración de Cloud para el ID de mapa (si está disponible).
getZoom
getZoom()
Parámetros: Ninguno
Valor de retorno:  number|undefined
Devuelve el zoom del mapa. Si no se estableció el zoom, el resultado es undefined.
moveCamera
moveCamera(cameraOptions)
Parámetros: 
Valor de retorno: Ninguno
Establece de inmediato la cámara del mapa en las opciones de cámara de destino, sin animación.
panBy
panBy(x, y)
Parámetros: 
  • x:  number Es la cantidad de píxeles que se moverá el mapa en la dirección x.
  • y:  number Es la cantidad de píxeles que se debe mover el mapa en la dirección y.
Valor de retorno: Ninguno
Cambia el centro del mapa según la distancia especificada en píxeles. Si la distancia es menor que el ancho y la altura del mapa, la transición se animará de forma fluida. Ten en cuenta que el sistema de coordenadas del mapa aumenta de oeste a este (para los valores de x) y de norte a sur (para los valores de y).
panTo
panTo(latLng)
Parámetros: 
Valor de retorno: Ninguno
Cambia el centro del mapa al LatLng especificado. Si el cambio es menor que el ancho y la altura del mapa, la transición se animará de forma fluida.
panToBounds
panToBounds(latLngBounds[, padding])
Parámetros: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral Son los límites hacia los que se desplazará el mapa.
  • padding:  number|Padding optional Es el padding en píxeles. Un valor numérico producirá el mismo padding en los 4 lados. El valor predeterminado es 0.
Valor de retorno: Ninguno
Desplaza el mapa la cantidad mínima necesaria para que contenga el LatLngBounds determinado. No se garantiza en qué parte del mapa se encontrarán los límites, excepto que el mapa se desplazará para mostrar la mayor parte posible de los límites dentro de {currentMapSizeInPx} - {padding}. En el caso de los mapas de trama y de vectores, no se cambiarán el zoom, la inclinación ni la orientación del mapa.
setCenter
setCenter(latlng)
Parámetros: 
Valor de retorno: Ninguno
setClickableIcons
setClickableIcons(value)
Parámetros: 
  • value:  boolean
Valor de retorno: Ninguno
Controla si se puede hacer clic en los íconos del mapa o no. Un ícono de mapa representa un lugar de interés, también conocido como POI. Para inhabilitar la posibilidad de hacer clic en los íconos del mapa, pasa un valor de false a este método.
setHeading
setHeading(heading)
Parámetros: 
  • heading:  number
Valor de retorno: Ninguno
Establece la orientación de la brújula para el mapa, medida en grados desde el punto cardinal norte. En el caso de los mapas de trama, este método solo se aplica a las imágenes aéreas.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
Parámetros: 
  • headingInteractionEnabled:  boolean
Valor de retorno: Ninguno
Establece si se habilitan las interacciones de encabezado. Esta opción solo se aplica cuando el mapa es de vectores. Si no se establece en el código, se usará la configuración de Cloud para el ID de mapa (si está disponible).
setMapTypeId
setMapTypeId(mapTypeId)
Parámetros: 
Valor de retorno: Ninguno
setOptions
setOptions(options)
Parámetros: 
Valor de retorno: Ninguno
setRenderingType
setRenderingType(renderingType)
Parámetros: 
Valor de retorno: Ninguno
Establece el RenderingType actual del mapa.
setStreetView
setStreetView(panorama)
Parámetros: 
Valor de retorno: Ninguno
Vincula un StreetViewPanorama al mapa. Esta panorámica anula el objeto StreetViewPanorama predeterminado, lo que permite que el mapa se vincule a una panorámica externa fuera del mapa. Si configuras la panorámica como null, se volverá a vincular la panorámica incorporada predeterminada al mapa.
setTilt
setTilt(tilt)
Parámetros: 
  • tilt:  number
Valor de retorno: Ninguno
En el caso de los mapas de vectores, establece el ángulo de incidencia del mapa. Los valores permitidos se restringen según el nivel de zoom del mapa.

En el caso de los mapas de trama, controla el comportamiento de cambio automático para el ángulo de incidencia del mapa. Los únicos valores permitidos son 0 y 45. setTilt(0) hace que el mapa siempre use una vista aérea de 0°, independientemente del nivel de zoom y del viewport. setTilt(45) hace que el ángulo de inclinación cambie automáticamente a 45 siempre que haya imágenes de 45° disponibles para el nivel de zoom y el viewport actuales, y que vuelva a 0 cuando no haya imágenes de 45° disponibles (este es el comportamiento predeterminado). Las imágenes a 45° solo están disponibles para los tipos de mapas satellite y hybrid, en algunas ubicaciones y en algunos niveles de zoom. Nota: getTilt devuelve el ángulo de inclinación actual, no el valor establecido por setTilt. Debido a que getTilt y setTilt hacen referencia a cosas diferentes, no bind() la propiedad tilt, ya que esto puede producir efectos impredecibles.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
Parámetros: 
  • tiltInteractionEnabled:  boolean
Valor de retorno: Ninguno
Establece si se habilitan las interacciones de inclinación. Esta opción solo se aplica cuando el mapa es de vectores. Si no se establece en el código, se usará la configuración de Cloud para el ID de mapa (si está disponible).
setZoom
setZoom(zoom)
Parámetros: 
  • zoom:  number Los valores de zoom más altos corresponden a una resolución más alta.
Valor de retorno: Ninguno
Establece el zoom del mapa.
Heredados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambian los límites del viewport.
center_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad del centro del mapa.
click
function(event)
Argumentos: 
Este evento se activa cuando el usuario hace clic en el mapa. Se devuelve un MapMouseEvent con propiedades para la ubicación en la que se hizo clic, a menos que se haya hecho clic en un ícono de lugar, en cuyo caso se devuelve un IconMouseEvent con un ID de lugar. IconMouseEvent y MapMouseEvent son idénticos, excepto que IconMouseEvent tiene el campo de ID de lugar. El evento siempre se puede tratar como un MapMouseEvent cuando el ID de lugar no es importante. El evento de clic no se activa si se hizo clic en un marcador o en una ventana de información.
contextmenu
function(event)
Argumentos: 
Este evento se activa cuando se activa el evento contextmenu del DOM en el contenedor del mapa.
dblclick
function(event)
Argumentos: 
Este evento se activa cuando el usuario hace doble clic en el mapa. Ten en cuenta que el evento de clic a veces se activará una vez y, otras, dos veces, justo antes de este.
drag
function()
Argumentos: Ninguno
Este evento se activa de manera repetida mientras el usuario arrastra el mapa.
dragend
function()
Argumentos: Ninguno
Este evento se activa cuando el usuario deja de arrastrar el mapa. Nota: dragend NO se activa cuando el usuario deja de desplazar el mapa con el teclado. En su lugar, usa el evento Map.idle para determinar cuándo el usuario dejó de desplazar O arrastrar el mapa.
dragstart
function()
Argumentos: Ninguno
Este evento se activa cuando el usuario comienza a arrastrar el mapa.
heading_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad de orientación del mapa.
idle
function()
Argumentos: Ninguno
Este evento se activa cuando el mapa queda inactivo después de desplazarse o hacer zoom.
isfractionalzoomenabled_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad isFractionalZoomEnabled.
mapcapabilities_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambian las capacidades del mapa.
maptypeid_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad mapTypeId.
mousemove
function(event)
Argumentos: 
Este evento se activa cada vez que el usuario mueve el mouse sobre el contenedor del mapa.
mouseout
function(event)
Argumentos: 
Este evento se activa cuando el mouse del usuario sale del contenedor del mapa.
mouseover
function(event)
Argumentos: 
Este evento se activa cuando el mouse del usuario ingresa al contenedor del mapa.
projection_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la proyección.
renderingtype_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia el renderingType.
tilesloaded
function()
Argumentos: Ninguno
Este evento se activa cuando se terminan de cargar las tarjetas visibles.
tilt_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad de inclinación del mapa.
zoom_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad de zoom del mapa.
rightclick
function(event)
Argumentos: 
Este evento se activa cuando el usuario hace clic con el botón derecho en el mapa.

Interfaz MapOptions

Interfaz google.maps.MapOptions

Es el objeto MapOptions que se usa para definir las propiedades que se pueden establecer en un mapa.
backgroundColor optional
Tipo:  string optional
Es el color que se usa para el fondo del div de Map. Este color será visible cuando las tarjetas aún no se hayan cargado mientras el usuario se desplaza. Esta opción solo se puede establecer cuando se inicializa el mapa.
cameraControl optional
Tipo:  boolean optional
El estado habilitado o inhabilitado del control de la cámara
cameraControlOptions optional
Tipo:  CameraControlOptions optional
Son las opciones de visualización del control de la cámara.
center optional
Tipo:  LatLng|LatLngLiteral optional
Es el centro inicial del mapa.
clickableIcons optional
Tipo:  boolean optional
La configuración predeterminada es true.
Cuando es false, no se puede hacer clic en los íconos del mapa. Un ícono de mapa representa un lugar de interés, también conocido como POI.
colorScheme optional
Tipo:  ColorScheme|string optional
La configuración predeterminada es ColorScheme.LIGHT.
Es el esquema de colores inicial del mapa. Esta opción solo se puede establecer cuando se inicializa el mapa.
controlSize optional
Tipo:  number optional
Es el tamaño en píxeles de los controles que aparecen en el mapa. Este valor se debe proporcionar directamente cuando se crea el mapa. Si se actualiza más adelante, los controles podrían quedar en un estado undefined. Solo rige los controles que realiza la API de Maps. No escala los controles personalizados creados por el desarrollador.
disableDefaultUI optional
Tipo:  boolean optional
Habilita o inhabilita todos los botones de la IU predeterminada. Se puede anular de forma individual. No inhabilita los controles del teclado, que se controlan por separado con la opción MapOptions.keyboardShortcuts. No inhabilita los controles de gestos, que se controlan por separado con la opción MapOptions.gestureHandling.
disableDoubleClickZoom optional
Tipo:  boolean optional
Habilita o inhabilita el zoom y el centrado al hacer doble clic. Habilitada de forma predeterminada.

Nota: No se recomienda usar esta propiedad. Para inhabilitar el zoom al hacer doble clic, puedes usar la propiedad gestureHandling y establecerla en "none".
draggable optional
Tipo:  boolean optional
Si es false, impide que el mapa se arrastre y se acerque o aleje con gestos táctiles y del mouse. La función de arrastrar está habilitada de forma predeterminada.
draggableCursor optional
Tipo:  string optional
Es el nombre o la URL del cursor que se mostrará cuando se coloque el mouse sobre un mapa arrastrable. Esta propiedad usa el atributo CSS cursor para cambiar el ícono. Al igual que con la propiedad de CSS, debes especificar al menos un cursor de resguardo que no sea una URL. Por ejemplo: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Tipo:  string optional
Es el nombre o la URL del cursor que se mostrará cuando se arrastre el mapa. Esta propiedad usa el atributo CSS cursor para cambiar el ícono. Al igual que con la propiedad CSS, debes especificar al menos un cursor de resguardo que no sea una URL. Por ejemplo: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Tipo:  boolean optional
Es el estado habilitado o inhabilitado del control de pantalla completa.
fullscreenControlOptions optional
Tipo:  FullscreenControlOptions optional
Son las opciones de visualización del control de pantalla completa.
gestureHandling optional
Tipo:  string optional
Este parámetro de configuración controla cómo la API maneja los gestos en el mapa. Valores permitidos:
  • "cooperative": Los eventos de desplazamiento y los gestos táctiles con un dedo desplazan la página, y no acercan ni alejan el mapa ni se desplazan lateralmente por él. Los gestos táctiles con dos dedos permiten desplazar el mapa lateralmente y hacer zoom en él. Los eventos de desplazamiento con la tecla Ctrl o ⌘ presionada acercan o alejan el mapa.
    En este modo, el mapa coopera con la página.
  • "greedy": Todos los gestos táctiles y eventos de desplazamiento lateral o zoom en el mapa.
  • "none": El mapa no se puede desplazar ni acercar con gestos del usuario.
  • "auto": (predeterminado) El control de gestos es cooperativo o codicioso, según si la página se puede desplazar o si está en un iframe.
heading optional
Tipo:  number optional
Es el rumbo de las imágenes aéreas en grados medidos en el sentido de las manecillas del reloj desde el punto cardinal norte. Los rumbos se ajustan al ángulo disponible más cercano para el que hay imágenes disponibles.
headingInteractionEnabled optional
Tipo:  boolean optional
La configuración predeterminada es false.
Indica si el mapa debe permitir que el usuario controle la orientación de la cámara (rotación). Esta opción solo se aplica cuando el mapa es de vectores. Si no se establece en el código, se usará la configuración de Cloud para el ID de mapa (si está disponible).
internalUsageAttributionIds optional
Tipo:  Iterable<string> optional
La configuración predeterminada es null.
Agrega un ID de atribución de uso al inicializador, lo que ayuda a Google a comprender qué bibliotecas y muestras son útiles para los desarrolladores, como el uso de una biblioteca de agrupamiento de marcadores en clústeres. Para inhabilitar el envío del ID de atribución de uso, puedes borrar esta propiedad o reemplazar el valor por una cadena vacía. Solo se enviarán valores únicos. Es posible que se ignoren los cambios que se realicen en este valor después de la creación de una instancia.
isFractionalZoomEnabled optional
Tipo:  boolean optional
Predeterminado: true para mapas de vectores y false para mapas de trama
Indica si el mapa debe permitir niveles de zoom fraccionarios. Escucha isfractionalzoomenabled_changed para saber cuándo se estableció el valor predeterminado.
keyboardShortcuts optional
Tipo:  boolean optional
Si es false, impide que el mapa se controle con el teclado. Las combinaciones de teclas están habilitadas de forma predeterminada.
mapId optional
Tipo:  string optional
Es el ID de mapa del mapa. Este parámetro no se puede establecer ni cambiar después de que se crea una instancia del mapa. Map.DEMO_MAP_ID se puede usar para probar funciones que requieren un ID de mapa, pero que no requieren la habilitación de Cloud.
mapTypeControl optional
Tipo:  boolean optional
Es el estado inicial (habilitado o inhabilitado) del control de tipo de mapa.
mapTypeControlOptions optional
Tipo:  MapTypeControlOptions optional
Son las opciones de visualización iniciales para el control de tipo de mapa.
mapTypeId optional
Tipo:  MapTypeId|string optional
Es el mapTypeId inicial del mapa. La configuración predeterminada es ROADMAP.
maxZoom optional
Tipo:  number optional
Es el nivel de zoom máximo que se mostrará en el mapa. Si se omite o se establece en null, se usa el zoom máximo del tipo de mapa actual. Los valores de zoom válidos son números desde cero hasta el nivel de zoom máximo admitido.
minZoom optional
Tipo:  number optional
Es el nivel de zoom mínimo que se mostrará en el mapa. Si se omite o se establece en null, se usa el zoom mínimo del tipo de mapa actual. Los valores de zoom válidos son números desde cero hasta el nivel de zoom máximo admitido.
noClear optional
Tipo:  boolean optional
Si es true, no borres el contenido del div del mapa.
panControl optional
Tipo:  boolean optional
Es el estado habilitado o inhabilitado del control de desplazamiento.

panControlOptions optional
Tipo:  PanControlOptions optional
Son las opciones de visualización del control de desplazamiento lateral.

renderingType optional
Tipo:  RenderingType optional
La configuración predeterminada es RenderingType.RASTER.
Indica si el mapa debe ser de trama o de vectores. Este parámetro no se puede establecer ni cambiar después de que se crea una instancia del mapa. Si no se establece, la configuración de Cloud para el ID de mapa determinará el tipo de renderización (si está disponible). Ten en cuenta que es posible que los mapas de vectores no estén disponibles para todos los dispositivos y navegadores, y que el mapa recurra a un mapa de trama según sea necesario.
restriction optional
Tipo:  MapRestriction optional
Define un límite que restringe el área del mapa a la que pueden acceder los usuarios. Cuando se establece, el usuario solo puede desplazarse lateralmente y hacer zoom mientras la vista de la cámara permanece dentro de los límites.
rotateControl optional
Tipo:  boolean optional
Es el estado habilitado o inhabilitado del control de rotación.
rotateControlOptions optional
Tipo:  RotateControlOptions optional
Son las opciones de visualización del control de rotación.
scaleControl optional
Tipo:  boolean optional
Es el estado inicial (habilitado o inhabilitado) del control de escala.
scaleControlOptions optional
Tipo:  ScaleControlOptions optional
Son las opciones de visualización iniciales del control de escala.
scrollwheel optional
Tipo:  boolean optional
Si es false, inhabilita el zoom en el mapa con la rueda del mouse. La rueda de desplazamiento está habilitada de forma predeterminada.

Nota: No se recomienda usar esta propiedad. Para inhabilitar el zoom con la rueda de desplazamiento, puedes usar la propiedad gestureHandling y establecerla en "cooperative" o "none".
streetView optional
Tipo:  StreetViewPanorama optional
Un objeto StreetViewPanorama que se mostrará cuando se suelte el hombrecito naranja de Street View en el mapa. Si no se especifica ninguna panorámica, se mostrará un StreetViewPanorama predeterminado en el div del mapa cuando se suelte el muñeco naranja.
streetViewControl optional
Tipo:  boolean optional
Es el estado inicial (habilitado o inhabilitado) del control del hombrecito naranja de Street View. Este control forma parte de la IU predeterminada y se debe establecer en false cuando se muestra un tipo de mapa en el que no debe aparecer la superposición de rutas de Street View (p.ej., un tipo de mapa que no sea de la Tierra).
streetViewControlOptions optional
Tipo:  StreetViewControlOptions optional
Son las opciones de visualización iniciales para el control del hombrecito naranja de Street View.
styles optional
Tipo:  Array<MapTypeStyle> optional
Son los estilos que se aplicarán a cada uno de los tipos de mapas predeterminados. Ten en cuenta que, para los modos satellite/hybrid y terrain, estos estilos solo se aplicarán a las etiquetas y la geometría. Esta función no está disponible cuando se usa un ID de mapa o cuando se usan mapas de vectores (en su lugar, usa el diseño de mapas basado en Cloud).
tilt optional
Tipo:  number optional
En el caso de los mapas de vectores, establece el ángulo de incidencia del mapa. Los valores permitidos se restringen según el nivel de zoom del mapa. En el caso de los mapas de trama, controla el comportamiento de cambio automático del ángulo de incidencia del mapa. Los únicos valores permitidos son 0 y 45. El valor 0 hace que el mapa siempre use una vista aérea de 0°, independientemente del nivel de zoom y del viewport. El valor 45 hace que el ángulo de inclinación cambie automáticamente a 45 siempre que haya imágenes de 45° disponibles para el nivel de zoom y el viewport actuales, y que vuelva a 0 cuando no haya imágenes de 45° disponibles (este es el comportamiento predeterminado). Las imágenes a 45° solo están disponibles para los tipos de mapas satellite y hybrid, en algunas ubicaciones y en algunos niveles de zoom. Nota: getTilt devuelve el ángulo de inclinación actual, no el valor especificado por esta opción. Debido a que getTilt y esta opción se refieren a cosas diferentes, no bind() la propiedad tilt, ya que esto puede producir efectos impredecibles.
tiltInteractionEnabled optional
Tipo:  boolean optional
La configuración predeterminada es false.
Indica si el mapa debe permitir que el usuario controle la inclinación de la cámara. Esta opción solo se aplica cuando el mapa es de vectores. Si no se establece en el código, se usará la configuración de Cloud para el ID de mapa (si está disponible).
zoom optional
Tipo:  number optional
Es el nivel de zoom inicial del mapa. Los valores de zoom válidos son números desde cero hasta el nivel de zoom máximo admitido. Los valores de zoom más altos corresponden a una resolución más alta.
zoomControl optional
Tipo:  boolean optional
Es el estado habilitado o inhabilitado del control de zoom.
zoomControlOptions optional
Tipo:  ZoomControlOptions optional
Son las opciones de visualización del control de zoom.

Interfaz MapTypeStyle

Interfaz google.maps.MapTypeStyle

El MapTypeStyle es una colección de selectores y estilizadores que definen cómo se debe aplicar el diseño al mapa. Los selectores especifican los componentes o elementos del mapa que se deben ver afectados, y los parámetros de diseño especifican cómo se deben modificar esos componentes y elementos. Para obtener más detalles, consulta la referencia de diseño.
stylers
Tipo:  Array<Object>
Son las reglas de diseño que se aplicarán a los componentes y elementos de mapa seleccionados. Las reglas se aplican en el orden que especifiques en este array. Para obtener lineamientos sobre el uso y los valores permitidos, consulta la referencia de diseño.
elementType optional
Tipo:  string optional
Es el elemento al que se debe aplicar un estilo. Un elemento es un aspecto visual de un componente del mapa. Por ejemplo, una etiqueta, un ícono, el trazo o el relleno aplicados a la geometría, entre otros. Opcional. Si no se especifica elementType, se supone que el valor es 'all'. Para obtener detalles sobre el uso y los valores permitidos, consulta la referencia de diseño.
featureType optional
Tipo:  string optional
Es el componente o grupo de componentes al que se debe aplicar un parámetro de diseño. Opcional. Si no se especifica featureType, se supone que el valor es 'all'. Para obtener detalles sobre el uso y los valores permitidos, consulta la referencia de diseño.

Interfaz MapMouseEvent

Interfaz google.maps.MapMouseEvent

Este objeto se muestra a partir de varios eventos de mouse en el mapa y las superposiciones, y contiene todos los campos que se muestran a continuación.
domEvent
Es el evento nativo del DOM correspondiente. Los desarrolladores no deben depender de que las propiedades target, currentTarget, relatedTarget y path estén definidas y sean coherentes. Los desarrolladores tampoco deben depender de la estructura del DOM de la implementación interna de la API de Maps. Debido a la asignación de eventos internos, el domEvent puede tener una semántica diferente de la del MapMouseEvent (p.ej., un "clic" de MapMouseEvent puede tener un domEvent de tipo KeyboardEvent).
latLng optional
Tipo:  LatLng optional
La latitud y longitud que estaban debajo del cursor cuando ocurrió el evento.
stop
stop()
Parámetros: Ninguno
Valor de retorno:  void
Evita que este evento se propague más.

Interfaz IconMouseEvent

Interfaz google.maps.IconMouseEvent

Este objeto se envía en un evento cuando un usuario hace clic en un ícono del mapa. El ID de lugar de este lugar se almacena en el miembro placeId. Para evitar que se muestre la ventana de información predeterminada, llama al método stop() en este evento para evitar que se propague. Obtén más información sobre los IDs de lugar en la guía para desarrolladores de la API de Places.

Esta interfaz extiende MapMouseEvent.

placeId optional
Tipo:  string optional
Es el ID de lugar en el que se hizo clic. Este ID de lugar se puede usar para consultar más información sobre el elemento en el que se hizo clic.

Obtén más información sobre los IDs de lugar en la guía para desarrolladores de la API de Places.
Heredado: domEvent, latLng
Heredado: stop

Constantes de ColorScheme

Constantes de google.maps.ColorScheme

Identificadores de los esquemas de colores del mapa. Especifica estos valores por valor o con el nombre de la constante. Por ejemplo, 'FOLLOW_SYSTEM' o google.maps.ColorScheme.FOLLOW_SYSTEM.

Para acceder, llama al const {ColorScheme} = await google.maps.importLibrary("core").
Consulta Bibliotecas de la API de Maps JavaScript.
DARK Esquema de colores oscuros para un mapa.
FOLLOW_SYSTEM El esquema de colores se selecciona según las preferencias del sistema, que se verifican una vez en el momento de la ejecución del método.
LIGHT Esquema de colores claros para un mapa. Es el valor predeterminado para la API de Maps JS heredada.

Constantes de MapTypeId

Constantes de google.maps.MapTypeId

Identificadores para MapTypes comunes. Especifica estos valores por valor o con el nombre de la constante. Por ejemplo, 'satellite' o google.maps.MapTypeId.SATELLITE.

Para acceder, llama al const {MapTypeId} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.
HYBRID Este tipo de mapa muestra una capa transparente de las calles principales sobre las imágenes satelitales.
ROADMAP Este tipo de mapa muestra un mapa de ruta normal.
SATELLITE Este tipo de mapa muestra imágenes satelitales.
TERRAIN Este tipo de mapa muestra mapas con características físicas, como el terreno y la vegetación.

Clase MapTypeRegistry

Clase google.maps.MapTypeRegistry

Es un registro para las instancias de MapType, con clave por ID de MapType.

Esta clase extiende MVCObject.

Para acceder, llama al const {MapTypeRegistry} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.
MapTypeRegistry
MapTypeRegistry()
Parámetros: Ninguno
El objeto MapTypeRegistry contiene la colección de tipos de mapas personalizados disponibles para que el mapa los use. La API consulta este registro cuando proporciona la lista de tipos de mapas disponibles en los controles, por ejemplo.
set
set(id, mapType)
Parámetros: 
  • id:  string Identificador del MapType que se agregará al registro.
  • mapType: Es el MapType|?objeto MapType que se agregará al registro.
Valor de retorno: Ninguno
Establece el registro para asociar el identificador de cadena pasado con el MapType pasado.
Heredados: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interfaz MapRestriction

Interfaz google.maps.MapRestriction

Es una restricción que se puede aplicar al mapa. El viewport del mapa no excederá estas restricciones.
latLngBounds
Cuando se establece, un usuario solo puede desplazarse y hacer zoom dentro de los límites dados. Los límites pueden restringir tanto la longitud como la latitud, o solo la latitud. Para los límites de solo latitud, usa las longitudes oeste y este de -180 y 180, respectivamente, por ejemplo, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional
Tipo:  boolean optional
Los límites se pueden hacer más restrictivos si se establece la marca strictBounds en true. Esto reduce el nivel de alejamiento que puede aplicar un usuario, lo que garantiza que todo lo que esté fuera de los límites restringidos permanezca oculto. El valor predeterminado es false, lo que significa que un usuario puede alejar la vista hasta que se vea toda el área delimitada, lo que posiblemente incluya áreas fuera de ella.

Clase TrafficLayer

Clase google.maps.TrafficLayer

Una capa de tráfico

Esta clase extiende MVCObject.

Para acceder, llama al const {TrafficLayer} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.
TrafficLayer
TrafficLayer([opts])
Parámetros: 
Es una capa que muestra el tráfico actual en las rutas.
getMap
getMap()
Parámetros: Ninguno
Valor de retorno:  Map|null
Devuelve el mapa en el que se muestra esta capa.
setMap
setMap(map)
Parámetros: 
  • map:  Map optional
Valor de retorno: Ninguno
Renderiza la capa en el mapa especificado. Si el mapa se establece en null, se quitará la capa.
setOptions
setOptions(options)
Parámetros: 
Valor de retorno: Ninguno
Heredados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaz TrafficLayerOptions

Interfaz google.maps.TrafficLayerOptions

Es el objeto TrafficLayerOptions que se usa para definir las propiedades que se pueden establecer en un TrafficLayer.
autoRefresh optional
Tipo:  boolean optional
La configuración predeterminada es true.
Indica si la capa de tráfico se actualiza automáticamente con información actualizada.
map optional
Tipo:  Map optional
Es el mapa en el que se mostrará la capa de tráfico.

Clase TransitLayer

Clase google.maps.TransitLayer

Una capa de transporte público

Esta clase extiende MVCObject.

Para acceder, llama al const {TransitLayer} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.
TransitLayer
TransitLayer()
Parámetros: Ninguno
Es una capa que muestra líneas de transporte público.
getMap
getMap()
Parámetros: Ninguno
Valor de retorno:  Map|null
Devuelve el mapa en el que se muestra esta capa.
setMap
setMap(map)
Parámetros: 
  • map:  Map optional
Valor de retorno:  void
Renderiza la capa en el mapa especificado. Si el mapa se establece en null, se quitará la capa.
Heredados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Clase BicyclingLayer

Clase google.maps.BicyclingLayer

Es una capa que muestra las ciclovías y las rutas para bicicletas.

Esta clase extiende MVCObject.

Para acceder, llama al const {BicyclingLayer} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.
BicyclingLayer
BicyclingLayer()
Parámetros: Ninguno
Es una capa que muestra ciclovías y rutas, y oculta las rutas grandes.
getMap
getMap()
Parámetros: Ninguno
Valor de retorno:  Map|null
Devuelve el mapa en el que se muestra esta capa.
setMap
setMap(map)
Parámetros: 
  • map:  Map optional
Valor de retorno:  void
Renderiza la capa en el mapa especificado. Si el mapa se establece en null, se quitará la capa.
Heredados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfaz CameraOptions

Interfaz google.maps.CameraOptions

Se usa para establecer las opciones de la cámara del mapa.
center optional
Tipo:  LatLngLiteral|LatLng optional
heading optional
Tipo:  number optional
tilt optional
Tipo:  number optional
zoom optional
Tipo:  number optional

Interfaz VisibleRegion

Interfaz google.maps.VisibleRegion

Contiene los cuatro puntos que definen el polígono de cuatro lados que es la región visible del mapa. En un mapa de vectores, este polígono puede ser un trapezoide en lugar de un rectángulo, cuando el mapa de vectores tiene inclinación.
farLeft
Tipo:  LatLng
farRight
Tipo:  LatLng
latLngBounds
Tipo:  LatLngBounds
Es el cuadro delimitador más pequeño que incluye la región visible.
nearLeft
Tipo:  LatLng
nearRight
Tipo:  LatLng

Constantes de RenderingType

Constantes de google.maps.RenderingType

Para acceder, llama al const {RenderingType} = await google.maps.importLibrary("maps").
Consulta Bibliotecas de la API de Maps JavaScript.
RASTER Indica que el mapa es de trama.
UNINITIALIZED Indica que aún se desconoce si el mapa es vectorial o de trama, ya que aún no se terminó de inicializar.
VECTOR Indica que el mapa es de vectores.

Interfaz MapCapabilities

Interfaz google.maps.MapCapabilities

Es un objeto que contiene una instantánea de las funciones que están disponibles actualmente para el mapa. Ten en cuenta que esto no significa necesariamente que se carguen o inicialicen los módulos pertinentes, sino que el mapa actual tiene permiso para usar estas APIs. Consulta las propiedades para obtener una lista de las capacidades posibles.
isAdvancedMarkersAvailable optional
Tipo:  boolean optional
Si es verdadero, este mapa está configurado correctamente para permitir el uso de marcadores avanzados. Ten en cuenta que, de todos modos, debes importar la biblioteca de marker para usar los marcadores avanzados. Consulta https://goo.gle/gmp-isAdvancedMarkersAvailable para obtener más información.
isDataDrivenStylingAvailable optional
Tipo:  boolean optional
Si es verdadero, este mapa está configurado correctamente para permitir el uso del diseño basado en datos en, al menos, un FeatureLayer. Consulta https://goo.gle/gmp-data-driven-styling y https://goo.gle/gmp-FeatureLayerIsAvailable para obtener más información.
isWebGLOverlayViewAvailable optional
Tipo:  boolean optional
Si es verdadero, este mapa está configurado correctamente para permitir el uso de WebGLOverlayView.