Maps

Clase Map

Clase google.maps.Map

Esta clase extiende MVCObject.

Llama al const {Map} = await google.maps.importLibrary("maps") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Map
Map(mapDiv[, opts])
Parámetros: 
  • mapDiv:  HTMLElement El mapa se renderizará para llenar este elemento.
  • opts:  MapOptions optional Opciones
Crea un mapa nuevo dentro del contenedor HTML determinado, que suele ser un elemento DIV.
DEMO_MAP_ID Es el 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 utilizar para funciones que requieren configuración en la nube (como el diseño basado en Cloud).
controls
Controles adicionales para adjuntar 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 los tipos de mapas adicionales que se pueden 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 Padding en píxeles. Los límites se ajustarán en la parte del mapa que quede después de quitar el padding. Un valor numérico generará el mismo relleno 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 determinados.
Nota: Cuando el mapa se establece en display: none, la función fitBounds lee el tamaño del mapa como 0 x 0 y, por lo tanto, no hace nada. Para cambiar el viewport mientras el mapa está oculto, configúralo en visibility: hidden, lo que garantiza que el div del mapa tenga un tamaño real. En el caso de los mapas vectoriales, 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 provocar 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 devolución:  LatLngBounds|undefined Son los límites de latitud y longitud del viewport actual.
Devuelve los límites de latitud y longitud del viewport actual. Si se ve más de una copia del mundo, el rango de límites en longitud va de -180 a 180 grados inclusive. Si el mapa aún no se inicializó o no se configuraron el centro y el zoom, el resultado es undefined. En el caso de los mapas vectoriales con una inclinación o un 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 devolución:  LatLng|undefined
Devuelve la posición que se muestra en el centro del mapa. Ten en cuenta que este objeto LatLng no está encapsulado. Consulta LatLng para obtener más información. Si no se establecieron el centro o los límites, el resultado es undefined.
getClickableIcons
getClickableIcons()
Parámetros: Ninguno
Valor de devolución:  boolean|undefined
Devuelve la capacidad 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 devolución:  FeatureLayer
Devuelve el FeatureLayer para el datasetId especificado. Los IDs de los conjuntos de datos deben configurarse en la consola de Google Cloud. Si el ID del conjunto de datos no está asociado con el diseño del mapa o si el diseño basado en datos no está disponible (no hay ID de mapa, ni mosaicos vectoriales, ni capas de componentes de diseño basado en datos, ni conjuntos de datos configurados en el diseño del mapa), se registrará un error y el FeatureLayer.isAvailable resultante será falso.
getDiv
getDiv()
Parámetros: Ninguno
Valor de devolución:  HTMLElement El mapDiv del mapa.
getFeatureLayer
getFeatureLayer(featureType)
Parámetros: 
Valor de devolución:  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 ID de mapa, no hay mosaicos vectoriales y no hay FeatureLayer habilitado en el diseño del mapa), se registrará un error y el FeatureLayer.isAvailable resultante será falso.
getHeading
getHeading()
Parámetros: Ninguno
Valor de devolución:  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) a partir de la dirección cardinal norte. Si el mapa aún no se inicializó, el resultado es undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
Parámetros: Ninguno
Valor de devolución:  boolean|null
Devuelve 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 configura en el código, se usará la configuración de la nube para el ID del mapa (si está disponible).
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
Parámetros: Ninguno
Valor de devolución:  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 devolución:  MapCapabilities
Informa al llamador sobre las capacidades actuales disponibles para el mapa según el ID de mapa proporcionado.
getMapTypeId
getMapTypeId()
Parámetros: Ninguno
Valor de devolución:  MapTypeId|string|undefined
getProjection
getProjection()
Parámetros: Ninguno
Valor de devolución:  Projection|undefined
Devuelve el Projection actual. Si el mapa aún no se inicializó, el resultado es undefined. Detecta el evento projection_changed y verifica su valor para asegurarte de que no sea undefined.
getRenderingType
getRenderingType()
Parámetros: Ninguno
Valor de devolución:  RenderingType
Devuelve el RenderingType actual del mapa.
getStreetView
getStreetView()
Parámetros: Ninguno
Valor de devolución:  StreetViewPanorama Es el panorama vinculado al mapa.
Devuelve el 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 devolución:  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 a 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 devolución:  boolean|null
Devuelve un valor que indica si las interacciones de inclinación están habilitadas. Esta opción solo tiene efecto cuando el mapa es un mapa de vectores. Si no se configura en el código, se usará la configuración de la nube para el ID del mapa (si está disponible).
getZoom
getZoom()
Parámetros: Ninguno
Valor de devolución:  number|undefined
Devuelve el nivel de zoom del mapa. Si no se configuró 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 Cantidad de píxeles para mover el mapa en la dirección X.
  • y:  number Cantidad de píxeles para mover el mapa en la dirección Y.
Valor de retorno: Ninguno
Cambia el centro del mapa según la distancia determinada 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 determinado. Si el cambio es menor que el ancho y el alto del mapa, la transición se animará de forma fluida.
panToBounds
panToBounds(latLngBounds[, padding])
Parámetros: 
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral Los límites a los que se desplazará el mapa.
  • padding:  number|Padding optional Padding en píxeles. Un valor numérico generará el mismo relleno en los 4 lados. El valor predeterminado es 0.
Valor de retorno: Ninguno
Desplaza el mapa la cantidad mínima necesaria para contener 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 cantidad 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 el encabezado 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. Un ícono de mapa representa un lugar de interés, también conocido como POI. Para inhabilitar la capacidad 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 a partir de la dirección cardinal norte. En el caso de los mapas de ráster, 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 las interacciones de encabezado están habilitadas. Esta opción solo tiene efecto cuando el mapa es un mapa de vectores. Si no se configura en el código, se usará la configuración de la nube para el ID del 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 valor de RenderingType actual del mapa.
setStreetView
setStreetView(panorama)
Parámetros: 
Valor de retorno: Ninguno
Vincula un StreetViewPanorama al mapa. Este panorama anula el StreetViewPanorama predeterminado, lo que permite que el mapa se vincule a un panorama externo fuera del mapa. Si configuras el panorama en null, se volverá a vincular el panorama integrado predeterminado al mapa.
setTilt
setTilt(tilt)
Parámetros: 
  • tilt:  number
Valor de retorno: Ninguno
Para los mapas de vectores, establece el ángulo de incidencia del mapa. Los valores permitidos están restringidos según el nivel de zoom del mapa.

Para 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. setTilt(0) hace que el mapa siempre use una vista aérea de 0° sin importar el nivel de zoom ni el viewport. setTilt(45) hace que el ángulo de inclinación cambie automáticamente a 45 cuando hay imágenes a 45° disponibles para el nivel de zoom y la ventana gráfica actuales, y que vuelva a 0 cuando no hay imágenes a 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 diferentes elementos, no bind() la propiedad tilt, ya que esto puede generar 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 tiene efecto cuando el mapa es un mapa de vectores. Si no se configura en el código, se usará la configuración de la nube para el ID del mapa (si está disponible).
setZoom
setZoom(zoom)
Parámetros: 
  • zoom:  number Los valores de zoom más grandes corresponden a una resolución más alta.
Valor de retorno: Ninguno
Establece el zoom del mapa.
Heredado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
Argumentos: Ninguno
Este evento se activa cuando cambian los límites de la ventana gráfica.