3D Maps

Clase Map3DElement

Clase google.maps.maps3d.Map3DElement

Map3DElement es una interfaz HTML para la vista de mapa en 3D.

Elemento personalizado:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" range="number" roll="number" tilt="number"></gmp-map-3d>

Esta clase extiende HTMLElement.

Esta clase implementa Map3DElementOptions.

Llama al const {Map3DElement} = await google.maps.importLibrary("maps3d") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Map3DElement
Map3DElement([options])
Parámetros: 
bounds
Cuando se establece, restringe la posición de la cámara dentro de los límites de latitud y longitud especificados. Ten en cuenta que los objetos fuera de los límites se renderizan de todas formas. Los límites pueden restringir la longitud y la latitud, o bien solo la latitud o la longitud. Para los límites solo de latitud, usa las longitudes oeste y este de -180 y 180, respectivamente. Para los límites que solo incluyen la longitud, usa las latitudes norte y sur de 90 y -90, respectivamente.
center
Es el centro del mapa, que se proporciona como un objeto LatLngAltitude, en el que la altitud se expresa en metros sobre el nivel del suelo. Ten en cuenta que no necesariamente es la ubicación de la cámara, ya que el campo range afecta la distancia de la cámara desde el centro del mapa. Si no se establece, el valor predeterminado es {lat: 0, lng: 0, altitude: 63170000}. 63170000 metros es la altitud máxima permitida (radio de la Tierra multiplicado por 10).
Atributo HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled
Tipo:  boolean optional
Predeterminado: false
Cuando es true, no se renderizan las etiquetas predeterminadas del mapa.
Atributo HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
Tipo:  boolean optional
Predeterminado: false
Cuando es true, se inhabilitan todos los botones de la IU predeterminada. No inhabilita el teclado ni los controles por gestos.
Atributo HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Tipo:  number optional
Orientación de la brújula del mapa, en grados, donde el norte geográfico es cero. Cuando no hay inclinación, cualquier giro se interpretará como rumbo.
Atributo HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
Tipo:  number optional
Es la altitud máxima sobre el nivel del suelo que se mostrará en el mapa. Un valor válido está entre 0 y 63170000 metros (el radio de la Tierra multiplicado por 10).
Atributo HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
Tipo:  number optional
Es el ángulo máximo de orientación (rotación) del mapa. Un valor válido está entre 0 y 360 grados. minHeading y maxHeading representan un intervalo de <= 360 grados en el que se permitirán los gestos de rumbo. minHeading = 180 y maxHeading = 90 permitirán el encabezado en [0, 90] y el encabezado en [180, 360]. minHeading = 90 y maxHeading = 180 permitirán el encabezado en [90, 180].
Atributo HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
Tipo:  number optional
Es el ángulo de incidencia máximo del mapa. Un valor válido está entre 0 y 90 grados.
Atributo HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
Tipo:  number optional
Es la altitud mínima sobre el nivel del suelo que se mostrará en el mapa. Un valor válido está entre 0 y 63170000 metros (el radio de la Tierra multiplicado por 10).
Atributo HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Tipo:  number optional
Es el ángulo mínimo de orientación (rotación) del mapa. Un valor válido está entre 0 y 360 grados. minHeading y maxHeading representan un intervalo de <= 360 grados en el que se permitirán los gestos de rumbo. minHeading = 180 y maxHeading = 90 permitirán el encabezado en [0, 90] y el encabezado en [180, 360]. minHeading = 90 y maxHeading = 180 permitirán el encabezado en [90, 180].
Atributo HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Tipo:  number optional
Es el ángulo de incidencia mínimo del mapa. Un valor válido está entre 0 y 90 grados.
Atributo HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
range
Tipo:  number optional
Es la distancia desde la cámara hasta el centro del mapa, en metros.
Atributo HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
Tipo:  number optional
Es el ángulo de la cámara alrededor del vector de visualización en grados. Para resolver ambigüedades, cuando no hay inclinación, cualquier giro se interpretará como rumbo.
Atributo HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
Tipo:  number optional
Es la inclinación del vector de vista de la cámara en grados. Un vector de vista que mira directamente hacia la Tierra tendría una inclinación de cero grados. Un vector de vista que apunta en dirección opuesta a la Tierra tendría una inclinación de 180 grados.
Atributo HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • type:  string Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listener:  EventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • options:  boolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
flyCameraAround
flyCameraAround(options)
Parámetros: 
Valor de retorno: Ninguno
Este método hace que la cámara orbite alrededor de una ubicación determinada durante un período específico, y que realice la cantidad de vueltas indicada en ese tiempo.

De forma predeterminada, la cámara orbita en sentido horario. Si se proporciona un número negativo para las órbitas, la cámara orbitará en sentido contrario a las agujas del reloj.

El método es asíncrono porque las animaciones solo pueden comenzar después de que el mapa se haya cargado en una cantidad mínima. El método se devuelve una vez que se inicia la animación.

Si la cantidad de giros es cero, no se producirá ningún giro y la animación se completará inmediatamente después de que comience.
flyCameraTo
flyCameraTo(options)
Parámetros: 
Valor de retorno: Ninguno
Este método mueve la cámara de forma parabólica desde la ubicación actual hasta una ubicación final determinada durante un período determinado.

El método es asíncrono porque las animaciones solo pueden comenzar después de que el mapa se haya cargado en una cantidad mínima. El método se devuelve una vez que se inicia la animación.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • type:  string Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listener:  EventListener|EventListenerObject 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 devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.
stopCameraAnimation
stopCameraAnimation()
Parámetros: Ninguno
Valor de retorno: Ninguno
Este método detiene cualquier animación de vuelo que se esté ejecutando. La cámara permanece donde está a mitad de la animación; no se teletransporta al punto final.

El método es asíncrono porque las animaciones solo pueden iniciarse o detenerse después de que el mapa haya cargado una cantidad mínima. El método se devuelve una vez que se detiene la animación.
gmp-animationend
function(animationEndEvent)
Argumentos: 
  • animationEndEvent:  Event
Este evento se activa cuando finaliza la animación de vuelo. Este evento se propaga hacia arriba a través del árbol del DOM.
gmp-centerchange
function(centerChangeEvent)
Argumentos: 
  • centerChangeEvent:  Event
Este evento se activa cuando cambia la propiedad center del objeto Map3DElement.
gmp-click
function(clickEvent)
Argumentos: 
Este evento se activa cuando se hace clic en el elemento Map3DElement.
gmp-headingchange
function(headingChangeEvent)
Argumentos: 
  • headingChangeEvent:  Event
Este evento se activa cuando cambia la propiedad de encabezado de Map3DElement.
gmp-rangechange
function(rangeChangeEvent)
Argumentos: 
  • rangeChangeEvent:  Event
Este evento se activa cuando cambia la propiedad range de Map3DElement.
gmp-rollchange
function(rollChangeEvent)
Argumentos: 
  • rollChangeEvent:  Event
Este evento se activa cuando cambia la propiedad de rotación de Map3DElement.
gmp-steadychange
function(steadyChangeEvent)
Argumentos: 
Este evento se activa cuando cambia el estado estable de Map3DElement.
gmp-tiltchange
function(tiltChangeEvent)
Argumentos: 
  • tiltChangeEvent:  Event
Este evento se activa cuando cambia la propiedad de inclinación de Map3DElement.

Interfaz de Map3DElementOptions

Interfaz de google.maps.maps3d.Map3DElementOptions

Objeto Map3DElementOptions que se usa para definir las propiedades que se pueden establecer en un Map3DElement.
bounds optional
Consulta los Map3DElement.bounds.
center optional
Consulta los Map3DElement.center.
defaultLabelsDisabled optional
Tipo:  boolean optional
Consulta los Map3DElement.defaultLabelsDisabled.
defaultUIDisabled optional
Tipo:  boolean optional
Consulta los Map3DElement.defaultUIDisabled.
heading optional
Tipo:  number optional
Consulta los Map3DElement.heading.
maxAltitude optional
Tipo:  number optional
Consulta los Map3DElement.maxAltitude.
maxHeading optional
Tipo:  number optional
Consulta los Map3DElement.maxHeading.
maxTilt optional
Tipo:  number optional
Consulta los Map3DElement.maxTilt.
minAltitude optional
Tipo:  number optional
Consulta los Map3DElement.minAltitude.
minHeading optional
Tipo:  number optional
Consulta los Map3DElement.minHeading.
minTilt optional
Tipo:  number optional
Consulta los Map3DElement.minTilt.
range optional
Tipo:  number optional
Consulta los Map3DElement.range.
roll optional
Tipo:  number optional
Consulta los Map3DElement.roll.
tilt optional
Tipo:  number optional
Consulta los Map3DElement.tilt.

Interfaz FlyAroundAnimationOptions

Interfaz de google.maps.maps3d.FlyAroundAnimationOptions

Son las opciones de personalización de la animación FlyCameraAround.
camera
Es el punto central al que debe mirar la cámara durante la animación de órbita. Ten en cuenta que la orientación del mapa cambiará a medida que la cámara orbite alrededor de este punto central.
durationMillis optional
Tipo:  number optional
Es la duración de la animación, expresada en milisegundos. Esta es la duración total de la animación, no la duración de una sola rotación.
rounds optional
Tipo:  number optional
Es la cantidad de giros alrededor del centro en la duración determinada. Esto controla la velocidad general de rotación. Si pasas un número negativo a la función de redondeo, la cámara rotará en el sentido contrario a las manecillas del reloj en lugar de en el sentido predeterminado.

Interfaz FlyToAnimationOptions

Interfaz de google.maps.maps3d.FlyToAnimationOptions

Son las opciones de personalización de la animación FlyCameraTo.
endCamera
Es la ubicación a la que debe apuntar la cámara al final de la animación.
durationMillis optional
Tipo:  number optional
Es la duración de la animación, expresada en milisegundos. Una duración de 0 teletransportará la cámara directamente a la posición final.

Interfaz CameraOptions

Interfaz de google.maps.maps3d.CameraOptions

Objeto CameraOptions que se usa para definir las propiedades que se pueden establecer en un objeto de cámara. El objeto de cámara puede ser cualquier elemento que tenga una posición de cámara, p.ej., el estado actual del mapa o un estado de animación solicitado en el futuro.
center optional
Consulta los Map3DElement.center.
heading optional
Tipo:  number optional
Consulta los Map3DElement.heading.
range optional
Tipo:  number optional
Consulta los Map3DElement.range.
roll optional
Tipo:  number optional
Consulta los Map3DElement.roll.
tilt optional
Tipo:  number optional
Consulta los Map3DElement.tilt.

Clase SteadyChangeEvent

Clase google.maps.maps3d.SteadyChangeEvent

Este evento se crea a partir de la supervisión de un estado estable de Map3DElement. Este evento se propaga hacia arriba a través del árbol del DOM.

Esta clase extiende Event.

Llama al const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
isSteady
Tipo:  boolean
Indica si Map3DElement está estable (es decir, si se completó toda la renderización de la escena actual) o no.

Clase LocationClickEvent

Clase google.maps.maps3d.LocationClickEvent

Este evento se crea cuando se hace clic en un Map3DElement.

Esta clase extiende Event.

Llama al const {LocationClickEvent} = await google.maps.importLibrary("maps3d") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
position
Tipo:  LatLngAltitude optional
Latitud, longitud y altitud que se encontraban debajo del cursor cuando ocurrió el evento. Ten en cuenta que, en los niveles más generales, se devolverán datos menos precisos. Además, es posible que se muestre la elevación del fondo marino como valor de altitud cuando se hace clic en la superficie del agua desde posiciones de cámara más altas. Este evento se propaga hacia arriba a través del árbol del DOM.

Clase PlaceClickEvent

Clase google.maps.maps3d.PlaceClickEvent

Este evento se crea cuando se hace clic en un Map3DElement.

Esta clase extiende LocationClickEvent.

Llama al const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
placeId
Tipo:  string
Es el ID de lugar de la función del mapa.
Heredado: position
fetchPlace
fetchPlace()
Parámetros: Ninguno
Valor de devolución:  Promise<Place>
Recupera un objeto Place para este ID de lugar. En el objeto Place resultante, se propagará la propiedad id. Posteriormente, se pueden solicitar campos adicionales a través de Place.fetchFields(), sujeto a la habilitación y facturación normales de la API de Places. La promesa se rechaza si se produjo un error al recuperar el Place.

Clase Marker3DElement

Clase google.maps.maps3d.Marker3DElement

Muestra una posición en un mapa en 3D. Ten en cuenta que se debe establecer el parámetro position para que se muestre el parámetro Marker3DElement.

Elemento personalizado:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" size-preserved z-index="number"></gmp-marker-3d>

Esta clase extiende HTMLElement.

Esta clase implementa Marker3DElementOptions.

Llama al const {Marker3DElement} = await google.maps.importLibrary("maps3d") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Marker3DElement
Marker3DElement([options])
Parámetros: 
Crea un Marker3DElement con las opciones especificadas.
altitudeMode
Tipo:  AltitudeMode optional
Predeterminado: AltitudeMode.CLAMP_TO_GROUND
Especifica cómo se interpreta el componente de altitud de la posición.
Atributo HTML:
  • <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior
Tipo:  CollisionBehavior optional
Predeterminado: CollisionBehavior.REQUIRED
Es una enumeración que especifica cómo debe comportarse un Marker3DElement cuando colisiona con otro Marker3DElement o con las etiquetas del mapa base.
Atributo HTML:
  • <gmp-marker-3d collision-behavior="required"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded
Tipo:  boolean optional
Predeterminado: false
Especifica si este marcador se debe dibujar o no cuando está obstruido. El marcador puede estar obstruido por la geometría del mapa (p.ej., edificios).
Atributo HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Tipo:  boolean optional
Predeterminado: false
Especifica si se debe conectar el marcador al suelo. Para extruir un marcador, altitudeMode debe ser RELATIVE_TO_GROUND o ABSOLUTE.
Atributo HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Tipo:  string optional
Es el texto que mostrará este marcador.
Atributo HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
Ubicación de la punta del marcador. La altitud se ignora en ciertos modos y, por lo tanto, es opcional.
sizePreserved
Tipo:  boolean optional
Predeterminado: false
Especifica si este marcador debe conservar su tamaño o no, independientemente de la distancia de la cámara. De forma predeterminada, el marcador se ajusta según la distancia de la cámara o la inclinación.
Atributo HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Tipo:  number optional
Es el índice Z en comparación con otros marcadores.
Atributo HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Se insertarán todos los elementos personalizados que se agreguen directamente a Marker3DElement. Sin embargo, solo se usarán los elementos de los tipos HTMLImageElement, SVGElement y PinElement para dibujar marcadores. Se ignorarán los demás elementos.
, HTMLImageElement y SVGElement deben estar envueltos en el elemento <template> antes de asignarse a la ranura predeterminada de Marker3DElement.

Actualmente, las imágenes y los SVG se rasterizan antes de renderizarse en la escena 3D, por lo que no se aplicará el código HTML personalizado incorporado en SVG ni las clases CSS agregadas a las imágenes, y es posible que no se reflejen cuando se muestren marcadores en la pantalla.
BetaaddEventListener
addEventListener(type, listener[, options])
Parámetros: 
  • type:  string Cadena que distingue mayúsculas de minúsculas y que representa el tipo de evento que se debe escuchar.
  • listener:  EventListener|EventListenerObject Es el objeto que recibe una notificación. Debe ser una función o un objeto con el método handleEvent.
  • options:  boolean|AddEventListenerOptions optional Consulta las opciones. Los eventos personalizados solo admiten capture y passive.
Valor de devolución:  void
Configura una función que se llamará cada vez que se envíe el evento especificado al destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • type:  string Cadena que especifica el tipo de evento para el que se quitará un objeto de escucha de eventos.
  • listener:  EventListener|EventListenerObject 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 devolución:  void
Quita del destino un objeto de escucha de eventos registrado previamente con addEventListener. Consulta removeEventListener.

Interfaz Marker3DElementOptions

Interfaz de google.maps.maps3d.Marker3DElementOptions

Objeto Marker3DElementOptions que se usa para definir las propiedades que se pueden establecer en un Marker3DElement.
altitudeMode optional
Tipo:  AltitudeMode optional
Consulta los Marker3DElement.altitudeMode.
collisionBehavior optional
Tipo:  CollisionBehavior optional
Consulta los Marker3DElement.collisionBehavior.
drawsWhenOccluded optional
Tipo:  boolean optional
Consulta los Marker3DElement.drawsWhenOccluded.
extruded optional
Tipo:  boolean optional
Consulta los Marker3DElement.extruded.
label optional
Tipo:  string optional
Consulta los Marker3DElement.label.
position optional
Consulta los Marker3DElement.position.
sizePreserved optional
Tipo:  boolean optional
Consulta los Marker3DElement.sizePreserved.
zIndex optional
Tipo:  number optional
Consulta los Marker3DElement.zIndex.

Clase Marker3DInteractiveElement

Clase google.maps.maps3d.Marker3DInteractiveElement

Muestra una posición en un mapa en 3D. Ten en cuenta que se debe establecer el parámetro position para que se muestre el parámetro Marker3DInteractiveElement. A diferencia de Marker3DElement, Marker3DInteractiveElement recibe un evento gmp-click.

Elemento personalizado:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

Esta clase extiende Marker3DElement.

Esta clase implementa Marker3DInteractiveElementOptions.

Llama al const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d") para acceder.
Consulta Bibliotecas en la API de Maps JavaScript.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Parámetros: 
Crea un Marker3DInteractiveElement con las opciones especificadas.
Heredado: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
Cualquier elemento personalizado que se agregue directamente a