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.

Para acceder, llama a const {Map3DElement} = await google.maps.importLibrary("maps3d"). Consulta Bibliotecas de 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 lat/lng especificados. Ten en cuenta que los objetos fuera de los límites se renderizan de todos modos. Los límites pueden restringir la longitud y la latitud, o solo la latitud y la longitud. Para los límites de solo latitud, usa las longitudes oeste y este de -180 y 180, respectivamente. Para los límites solo de longitud, usa las latitudes norte y sur de 90 y -90, respectivamente.
center
Es el centro del mapa, expresado como LatLngAltitude, donde la altitud se indica en metros sobre el nivel del suelo. Ten en cuenta que no es necesariamente donde se encuentra la cámara, ya que el campo range afecta la distancia de la cámara al 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 de mapa predeterminadas.
Atributo HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
Tipo:  boolean optional
Predeterminado: false
Cuando true, todos los botones predeterminados de la IU están inhabilitados. No inhabilita los controles de gestos ni del teclado.
Atributo HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Tipo:  number optional
Es la orientación de la brújula del mapa, en grados, donde el norte verdadero es cero. Cuando no hay inclinación, cualquier lanzamiento se interpretará como una orientación.
Atributo HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
Tipo:  number optional
La altitud máxima sobre el suelo que se mostrará en el mapa. Un valor válido está entre 0 y 63170000 metros (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 rumbo (rotación) del mapa. Un valor válido está entre 0 y 360 grados. minHeading y maxHeading representan un intervalo de 360 grados o inferior en el que se permitirán los gestos de encabezado. 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 suelo que se mostrará en el mapa. Un valor válido está entre 0 y 63170000 metros (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 rumbo (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 dirección. minHeading = 180 y maxHeading = 90 permitirán la orientación en [0, 90] y la orientación en [180, 360]. minHeading = 90 y maxHeading = 180 permitirán la orientación 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 de la cámara al centro del mapa, expresada en metros.
Atributo HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
Tipo:  number optional
Es el giro de la cámara alrededor del vector de vista en grados. Para resolver ambigüedades, cuando no hay inclinación, cualquier balanceo 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 mire directamente hacia abajo a la Tierra tendría una inclinación de cero grados. Un vector de vista que apunte hacia afuera de 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 Es una cadena que distingue mayúsculas de minúsculas y representa el tipo de evento que se debe detectar.
  • 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 que se muestra:  void
Configura una función a la que se llamará cada vez que se entregue el evento especificado al destino. Consulta addEventListener.
flyCameraAround
flyCameraAround(options)
Parámetros: 
Valor que se muestra:  Ninguno
Este método hace que la cámara orbite alrededor de una ubicación determinada durante un período determinado y realice la cantidad determinada de vueltas en ese tiempo.

De forma predeterminada, la cámara orbita en el sentido de las manecillas del reloj. Si se proporciona un número negativo para las rondas, la cámara orbitará en sentido contrario a las manecillas del reloj.

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

Si la cantidad de rondas es cero, no habrá giros y la animación se completará inmediatamente después de comenzar.
flyCameraTo
flyCameraTo(options)
Parámetros: 
Valor que se muestra:  Ninguno
Este método mueve la cámara de forma parabólica de la ubicación actual a una ubicación final determinada durante una duración determinada.

El método es asíncrono, ya que las animaciones solo pueden iniciarse después de que el mapa haya cargado una cantidad mínima. El método se muestra una vez que se inicia la animación.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • type:  string Es una cadena que especifica el tipo de evento para el que se debe 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 objetivo del evento.
  • options:  boolean|EventListenerOptions optional Ver opciones
Valor que se muestra:  void
Quita del destino un objeto de escucha de eventos registrado anteriormente con addEventListener. Consulta removeEventListener.
stopCameraAnimation
stopCameraAnimation()
Parámetros:  Ninguno
Valor que se muestra: Ninguno
Este método detiene cualquier animación de desplazamiento que pueda estar en ejecución. La cámara permanece donde está en medio de la animación; no se teletransporta al punto final.

El método es asíncrono, ya que las animaciones solo pueden iniciarse o detenerse después de que el mapa cargue una cantidad mínima. El método se muestra 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 desplazamiento. Este evento se propaga a través del árbol del DOM.
gmp-centerchange
function(centerChangeEvent)
Argumentos: 
  • centerChangeEvent:  Event
Este evento se activa cuando cambia la propiedad center de 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 heading de Map3DElement.
gmp-rangechange
function(rangeChangeEvent)
Argumentos: 
  • rangeChangeEvent:  Event
Este evento se activa cuando cambia la propiedad de rango de Map3DElement.
gmp-rollchange
function(rollChangeEvent)
Argumentos: 
  • rollChangeEvent:  Event
Este evento se activa cuando cambia la propiedad de lanzamiento 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 Map3DElementOptions

Interfaz google.maps.maps3d.Map3DElementOptions

Es un 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 opciones de personalización para 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 rondas que se rotarán alrededor del centro en la duración determinada. Esto controla la velocidad general de rotación. Si pasas un número negativo a las rondas, la cámara rotará en el sentido contrario a las manecillas del reloj en lugar de hacerlo en el sentido predeterminado.

Interfaz FlyToAnimationOptions

Interfaz de google.maps.maps3d.FlyToAnimationOptions

Opciones de personalización para la animación FlyCameraTo.
endCamera
Es la ubicación a la que la cámara debe apuntar 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 de CameraOptions

Interfaz de google.maps.maps3d.CameraOptions

CameraOptions utilizado para definir las propiedades que se pueden configurar 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., un estado de mapa actual 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 a través del árbol del DOM.

Esta clase extiende Event.

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

Clase LocationClickEvent

Clase google.maps.maps3d.LocationClickEvent

Este evento se crea haciendo clic en un Map3DElement.

Esta clase extiende Event.

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

PlaceClickEvent

Clase google.maps.maps3d.PlaceClickEvent

Este evento se crea haciendo clic en un Map3DElement.

Esta clase extiende LocationClickEvent.

Para acceder, llama a const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). Consulta Bibliotecas de la API de Maps JavaScript.
placeId
Tipo:  string
Es el ID de lugar del componente del mapa.
Heredado: position
fetchPlace
fetchPlace()
Parámetros:  Ninguno
Valor que se muestra:  Promise<Place>
Recupera un Place para este ID de lugar. En el objeto Place resultante, se propagará la propiedad id. Los campos adicionales se pueden solicitar posteriormente 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 3D. Ten en cuenta que se debe configurar position para que se muestre 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.

Para acceder, llama a const {Marker3DElement} = await google.maps.importLibrary("maps3d"). Consulta Bibliotecas de la API de Maps JavaScript.
Marker3DElement
Marker3DElement([options])
Parámetros: 
Crea un Marker3DElement con las opciones especificadas.
altitudeMode
Tipo:  AltitudeMode optional
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
Valor 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 se debe dibujar o no este marcador cuando está oculto. La geometría del mapa (p.ej., los edificios) puede ocultar el marcador.
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
Es la ubicación de la punta del marcador. En algunos modos, la altitud se ignora 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 en función de 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 zIndex en comparación con otros marcadores.
Atributo HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Se asignará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 unirse en el elemento <template> antes de asignarlos 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 las clases SVG o CSS que se agregaron a las imágenes y es posible que no se reflejen cuando se muestren los marcadores en la pantalla.
BetaaddEventListener
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 detectar.
  • 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 que se muestra:  void
Establece una función a la que se llamará cada vez que se publique el evento especificado en el destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • type:  string Es una cadena que especifica el tipo de evento para el que se debe 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 que se muestra:  void
Quita del destino un objeto de escucha de eventos registrado anteriormente con addEventListener. Consulta removeEventListener.

Marker3DElementOptions.

Interfaz de google.maps.maps3d.Marker3DElementOptions

Es el objeto Marker3DElementOptions que se usa para definir las propiedades que se pueden configurar 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 3D. Ten en cuenta que se debe configurar position para que se muestre 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.

Para acceder, llama a const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). Consulta Bibliotecas de 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
Se asignarán todos los elementos personalizados que se agreguen directamente a Marker3DInteractiveElement. Sin embargo, solo se usarán los elementos del tipo PinElement para dibujar marcadores. Se ignorarán los demás elementos.
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 detectar.
  • 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 que se muestra:  void
Establece una función a la que se llamará cada vez que se publique el evento especificado en el 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 objetivo del evento.
  • options:  boolean|EventListenerOptions optional Consulta las opciones.
Valor que se muestra:  void
Quita del destino un objeto de escucha de eventos registrado anteriormente con addEventListener. Consulta removeEventListener.
gmp-click
function(clickEvent)
Argumentos: 
Este evento se activa cuando se hace clic en el elemento Marker3DInteractiveElement.

Interfaz Marker3DInteractiveElementOptions

Interfaz de google.maps.maps3d.Marker3DInteractiveElementOptions

Objeto Marker3DInteractiveElementOptions que se usa para definir las propiedades que se pueden establecer en un Marker3DInteractiveElement.

Esta interfaz extiende Marker3DElementOptions.

Heredado: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Clase Model3DElement

Clase google.maps.maps3d.Model3DElement

Modelo 3D que permite renderizar modelos glTF. Ten en cuenta que se deben configurar position y src para que se muestre Model3DElement.

Se deben admitir las propiedades principales de la PBR de gITF. Por el momento, no se admiten extensiones ni propiedades de extensión.

Elemento personalizado:
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>

Esta clase extiende HTMLElement.

Esta clase implementa Model3DElementOptions.

Para acceder, llama a const {Model3DElement} = await google.maps.importLibrary("maps3d"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.
Model3DElement
Model3DElement([options])
Parámetros: 
Crea un Model3DElement con las opciones especificadas.
altitudeMode
Tipo:  AltitudeMode optional
Especifica cómo se interpreta la altitud en la posición.
Atributo HTML:
  • <gmp-model-3d altitude-mode="absolute"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation
Describe la rotación del sistema de coordenadas de un modelo 3D para posicionarlo en el mapa 3D.

Las rotaciones se aplican al modelo en el siguiente orden: giro, inclinación y, luego, orientación.
position
Establece la posición de Model3DElement. La altitud se ignora en ciertos modos y, por lo tanto, es opcional.
scale
Tipo:  number|Vector3D|Vector3DLiteral optional
Predeterminado: 1
Escala el modelo a lo largo de los ejes x, y y z en el espacio de coordenadas del modelo.
src
Tipo:  string|URL optional
Especifica la URL del modelo 3D. En este momento, solo se admiten modelos en formato .glb.

Las URLs HTTP relativas se resolverán en las URLs absolutas correspondientes.

Ten en cuenta que si alojas tus archivos de modelo .glb en un sitio web o servidor diferente al de tu aplicación principal, asegúrate de configurar los encabezados HTTP CORS correctos. Esto permite que tu aplicación acceda de forma segura a los archivos del modelo desde el otro dominio.
Atributo HTML:
  • <gmp-model-3d src="src"></gmp-model-3d>
BetaaddEventListener
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 detectar.
  • 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 que se muestra:  void
Establece una función a la que se llamará cada vez que se publique el evento especificado en el destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • type:  string Es una cadena que especifica el tipo de evento para el que se debe 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 objetivo del evento.
  • options:  boolean|EventListenerOptions optional Consulta las opciones.
Valor que se muestra:  void
Quita del destino un objeto de escucha de eventos registrado anteriormente con addEventListener. Consulta removeEventListener.

Model3DElementOptions.

Interfaz de google.maps.maps3d.Model3DElementOptions

El objeto Model3DElementOptions que se usa para definir las propiedades que se pueden configurar en un Model3DElement.
altitudeMode optional
Tipo:  AltitudeMode optional
Consulta los Model3DElement.altitudeMode.
orientation optional
Consulta los Model3DElement.orientation.
position optional
Consulta los Model3DElement.position.
scale optional
Tipo:  number|Vector3D|Vector3DLiteral optional
Consulta los Model3DElement.scale.
src optional
Tipo:  string|URL optional
Consulta los Model3DElement.src.

Clase Polyline3DElement

Clase google.maps.maps3d.Polyline3DElement

Una polilínea 3D es una superposición lineal de segmentos de líneas conectados en un mapa 3D.

Elemento personalizado:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>

Esta clase extiende HTMLElement.

Esta clase implementa Polyline3DElementOptions.

Para acceder, llama a const {Polyline3DElement} = await google.maps.importLibrary("maps3d"). Consulta el artículo Bibliotecas de la API de Maps JavaScript.
Polyline3DElement
Polyline3DElement([options])
Parámetros: 
Crea un Polyline3DElement con las opciones especificadas.
altitudeMode
Tipo:  AltitudeMode optional
Predeterminado: AltitudeMode.ABSOLUTE
Especifica cómo se interpretan los componentes de altitud en las coordenadas.
Atributo HTML:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates
Secuencia ordenada de coordenadas de la polilínea En algunos modos, la altitud se ignora y, por lo tanto, es opcional.
drawsOccludedSegments
Tipo:  boolean optional
Valor predeterminado: false
Especifica si se dibujan o no las partes de la polilínea que podrían ocultarse. La geometría del mapa (p.ej., edificios) puede ocluirlas.
Atributo HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Tipo:  boolean optional
Predeterminado: false
Especifica si se debe conectar la polilínea al suelo. Para extruir un polilinea, altitudeMode debe ser RELATIVE_TO_GROUND o ABSOLUTE.
Atributo HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
Tipo:  boolean optional
Valor predeterminado: false
Cuando true, los bordes de la polilínea se interpretan como geodésicos y siguen la curvatura de la Tierra. Cuando es false, los bordes del polilinea se renderizan como líneas rectas en el espacio de la pantalla.
Atributo HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Tipo:  string optional
Es el color exterior. Se admiten todos los colores CSS3.
Atributo HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
Tipo:  number optional
El ancho exterior está entre 0.0 y 1.0. Es un porcentaje de strokeWidth.
Atributo HTML:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor
Tipo:  string optional
color del trazo. Se admiten todos los colores CSS3.
Atributo HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
Tipo:  number optional
ancho de trazo en píxeles.
Atributo HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Tipo:  number optional
El índice z en comparación con otros polígonos.
Atributo HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
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 detectar.
  • listener:  EventListener|EventListenerObject 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 que se muestra:  void
Establece una función a la que se llamará cada vez que se publique el evento especificado en el destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • type:  string Es una cadena que especifica el tipo de evento para el que se debe 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 objetivo del evento.
  • options:  boolean|EventListenerOptions optional Ver opciones
Valor que se muestra:  void
Quita del destino un objeto de escucha de eventos registrado anteriormente con addEventListener. Consulta removeEventListener.

Interfaz Polyline3DElementOptions

Interfaz de google.maps.maps3d.Polyline3DElementOptions

Objeto Polyline3DElementOptions que se usa para definir las propiedades que se pueden establecer en un Polyline3DElement.
altitudeMode optional
Tipo:  AltitudeMode optional
Consulta los Polyline3DElement.altitudeMode.
coordinates optional
Consulta los Polyline3DElement.coordinates.
drawsOccludedSegments optional
Tipo:  boolean optional
Consulta los Polyline3DElement.drawsOccludedSegments.
extruded optional
Tipo:  boolean optional
Consulta los Polyline3DElement.extruded.
geodesic optional
Tipo:  boolean optional
Consulta los Polyline3DElement.geodesic.
outerColor optional
Tipo:  string optional
Consulta los Polyline3DElement.outerColor.
outerWidth optional
Tipo:  number optional
Consulta los Polyline3DElement.outerWidth.
strokeColor optional
Tipo:  string optional
Consulta los Polyline3DElement.strokeColor.
strokeWidth optional
Tipo:  number optional
Consulta los Polyline3DElement.strokeWidth.
zIndex optional
Tipo:  number optional
Consulta los Polyline3DElement.zIndex.

Clase Polygon3DElement

Clase google.maps.maps3d.Polygon3DElement

Un polígono 3D (como una polilínea 3D) define una serie de coordenadas conectadas en una secuencia ordenada. Además, los polígonos forman un bucle cerrado y definen una región rellena.

Elemento personalizado:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>

Esta clase extiende HTMLElement.

Esta clase implementa Polygon3DElementOptions.

Para acceder, llama a const {Polygon3DElement} = await google.maps.importLibrary("maps3d"). Consulta Bibliotecas de la API de Maps JavaScript.
Polygon3DElement
Polygon3DElement([options])
Parámetros: 
Crea un Polygon3DElement con las opciones especificadas.
altitudeMode
Tipo:  AltitudeMode optional
Predeterminado: AltitudeMode.ABSOLUTE
Especifica cómo se interpretan los componentes de altitud en las coordenadas.
Atributo HTML:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
Tipo:  boolean optional
Valor predeterminado: false
Especifica si se dibujan o no las partes del polígono que podrían ocultarse. La geometría del mapa (p. ej., edificios) puede ocluirlos.
Atributo HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Tipo:  boolean optional
Predeterminado: false
Especifica si se debe conectar el polígono al suelo. Para extruir un polígono, el altitudeMode debe ser RELATIVE_TO_GROUND o ABSOLUTE.
Atributo HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Tipo:  string optional
color de relleno. Se admiten todos los colores CSS3.
Atributo HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
Tipo:  boolean optional
Valor predeterminado: false
Cuando true, los bordes del polígono se interpretan como geodésicos y siguen la curvatura de la Tierra. Cuando es false, los bordes del polígono se renderizan como líneas rectas en el espacio de la pantalla.
Atributo HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
Es la secuencia ordenada de coordenadas que designa un bucle cerrado. A diferencia de las polilíneas, un polígono puede constar de una o más rutas, que crean varios recortes dentro del polígono.
outerCoordinates
Es la secuencia ordenada de coordenadas que designa un bucle cerrado. La altitud se ignora en ciertos modos y, por lo tanto, es opcional.
strokeColor
Tipo:  string optional
color del trazo. Se admiten todos los colores CSS3.
Atributo HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
Tipo:  number optional
ancho de trazo en píxeles.
Atributo HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Tipo:  number optional
El índice z en comparación con otros polígonos.
Atributo HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
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 detectar.
  • 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 que se muestra:  void
Establece una función a la que se llamará cada vez que se publique el evento especificado en el destino. Consulta addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parámetros: 
  • type:  string Es una cadena que especifica el tipo de evento para el que se debe 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 objetivo del evento.
  • options:  boolean|EventListenerOptions optional Consulta las opciones.
Valor que se muestra:  void
Quita del destino un objeto de escucha de eventos registrado anteriormente con addEventListener. Consulta removeEventListener.

Interfaz Polygon3DElementOptions

Interfaz google.maps.maps3d.Polygon3DElementOptions

Objeto Polygon3DElementOptions que se usa para definir las propiedades que se pueden establecer en un elemento Polygon3D.
altitudeMode optional
Tipo:  AltitudeMode optional
Consulta los Polygon3DElement.altitudeMode.
drawsOccludedSegments optional
Tipo:  boolean optional
Consulta los Polygon3DElement.drawsOccludedSegments.
extruded optional
Tipo:  boolean optional
Consulta los Polygon3DElement.extruded.
fillColor optional
Tipo:  string optional
Consulta los Polygon3DElement.fillColor.
geodesic optional
Tipo:  boolean optional
Consulta los Polygon3DElement.geodesic.
innerCoordinates optional
Consulta los Polygon3DElement.innerCoordinates.
outerCoordinates optional
Consulta los Polygon3DElement.outerCoordinates.
strokeColor optional
Tipo:  string optional
Consulta los Polygon3DElement.strokeColor.
strokeWidth optional
Tipo:  number optional
Consulta los Polygon3DElement.strokeWidth.
zIndex optional
Tipo:  number optional
Consulta los Polygon3DElement.zIndex.

Constantes de AltitudeMode

Constantes de google.maps.maps3d.AltitudeMode

Especifica cómo se interpretan los componentes de altitud en las coordenadas.

Para acceder, llama a const {AltitudeMode} = await google.maps.importLibrary("maps3d"). Consulta Bibliotecas de la API de Maps JavaScript.
ABSOLUTE Permite expresar objetos en relación con el nivel medio del mar. Eso también significa que, si el nivel de detalle del terreno cambia debajo del objeto, su posición absoluta seguirá siendo la misma.
CLAMP_TO_GROUND Permite expresar objetos colocados en el suelo. Permanecerán a nivel del suelo siguiendo el terreno, independientemente de la altitud que se proporcione. Si el objeto se encuentra sobre un gran cuerpo de agua, se colocará a nivel del mar.
RELATIVE_TO_GROUND Permite expresar objetos en relación con la superficie del terreno. Si cambia el nivel de detalle del terreno, la posición del objeto permanecerá constante en relación con el suelo. Cuando se esté sobre el agua, la altitud se interpretará como un valor en metros sobre el nivel del mar.
RELATIVE_TO_MESH Permite expresar objetos relacionados con la mayor altura del suelo, el edificio y la superficie del agua. Cuando esté sobre el agua, será la superficie del agua; cuando esté sobre el terreno, será la superficie del edificio (si está presente) o la superficie del suelo (si no hay edificios).