3D Maps

Classe Map3DElement

Classe google.maps.maps3d.Map3DElement

Map3DElement é uma interface HTML para a visualização de mapa 3D. O mode precisa ser definido para que o mapa 3D comece a ser renderizado.

Elemento personalizado:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" internal-usage-attribution-ids="id1 id2" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>

Essa classe estende HTMLElement.

Essa classe implementa Map3DElementOptions.

Acesse ligando para const {Map3DElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Map3DElement
Map3DElement([options])
Parâmetros:
bounds
Quando definido, restringe a posição da câmera dentro dos limites de latitude/longitude especificados. Objetos fora dos limites ainda são renderizados. Os limites podem restringir a longitude e a latitude ou apenas uma delas. Para limites somente de latitude, use as longitudes oeste e leste de -180 e 180, respectivamente. Para limites somente de longitude, use as latitudes norte e sul de 90 e -90, respectivamente.
center
O centro do mapa, fornecido como um LatLngAltitude, em que a altitude está em metros acima do nível do solo. Essa não é necessariamente a localização da câmera, já que o campo range afeta a distância da câmera do centro do mapa. Se não for definido, o padrão será {lat: 0, lng: 0, altitude: 63170000}. 63.170.000 metros é a altitude máxima permitida (raio da Terra multiplicado por 10).
Atributo HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIDisabled
Tipo:boolean optional
Padrão:false
Quando true, todos os botões padrão da interface são desativados. Não desativa o teclado e os controles por gestos.
Atributo HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Tipo:number optional
A orientação da bússola do mapa, em graus, em que o norte verdadeiro é zero. Quando não há inclinação, qualquer rotação é interpretada como direção.
Atributo HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
internalUsageAttributionIds
Tipo:Iterable<string> optional
Adiciona um ID de atribuição de uso ao inicializador, o que ajuda o Google a entender quais bibliotecas e exemplos são úteis para os desenvolvedores, como o uso de uma biblioteca de clustering de marcadores. Para desativar o envio do ID de atribuição de uso, exclua essa propriedade. Somente valores únicos serão enviados. As mudanças nesse valor após a instanciação podem ser ignoradas.
Atributo HTML:
  • <gmp-map-3d internal-usage-attribution-ids="id1 id2"></gmp-map-3d>
maxAltitude
Tipo:number optional
A altitude máxima acima do solo que será mostrada no mapa. Um valor válido está entre 0 e 63170000 metros (raio da Terra multiplicado por 10).
Atributo HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
Tipo:number optional
O ângulo máximo de rotação do mapa. Um valor válido está entre 0 e 360 graus. minHeading e maxHeading representam um intervalo de <= 360 graus em que os gestos de rotação serão permitidos. minHeading = 180 e maxHeading = 90 vão permitir o cabeçalho em [0, 90] e o cabeçalho em [180, 360]. minHeading = 90 e maxHeading = 180 vão permitir o cabeçalho em [90, 180].
Atributo HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
Tipo:number optional
O ângulo máximo de incidência do mapa. Um valor válido está entre 0 e 90 graus.
Atributo HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
Tipo:number optional
A altitude mínima acima do solo que será mostrada no mapa. Um valor válido está entre 0 e 63170000 metros (raio da Terra multiplicado por 10).
Atributo HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Tipo:number optional
O ângulo mínimo de rotação do mapa. Um valor válido está entre 0 e 360 graus. minHeading e maxHeading representam um intervalo de <= 360 graus em que os gestos de rotação serão permitidos. minHeading = 180 e maxHeading = 90 vão permitir o cabeçalho em [0, 90] e o cabeçalho em [180, 360]. minHeading = 90 e maxHeading = 180 vão permitir o cabeçalho em [90, 180].
Atributo HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Tipo:number optional
O ângulo mínimo de incidência do mapa. Um valor válido está entre 0 e 90 graus.
Atributo HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
mode
Tipo:MapMode optional
Especifica um modo em que o mapa deve ser renderizado. Se não for definido, o mapa não será renderizado.
Atributo HTML:
  • <gmp-map-3d mode="hybrid"></gmp-map-3d>
  • <gmp-map-3d mode="satellite"></gmp-map-3d>
range
Tipo:number optional
A distância da câmera até o centro do mapa, em metros.
Atributo HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
Tipo:number optional
A rotação da câmera em torno do vetor de visualização, em graus. Para resolver ambiguidades, quando não há inclinação, qualquer rotação é interpretada como direção.
Atributo HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
Tipo:number optional
A inclinação do vetor de visualização da câmera em graus. Um vetor de visualização olhando diretamente para baixo na Terra teria uma inclinação de zero grau. Um vetor de visualização apontando para longe da Terra teria uma inclinação de 180 graus.
Atributo HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
flyCameraAround
flyCameraAround(options)
Parâmetros:
Valor de retorno:nenhum
Esse método faz a câmera orbitar um local específico por um determinado período, fazendo o número especificado de voltas nesse tempo.

Por padrão, a câmera orbita no sentido horário. Se for fornecido um número negativo para as rotações, a câmera vai orbitar no sentido anti-horário.

O método é assíncrono porque as animações só podem começar depois que o mapa é carregado em uma quantidade mínima. O método retorna quando a animação é iniciada.

Se o número de rodadas for zero, não haverá giro, e a animação será concluída imediatamente após o início.
flyCameraTo
flyCameraTo(options)
Parâmetros:
Valor de retorno:nenhum
Esse método move a câmera de forma parabólica da localização atual para uma localização final específica durante um determinado período.

O método é assíncrono porque as animações só podem começar depois que o mapa é carregado em uma quantidade mínima. O método retorna quando a animação é iniciada.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.
stopCameraAnimation
stopCameraAnimation()
Parâmetros:nenhum
Valor de retorno:nenhum
Esse método interrompe qualquer animação de voo que esteja em execução. A câmera permanece onde está durante a animação, sem ser teleportada para o ponto final.

O método é assíncrono porque as animações só podem começar ou parar depois que o mapa carrega uma quantidade mínima. O método retorna quando a animação é interrompida.
gmp-animationend
function(animationEndEvent)
Argumentos: 
  • animationEndEvent:  Event
Esse evento é disparado quando a animação de voo termina. Esse evento é propagado pela árvore do DOM.
gmp-centerchange
function(centerChangeEvent)
Argumentos: 
  • centerChangeEvent:  Event
Esse evento é disparado quando a propriedade central do Map3DElement muda.
gmp-click
function(clickEvent)
Argumentos: 
Esse evento é acionado quando o elemento Map3DElement é clicado.
gmp-error
function(mapInitializationErrorEvent)
Argumentos: 
  • mapInitializationErrorEvent:  Event
Esse evento é disparado quando o mapa não é inicializado.
gmp-headingchange
function(headingChangeEvent)
Argumentos: 
  • headingChangeEvent:  Event
Esse evento é disparado quando a propriedade de cabeçalho do Map3DElement muda.
gmp-rangechange
function(rangeChangeEvent)
Argumentos: 
  • rangeChangeEvent:  Event
Esse evento é disparado quando a propriedade de intervalo do Map3DElement muda.
gmp-rollchange
function(rollChangeEvent)
Argumentos: 
  • rollChangeEvent:  Event
Esse evento é disparado quando a propriedade "roll" do Map3DElement muda.
gmp-steadychange
function(steadyChangeEvent)
Argumentos: 
Esse evento é disparado quando o estado estável de Map3DElement muda.
gmp-tiltchange
function(tiltChangeEvent)
Argumentos: 
  • tiltChangeEvent:  Event
Esse evento é disparado quando a propriedade de inclinação do Map3DElement muda.

Interface Map3DElementOptions

Interface google.maps.maps3d.Map3DElementOptions

Objeto Map3DElementOptions usado para definir as propriedades que podem ser definidas em um Map3DElement.
bounds optional
Consulte Map3DElement.bounds.
center optional
Consulte Map3DElement.center.
defaultUIDisabled optional
Tipo:boolean optional
Consulte Map3DElement.defaultUIDisabled.
heading optional
Tipo:number optional
Consulte Map3DElement.heading.
internalUsageAttributionIds optional
Tipo:Iterable<string> optional
Consulte Map3DElement.internalUsageAttributionIds.
maxAltitude optional
Tipo:number optional
Consulte Map3DElement.maxAltitude.
maxHeading optional
Tipo:number optional
Consulte Map3DElement.maxHeading.
maxTilt optional
Tipo:number optional
Consulte Map3DElement.maxTilt.
minAltitude optional
Tipo:number optional
Consulte Map3DElement.minAltitude.
minHeading optional
Tipo:number optional
Consulte Map3DElement.minHeading.
minTilt optional
Tipo:number optional
Consulte Map3DElement.minTilt.
mode optional
Tipo:MapMode optional
Consulte Map3DElement.mode.
range optional
Tipo:number optional
Consulte Map3DElement.range.
roll optional
Tipo:number optional
Consulte Map3DElement.roll.
tilt optional
Tipo:number optional
Consulte Map3DElement.tilt.

Constantes MapMode

Constantes de google.maps.maps3d.MapMode

Especifica um modo em que o mapa deve ser renderizado.

Acesse ligando para const {MapMode} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
HYBRID Esse modo de mapa mostra uma camada transparente das principais ruas em imagens de satélite ou fotorrealistas.
SATELLITE Esse modo de mapa mostra imagens de satélite ou fotorrealistas, quando disponíveis.

Interface FlyAroundAnimationOptions

Interface google.maps.maps3d.FlyAroundAnimationOptions

Opções de personalização para a animação FlyCameraAround.
camera
O ponto central para onde a câmera deve apontar durante a animação de órbita. A orientação do mapa muda conforme a câmera orbita em torno desse ponto central.
durationMillis optional
Tipo:number optional
A duração da animação em milissegundos. Essa é a duração total da animação, não de uma única rotação.
rounds optional
Tipo:number optional
O número de rotações em torno do centro na duração especificada. Isso controla a velocidade geral de rotação. Passar um número negativo para "rounds" faz com que a câmera gire no sentido anti-horário em vez do sentido horário padrão.

Interface FlyToAnimationOptions

Interface google.maps.maps3d.FlyToAnimationOptions

Opções de personalização para a animação FlyCameraTo.
endCamera
O local para onde a câmera deve apontar no final da animação.
durationMillis optional
Tipo:number optional
A duração da animação em milissegundos. Uma duração de 0 vai teletransportar a câmera direto para a posição final.

Interface CameraOptions

Interface google.maps.maps3d.CameraOptions

Objeto CameraOptions usado para definir as propriedades que podem ser definidas em um objeto de câmera. O objeto de câmera pode ser qualquer coisa que tenha uma posição de câmera, por exemplo, um estado de mapa atual ou um estado de animação solicitado no futuro.
center optional
Consulte Map3DElement.center.
heading optional
Tipo:number optional
Consulte Map3DElement.heading.
range optional
Tipo:number optional
Consulte Map3DElement.range.
roll optional
Tipo:number optional
Consulte Map3DElement.roll.
tilt optional
Tipo:number optional
Consulte Map3DElement.tilt.

Classe SteadyChangeEvent

Classe google.maps.maps3d.SteadyChangeEvent

Esse evento é criado ao monitorar um estado estável de Map3DElement. Esse evento é propagado pela árvore do DOM.

Essa classe estende Event.

Acesse ligando para const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
isSteady
Tipo:boolean
Indica se o Map3DElement está estável (ou seja, toda a renderização da cena atual foi concluída) ou não.

Classe LocationClickEvent

Classe google.maps.maps3d.LocationClickEvent

Esse evento é criado ao clicar em um Map3DElement.

Essa classe estende Event.

Acesse ligando para const {LocationClickEvent} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
position
Tipo:LatLngAltitude optional
A latitude/longitude/altitude que estava abaixo do cursor quando o evento ocorreu. Em níveis mais grosseiros, os dados retornados serão menos precisos. Além disso, a elevação do fundo do mar pode ser retornada para o valor de altitude ao clicar na superfície da água de posições mais altas da câmera. Esse evento é propagado pela árvore do DOM.

Classe PlaceClickEvent

Classe google.maps.maps3d.PlaceClickEvent

Esse evento é criado quando você clica no ícone de um lugar em um Map3DElement. Para evitar que o popover padrão apareça, chame o método preventDefault() nesse evento para impedir que ele seja processado pelo Map3DElement.

Essa classe estende LocationClickEvent.

Acesse ligando para const {PlaceClickEvent} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
placeId
Tipo:string
O ID do lugar do recurso do mapa.
Herdado: position
fetchPlace
fetchPlace()
Parâmetros:nenhum
Valor de retorno:Promise<Place>
Busca um Place para este ID de lugar. No objeto Place resultante, a propriedade "id" será preenchida. Outros campos podem ser solicitados posteriormente via Place.fetchFields(), sujeitos à ativação e ao faturamento normais da API Places. A promessa será rejeitada se houver um erro ao buscar o Place.

Classe Marker3DElement

Classe google.maps.maps3d.Marker3DElement

Mostra uma posição em um mapa 3D. O position precisa ser definido para que o Marker3DElement apareça.

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

Essa classe estende HTMLElement.

Essa classe implementa Marker3DElementOptions.

Acesse ligando para const {Marker3DElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Marker3DElement
Marker3DElement([options])
Parâmetros:
Cria um Marker3DElement com as opções especificadas.
altitudeMode
Tipo:AltitudeMode optional
Padrão:AltitudeMode.CLAMP_TO_GROUND
Especifica como o componente de altitude da posição é interpretado.
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
Padrão:CollisionBehavior.REQUIRED
Uma enumeração que especifica como um Marker3DElement deve se comportar quando entra em conflito com outro Marker3DElement ou com os rótulos do mapa de 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
Padrão:false
Especifica se o marcador deve ser desenhado ou não quando estiver ocluído. O marcador pode ser ocultado pela geometria do mapa (por exemplo, edifícios).
Atributo HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Tipo:boolean optional
Padrão:false
Especifica se o marcador deve ser conectado ao chão. Para extrudar um marcador, o altitudeMode precisa ser RELATIVE_TO_GROUND ou ABSOLUTE.
Atributo HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Tipo:string optional
Texto a ser exibido por este marcador.
Atributo HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
O local da ponta do marcador. A altitude é ignorada em alguns modos e, portanto, é opcional.
Atributo HTML:
  • <gmp-marker-3d position="lat,lng"></gmp-marker-3d>
  • <gmp-marker-3d position="lat,lng,altitude"></gmp-marker-3d>
sizePreserved
Tipo:boolean optional
Padrão:false
Especifica se o marcador deve preservar o tamanho, independente da distância da câmera. Por padrão, o marcador é dimensionado com base na distância da câmera/inclinação.
Atributo HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Tipo:number optional
O zIndex comparado a outros marcadores.
Atributo HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Todos os elementos personalizados adicionados diretamente ao Marker3DElement serão inseridos, mas apenas os elementos dos tipos HTMLImageElement, SVGElement e PinElement serão usados para desenhar marcadores. Os outros elementos serão ignorados.
HTMLImageElement e SVGElement precisam ser encapsulados no elemento <template> antes de serem atribuídos ao slot padrão do Marker3DElement.

No momento, as imagens e os SVGs são rasterizados antes de serem renderizados na cena 3D. Portanto, o HTML personalizado incorporado ao SVG ou as classes CSS adicionadas às imagens não serão aplicados e poderão não ser refletidos quando os marcadores forem exibidos na tela.
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.

Interface Marker3DElementOptions

Interface google.maps.maps3d.Marker3DElementOptions

Objeto Marker3DElementOptions usado para definir as propriedades que podem ser definidas em um Marker3DElement.
altitudeMode optional
Tipo:AltitudeMode optional
Consulte Marker3DElement.altitudeMode.
collisionBehavior optional
Tipo:CollisionBehavior optional
Consulte Marker3DElement.collisionBehavior.
drawsWhenOccluded optional
Tipo:boolean optional
Consulte Marker3DElement.drawsWhenOccluded.
extruded optional
Tipo:boolean optional
Consulte Marker3DElement.extruded.
label optional
Tipo:string optional
Consulte Marker3DElement.label.
position optional
Consulte Marker3DElement.position.
sizePreserved optional
Tipo:boolean optional
Consulte Marker3DElement.sizePreserved.
zIndex optional
Tipo:number optional
Consulte Marker3DElement.zIndex.

Classe Marker3DInteractiveElement

Classe google.maps.maps3d.Marker3DInteractiveElement

Mostra uma posição em um mapa 3D. O position precisa ser definido para que o Marker3DInteractiveElement apareça. Ao contrário de Marker3DElement, Marker3DInteractiveElement recebe um evento gmp-click.

Elemento personalizado:
<gmp-marker-3d-interactive gmp-popover-target="popover-id" title="string"></gmp-marker-3d-interactive>

Essa classe estende Marker3DElement.

Essa classe implementa Marker3DInteractiveElementOptions.

Acesse ligando para const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Parâmetros:
Cria um Marker3DInteractiveElement com as opções especificadas.
gmpPopoverTargetElement
Tipo:PopoverElement optional
Quando definido, o elemento popover será aberto ao clicar neste marcador.
Atributo HTML:
  • <gmp-marker-3d-interactive gmp-popover-target="popover-id"></gmp-marker-3d-interactive>
title
Tipo:string
texto da sobreposição. Se fornecido, um texto de acessibilidade (por exemplo, para uso com leitores de tela) será adicionado ao Marker3DInteractiveElement com o valor fornecido.
Atributo HTML:
  • <gmp-marker-3d-interactive title="string"></gmp-marker-3d-interactive>
Herdado:altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
Todos os elementos personalizados adicionados diretamente ao Marker3DInteractiveElement serão inseridos, mas apenas os elementos do tipo de PinElement serão usados para desenhar marcadores. Os outros elementos serão ignorados.
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.
gmp-click
function(clickEvent)
Argumentos: 
Esse evento é acionado quando o elemento Marker3DInteractiveElement é clicado.

Interface Marker3DInteractiveElementOptions

Interface google.maps.maps3d.Marker3DInteractiveElementOptions

Objeto Marker3DInteractiveElementOptions usado para definir as propriedades que podem ser definidas em um Marker3DInteractiveElement.

Essa interface estende Marker3DElementOptions.

gmpPopoverTargetElement optional
Tipo:PopoverElement optional
Consulte Marker3DInteractiveElement.gmpPopoverTargetElement.
title optional
Tipo:string optional
Consulte Marker3DInteractiveElement.title.
Herdado:altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Classe Model3DElement

Classe google.maps.maps3d.Model3DElement

Um modelo 3D que permite a renderização de modelos gLTF. O position e o src precisam ser definidos para que o Model3DElement seja exibido. As propriedades principais

do PBR gLTF precisam ser compatíveis. No momento, não há suporte para extensões ou propriedades de extensão.

Elemento personalizado:
<gmp-model-3d altitude-mode="absolute" orientation="heading,tilt,roll" position="lat,lng" scale="number" src="url"></gmp-model-3d>

Essa classe estende HTMLElement.

Essa classe implementa Model3DElementOptions.

Acesse ligando para const {Model3DElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Model3DElement
Model3DElement([options])
Parâmetros:
Cria um Model3DElement com as opções especificadas.
altitudeMode
Tipo:AltitudeMode optional
Padrão:AltitudeMode.CLAMP_TO_GROUND
Especifica como a altitude na posição é interpretada.
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
Descreve a rotação do sistema de coordenadas de um modelo 3D para posicionar o modelo no mapa 3D. As rotações

são aplicadas ao modelo na seguinte ordem: rotação, inclinação e direção.
Atributo HTML:
  • <gmp-model-3d orientation="heading,tilt,roll"></gmp-model-3d>
position
Define a posição do Model3DElement. A altitude é ignorada em alguns modos e, portanto, é opcional.
Atributo HTML:
  • <gmp-model-3d position="lat,lng"></gmp-model-3d>
  • <gmp-model-3d position="lat,lng,altitude"></gmp-model-3d>
scale
Tipo:number|Vector3D|Vector3DLiteral optional
Padrão:1
Dimensiona o modelo ao longo dos eixos x, y e z no espaço de coordenadas do modelo.
Atributo HTML:
  • <gmp-model-3d scale="number"></gmp-model-3d>
  • <gmp-model-3d scale="x,y,z"></gmp-model-3d>
src
Tipo:string|URL optional
Especifica o URL do modelo 3D. No momento, só há suporte para modelos no formato .glb.

Todos os URLs HTTP relativos serão resolvidos para os absolutos correspondentes.

Se você estiver hospedando os arquivos do modelo .glb em um site ou servidor diferente do aplicativo principal, configure os cabeçalhos HTTP CORS corretos. Isso permite que seu aplicativo acesse com segurança os arquivos de modelo do outro domínio.
Atributo HTML:
  • <gmp-model-3d src="url"></gmp-model-3d>
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.

Interface Model3DElementOptions

Interface google.maps.maps3d.Model3DElementOptions

Objeto Model3DElementOptions usado para definir as propriedades que podem ser definidas em um Model3DElement.
altitudeMode optional
Tipo:AltitudeMode optional
Consulte Model3DElement.altitudeMode.
orientation optional
Consulte Model3DElement.orientation.
position optional
Consulte Model3DElement.position.
scale optional
Tipo:number|Vector3D|Vector3DLiteral optional
Consulte Model3DElement.scale.
src optional
Tipo:string|URL optional
Consulte Model3DElement.src.

Classe Model3DInteractiveElement

Classe google.maps.maps3d.Model3DInteractiveElement

Um modelo 3D que permite a renderização de modelos gLTF. O position e o src precisam ser definidos para que o Model3DElement seja exibido. As propriedades principais

do PBR gLTF precisam ser compatíveis. No momento, não há suporte para extensões ou propriedades de extensão.

Ao contrário de Model3DElement, Model3DInteractiveElement recebe um evento gmp-click.

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

Essa classe estende Model3DElement.

Essa classe implementa Model3DInteractiveElementOptions.

Acesse ligando para const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Model3DInteractiveElement
Model3DInteractiveElement([options])
Parâmetros:
Cria um Model3DInteractiveElement com as opções especificadas.
Herdado:altitudeMode, orientation, position, scale, src
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.
gmp-click
function(clickEvent)
Argumentos: 
Esse evento é acionado quando o elemento Model3DInteractiveElement é clicado.

Interface Model3DInteractiveElementOptions

Interface google.maps.maps3d.Model3DInteractiveElementOptions

Objeto Model3DInteractiveElementOptions usado para definir as propriedades que podem ser definidas em um Model3DInteractiveElement.

Essa interface estende Model3DElementOptions.

Herdado:altitudeMode, orientation, position, scale, src

Classe Polyline3DElement

Classe google.maps.maps3d.Polyline3DElement

Uma polilinha 3D é uma sobreposição linear de segmentos de linha conectados em um mapa 3D.

Elemento personalizado:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>

Essa classe estende HTMLElement.

Essa classe implementa Polyline3DElementOptions.

Acesse ligando para const {Polyline3DElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Polyline3DElement
Polyline3DElement([options])
Parâmetros:
Cria um Polyline3DElement com as opções especificadas.
altitudeMode
Tipo:AltitudeMode optional
Padrão:AltitudeMode.CLAMP_TO_GROUND
Especifica como os componentes de altitude nas coordenadas são interpretados.
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>
drawsOccludedSegments
Tipo:boolean optional
Padrão:false
Especifica se as partes da polilinha que podem ser ocultadas são desenhadas ou não. As polilinhas podem ser ocultadas pela geometria do mapa (por exemplo, edifícios).
Atributo HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Tipo:boolean optional
Padrão:false
Especifica se a polilinha deve ser conectada ao chão. Para extrudar uma polilinha, o altitudeMode precisa ser RELATIVE_TO_GROUND ou ABSOLUTE.
Atributo HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
Tipo:boolean optional
Padrão:false
Quando true, as bordas da polilinha são interpretadas como geodésicas e seguem a curvatura da Terra. Quando false, as bordas da polilinha são renderizadas como linhas retas no espaço da tela.
Atributo HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Tipo:string optional
É a cor externa. Todas as cores CSS3 são compatíveis.
Atributo HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
Tipo:number optional
A largura externa está entre 0.0 e 1.0. Essa é uma porcentagem da strokeWidth.
Atributo HTML:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
path
A sequência ordenada de coordenadas da polilinha. A altitude é ignorada em alguns modos e, portanto, é opcional.
Atributo HTML:
  • <gmp-polyline-3d path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."></gmp-polyline-3d>
strokeColor
Tipo:string optional
A cor do traço. Todas as cores CSS3 são compatíveis.
Atributo HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
Tipo:number optional
A largura do traço em pixels.
Atributo HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Tipo:number optional
O zIndex comparado a outras polilinhas/polígonos.
Atributo HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
coordinates
A sequência ordenada de coordenadas da polilinha. A altitude é ignorada em alguns modos e, portanto, é opcional.
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.

Interface Polyline3DElementOptions

Interface google.maps.maps3d.Polyline3DElementOptions

Objeto Polyline3DElementOptions usado para definir as propriedades que podem ser definidas em um Polyline3DElement.
altitudeMode optional
Tipo:AltitudeMode optional
Consulte Polyline3DElement.altitudeMode.
coordinates optional
Consulte Polyline3DElement.coordinates.
drawsOccludedSegments optional
Tipo:boolean optional
Consulte Polyline3DElement.drawsOccludedSegments.
extruded optional
Tipo:boolean optional
Consulte Polyline3DElement.extruded.
geodesic optional
Tipo:boolean optional
Consulte Polyline3DElement.geodesic.
outerColor optional
Tipo:string optional
Consulte Polyline3DElement.outerColor.
outerWidth optional
Tipo:number optional
Consulte Polyline3DElement.outerWidth.
strokeColor optional
Tipo:string optional
Consulte Polyline3DElement.strokeColor.
strokeWidth optional
Tipo:number optional
Consulte Polyline3DElement.strokeWidth.
zIndex optional
Tipo:number optional
Consulte Polyline3DElement.zIndex.

Classe Polyline3DInteractiveElement

Classe google.maps.maps3d.Polyline3DInteractiveElement

Uma polilinha 3D é uma sobreposição linear de segmentos de linha conectados em um mapa 3D. Ao contrário de Polyline3DElement, Polyline3DInteractiveElement recebe um evento gmp-click.

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

Essa classe estende Polyline3DElement.

Essa classe implementa Polyline3DInteractiveElementOptions.

Acesse ligando para const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Polyline3DInteractiveElement
Polyline3DInteractiveElement([options])
Parâmetros:
Cria um Polyline3DInteractiveElement com as opções especificadas.
Herdado: altitudeMode, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, path, strokeColor, strokeWidth, zIndex, coordinates
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.
gmp-click
function(clickEvent)
Argumentos: 
  • clickEvent:  LocationClickEvent O objeto de evento vai conter a localização de latitude, longitude e altitude do clique.
Esse evento é acionado quando o elemento Polyline3DInteractiveElement é clicado.

Interface Polyline3DInteractiveElementOptions

Interface google.maps.maps3d.Polyline3DInteractiveElementOptions

Objeto Polyline3DInteractiveElementOptions usado para definir as propriedades que podem ser definidas em um Polyline3DInteractiveElement.

Essa interface estende Polyline3DElementOptions.

Herdado:altitudeMode, coordinates, drawsOccludedSegments, extruded, geodesic, outerColor, outerWidth, strokeColor, strokeWidth, zIndex

Classe Polygon3DElement

Classe google.maps.maps3d.Polygon3DElement

Um polígono 3D (como uma polilinha 3D) define uma série de coordenadas conectadas em uma sequência ordenada. Além disso, os polígonos formam um loop fechado e definem uma região preenchida.

Elemento personalizado:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..." stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>

Essa classe estende HTMLElement.

Essa classe implementa Polygon3DElementOptions.

Acesse ligando para const {Polygon3DElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Polygon3DElement
Polygon3DElement([options])
Parâmetros:
Cria um Polygon3DElement com as opções especificadas.
altitudeMode
Tipo:AltitudeMode optional
Padrão:AltitudeMode.CLAMP_TO_GROUND
Especifica como os componentes de altitude nas coordenadas são interpretados.
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
Padrão:false
Especifica se as partes do polígono que podem ser ocultadas são desenhadas ou não. Os polígonos podem ser ocultados pela geometria do mapa, como edifícios.
Atributo HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Tipo:boolean optional
Padrão:false
Especifica se o polígono deve ser conectado ao chão. Para extrudar um polígono, o altitudeMode precisa ser RELATIVE_TO_GROUND ou ABSOLUTE.
Atributo HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Tipo:string optional
cor de preenchimento. Todas as cores CSS3 são compatíveis.
Atributo HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
Tipo:boolean optional
Padrão:false
Quando true, as bordas do polígono são interpretadas como geodésicas e seguem a curvatura da Terra. Quando false, as bordas do polígono são renderizadas como linhas retas no espaço da tela.
Atributo HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerPaths
A sequência ordenada de coordenadas que designam um loop fechado. Ao contrário das polilinhas, um polígono pode consistir em um ou mais caminhos, que criam vários cortes dentro dele.
path
A sequência ordenada de coordenadas que designam um loop fechado. A altitude é ignorada em alguns modos e, portanto, é opcional.
Atributo HTML:
  • <gmp-polygon-3d path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."></gmp-polygon-3d>
strokeColor
Tipo:string optional
A cor do traço. Todas as cores CSS3 são compatíveis.
Atributo HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
Tipo:number optional
A largura do traço em pixels.
Atributo HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Tipo:number optional
O zIndex comparado a outras polilinhas/polígonos.
Atributo HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
outerCoordinates
A sequência ordenada de coordenadas que designam um loop fechado. A altitude é ignorada em alguns modos e, portanto, é opcional.
innerCoordinates
A sequência ordenada de coordenadas que designam um loop fechado. Ao contrário das polilinhas, um polígono pode consistir em um ou mais caminhos, que criam vários cortes dentro dele.
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.

Interface Polygon3DElementOptions

Interface google.maps.maps3d.Polygon3DElementOptions

Objeto Polygon3DElementOptions usado para definir as propriedades que podem ser definidas em um Polygon3DElement.
altitudeMode optional
Tipo:AltitudeMode optional
Consulte Polygon3DElement.altitudeMode.
drawsOccludedSegments optional
Tipo:boolean optional
Consulte Polygon3DElement.drawsOccludedSegments.
extruded optional
Tipo:boolean optional
Consulte Polygon3DElement.extruded.
fillColor optional
Tipo:string optional
Consulte Polygon3DElement.fillColor.
geodesic optional
Tipo:boolean optional
Consulte Polygon3DElement.geodesic.
innerCoordinates optional
Consulte Polygon3DElement.innerCoordinates.
outerCoordinates optional
Consulte Polygon3DElement.outerCoordinates.
strokeColor optional
Tipo:string optional
Consulte Polygon3DElement.strokeColor.
strokeWidth optional
Tipo:number optional
Consulte Polygon3DElement.strokeWidth.
zIndex optional
Tipo:number optional
Consulte Polygon3DElement.zIndex.

Classe Polygon3DInteractiveElement

Classe google.maps.maps3d.Polygon3DInteractiveElement

Um polígono 3D (como uma polilinha 3D) define uma série de coordenadas conectadas em uma sequência ordenada. Além disso, os polígonos formam um loop fechado e definem uma região preenchida. Ao contrário de Polygon3DElement, Polygon3DInteractiveElement recebe um evento gmp-click.

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

Essa classe estende Polygon3DElement.

Essa classe implementa Polygon3DInteractiveElementOptions.

Acesse ligando para const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
Polygon3DInteractiveElement
Polygon3DInteractiveElement([options])
Parâmetros:
Cria um Polygon3DInteractiveElement com as opções especificadas.
Herdado:altitudeMode, drawsOccludedSegments, extruded, fillColor, geodesic, innerPaths, path, strokeColor, strokeWidth, zIndex, outerCoordinates, innerCoordinates
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.
gmp-click
function(clickEvent)
Argumentos: 
  • clickEvent:  LocationClickEvent O objeto de evento vai conter a localização de latitude, longitude e altitude do clique.
Esse evento é acionado quando o elemento Polygon3DInteractiveElement é clicado.

Interface Polygon3DInteractiveElementOptions

Interface google.maps.maps3d.Polygon3DInteractiveElementOptions

Objeto Polygon3DInteractiveElementOptions usado para definir as propriedades que podem ser definidas em um Polygon3DInteractiveElement.

Essa interface estende Polygon3DElementOptions.

Herdado:altitudeMode, drawsOccludedSegments, extruded, fillColor, geodesic, innerCoordinates, outerCoordinates, strokeColor, strokeWidth, zIndex

Classe PopoverElement

Classe google.maps.maps3d.PopoverElement

Um elemento HTML personalizado que renderiza um popover. Ele parece uma bolha e geralmente está conectado a um marcador.

Elemento personalizado:
<gmp-popover altitude-mode="absolute" light-dismiss-disabled open position-anchor="lat,lng"></gmp-popover>

Essa classe estende HTMLElement.

Essa classe implementa PopoverElementOptions.

Acesse ligando para const {PopoverElement} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
PopoverElement
PopoverElement([options])
Parâmetros:
altitudeMode
Tipo:AltitudeMode optional
Padrão:AltitudeMode.CLAMP_TO_GROUND
Especifica como o componente de altitude da posição é interpretado.
Atributo HTML:
  • <gmp-popover altitude-mode="absolute"></gmp-popover>
  • <gmp-popover altitude-mode="clamp-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-ground"></gmp-popover>
  • <gmp-popover altitude-mode="relative-to-mesh"></gmp-popover>
lightDismissDisabled
Tipo:boolean optional
Padrão:false
Especifica se o popover deve ser "descartado com um toque" ou não. O comportamento de "dispensa leve" é semelhante a definir o atributo popover="auto", que faz parte da API Popover do navegador.
Atributo HTML:
  • <gmp-popover light-dismiss-disabled></gmp-popover>
open
Tipo:boolean optional
Padrão:false
Especifica se o popover deve estar aberto ou não.
Atributo HTML:
  • <gmp-popover open></gmp-popover>
positionAnchor
A posição em que o popover será exibido. Se o popover estiver ancorado em um marcador interativo, a posição do marcador será usada.
Atributo HTML:
  • <gmp-popover position-anchor="lat,lng"></gmp-popover>
  • <gmp-popover position-anchor="lat,lng,altitude"></gmp-popover>
  • <gmp-popover position-anchor="marker-id"></gmp-popover>
default
Coloca o conteúdo inserido na seção principal do popover.
header
Coloca o conteúdo encaixado na seção de cabeçalho do popover.
--gmp-popover-max-width
Largura máxima do popover, independente da largura do conteúdo.
--gmp-popover-min-width
Largura mínima do popover, independente da largura do conteúdo. Ao usar essa propriedade, é altamente recomendável definir um valor menor que a largura do mapa (em pixels).
--gmp-popover-pixel-offset-x
O deslocamento no eixo x, em pixels, da ponta do popover do ponto no mapa em cujas coordenadas geográficas o popover está ancorado.
--gmp-popover-pixel-offset-y
O deslocamento no eixo y, em pixels, da ponta do popover do ponto no mapa em cujas coordenadas geográficas o popover está ancorado.
color-scheme
Indica em qual esquema de cores o popover pode ser renderizado. Consulte a documentação do color-scheme para mais detalhes. Se não for especificado, o padrão será as preferências de esquema de cores do usuário.
addEventListener
addEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que diferencia maiúsculas de minúsculas e representa o tipo de evento a ser detectado.
  • listener:  EventListener|EventListenerObject o objeto que recebe uma notificação. Precisa ser uma função ou um objeto com o método handleEvent.
  • options:  boolean|AddEventListenerOptions optional consulte opções. Os eventos personalizados só são compatíveis com capture e passive.
Valor de retorno:void
Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
Parâmetros:
  • type:  string uma string que especifica o tipo de evento para o qual um listener de eventos será removido.
  • listener:  EventListener|EventListenerObject o listener de eventos do manipulador de eventos a ser removido do destino do evento.
  • options:  boolean|EventListenerOptions optional consulte opções.
Valor de retorno:void
Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener.

Interface PopoverElementOptions

Interface google.maps.maps3d.PopoverElementOptions

Objeto PopoverElementOptions usado para definir as propriedades que podem ser definidas em um PopoverElement.
altitudeMode optional
Tipo:AltitudeMode optional
Consulte PopoverElement.altitudeMode.
lightDismissDisabled optional
Tipo:boolean optional
Consulte PopoverElement.lightDismissDisabled.
open optional
Tipo:boolean optional
Consulte PopoverElement.open.
positionAnchor optional
Consulte PopoverElement.positionAnchor.

Constantes AltitudeMode

Constantes de google.maps.maps3d.AltitudeMode

Especifica como os componentes de altitude nas coordenadas são interpretados.

Acesse ligando para const {AltitudeMode} = await google.maps.importLibrary("maps3d").
Consulte Bibliotecas na API Maps JavaScript.
ABSOLUTE Permite expressar objetos em relação ao nível médio do mar. Isso também significa que, se o nível de detalhe do terreno mudar abaixo do objeto, a posição absoluta dele vai permanecer a mesma.
CLAMP_TO_GROUND Permite expressar objetos colocados no chão. Eles vão permanecer no nível do solo, seguindo o terreno, independente da altitude fornecida. Se o objeto estiver posicionado sobre um grande corpo d'água, ele será colocado no nível do mar.
RELATIVE_TO_GROUND Permite expressar objetos em relação à superfície do solo. Se o nível de detalhe do terreno mudar, a posição do objeto vai permanecer constante em relação ao solo. Quando estiver sobre a água, a altitude será interpretada como um valor em metros acima do nível do mar.
RELATIVE_TO_MESH Permite expressar objetos em relação à maior superfície de solo, edifício e água. Quando sobre a água, será a superfície da água; quando sobre o terreno, será a superfície do edifício (se presente) ou a superfície do solo (se não houver edifícios).