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" 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.
Construtor | |
---|---|
Map3DElement |
Map3DElement([options]) Parâmetros:
|
Propriedades | |
---|---|
bounds |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional 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 |
Tipo:
LatLngAltitude|LatLngAltitudeLiteral optional 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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
range |
Tipo:
number optional A distância da câmera até o centro do mapa, em metros.
Atributo HTML:
|
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:
|
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:
|
Métodos | |
---|---|
|
addEventListener(type, listener[, options]) Parâmetros:
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(type, listener[, options]) Parâmetros:
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. |
Eventos | |
---|---|
gmp-animationend |
function(animationEndEvent) Argumentos:
Esse evento é disparado quando a animação de voo termina. Esse evento é propagado pela árvore do DOM. |
gmp-centerchange |
function(centerChangeEvent) Argumentos:
Esse evento é disparado quando a propriedade central do Map3DElement muda. |
gmp-click |
function(clickEvent) Argumentos:
Esse evento é acionado quando o elemento Map3DElement é clicado. |
gmp-headingchange |
function(headingChangeEvent) Argumentos:
Esse evento é disparado quando a propriedade de cabeçalho do Map3DElement muda. |
gmp-rangechange |
function(rangeChangeEvent) Argumentos:
Esse evento é disparado quando a propriedade de intervalo do Map3DElement muda. |
gmp-rollchange |
function(rollChangeEvent) Argumentos:
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:
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.
Propriedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Consulte Map3DElement.bounds . |
center optional |
Tipo:
LatLngAltitude|LatLngAltitudeLiteral optional Consulte Map3DElement.center . |
defaultUIDisabled optional |
Tipo:
boolean optional Consulte Map3DElement.defaultUIDisabled . |
heading optional |
Tipo:
number optional Consulte Map3DElement.heading . |
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.
Constantes | |
---|---|
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.
Propriedades | |
---|---|
camera |
Tipo:
CameraOptions 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.
Propriedades | |
---|---|
endCamera |
Tipo:
CameraOptions 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.
Propriedades | |
---|---|
center optional |
Tipo:
LatLngAltitude|LatLngAltitudeLiteral 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.
Propriedades | |
---|---|
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.
Propriedades | |
---|---|
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.
Propriedades | |
---|---|
placeId |
Tipo:
string O ID do lugar do recurso do mapa. |
Herdado:
position
|
Métodos | |
---|---|
fetchPlace |
fetchPlace() Parâmetros:nenhum
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.
Construtor | |
---|---|
Marker3DElement |
Marker3DElement([options]) Parâmetros:
Cria um Marker3DElement com as opções especificadas. |
Propriedades | |
---|---|
altitudeMode |
Tipo:
AltitudeMode optional Padrão:
AltitudeMode.CLAMP_TO_GROUND Especifica como o componente de altitude da posição é interpretado.
Atributo HTML:
|
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:
|
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:
|
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:
|
label |
Tipo:
string optional Texto a ser exibido por este marcador.
Atributo HTML:
|
position |
Tipo:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional O local da ponta do marcador. A altitude é ignorada em alguns modos e, portanto, é opcional.
Atributo HTML:
|
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:
|
zIndex |
Tipo:
number optional O zIndex comparado a outros marcadores.
Atributo HTML:
|
Slots | |
---|---|
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. |
Métodos | |
---|---|
|
addEventListener(type, listener[, options]) Parâmetros:
Valor de retorno:
void Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener. |
|
removeEventListener(type, listener[, options]) Parâmetros:
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.
Propriedades | |
---|---|
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 |
Tipo:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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.
Construtor | |
---|---|
Marker3DInteractiveElement |
Marker3DInteractiveElement([options]) Parâmetros:
Cria um Marker3DInteractiveElement com as opções especificadas. |
Propriedades | |
---|---|
gmpPopoverTargetElement |
Tipo:
PopoverElement optional Quando definido, o elemento popover será aberto ao clicar neste marcador.
Atributo HTML:
|
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:
|
Herdado:altitudeMode ,
collisionBehavior ,
drawsWhenOccluded ,
extruded ,
label ,
position ,
sizePreserved ,
zIndex
|
Slots | |
---|---|
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. |
Métodos | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parâmetros:
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:
Valor de retorno:
void Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener. |
Eventos | |
---|---|
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
.
Propriedades | |
---|---|
gmpPopoverTargetElement optional |
Tipo:
PopoverElement optional |
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.
Construtor | |
---|---|
Model3DElement |
Model3DElement([options]) Parâmetros:
Cria um Model3DElement com as opções especificadas. |
Propriedades | |
---|---|
altitudeMode |
Tipo:
AltitudeMode optional Padrão:
AltitudeMode.CLAMP_TO_GROUND Especifica como a altitude na posição é interpretada.
Atributo HTML:
|
orientation |
Tipo:
Orientation3D|Orientation3DLiteral optional 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:
|
position |
Tipo:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Define a posição do
Model3DElement . A altitude é ignorada em alguns modos e, portanto, é opcional.Atributo HTML:
|
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:
|
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:
|
Métodos | |
---|---|
|
addEventListener(type, listener[, options]) Parâmetros:
Valor de retorno:
void Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener. |
|
removeEventListener(type, listener[, options]) Parâmetros:
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.
Propriedades | |
---|---|
altitudeMode optional |
Tipo:
AltitudeMode optional Consulte Model3DElement.altitudeMode . |
orientation optional |
Tipo:
Orientation3D|Orientation3DLiteral optional Consulte Model3DElement.orientation . |
position optional |
Tipo:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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.
Construtor | |
---|---|
Model3DInteractiveElement |
Model3DInteractiveElement([options]) Parâmetros:
Cria um Model3DInteractiveElement com as opções especificadas. |
Propriedades | |
---|---|
Herdado:altitudeMode ,
orientation ,
position ,
scale ,
src
|
Métodos | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parâmetros:
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:
Valor de retorno:
void Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener. |
Eventos | |
---|---|
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
.
Propriedades | |
---|---|
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" 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.
Construtor | |
---|---|
Polyline3DElement |
Polyline3DElement([options]) Parâmetros:
Cria um Polyline3DElement com as opções especificadas. |
Propriedades | |
---|---|
altitudeMode |
Tipo:
AltitudeMode optional Padrão:
AltitudeMode.CLAMP_TO_GROUND Especifica como os componentes de altitude nas coordenadas são interpretados.
Atributo HTML:
|
coordinates |
Tipo:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional A sequência ordenada de coordenadas da polilinha. A altitude é ignorada em alguns modos e, portanto, é opcional. |
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:
|
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:
|
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:
|
outerColor |
Tipo:
string optional É a cor externa. Todas as cores CSS3 são compatíveis.
Atributo HTML:
|
outerWidth |
Tipo:
number optional A largura externa está entre
0.0 e 1.0 . Essa é uma porcentagem da strokeWidth .Atributo HTML:
|
strokeColor |
Tipo:
string optional A cor do traço. Todas as cores CSS3 são compatíveis.
Atributo HTML:
|
strokeWidth |
Tipo:
number optional A largura do traço em pixels.
Atributo HTML:
|
zIndex |
Tipo:
number optional O zIndex comparado a outras polilinhas/polígonos.
Atributo HTML:
|
Métodos | |
---|---|
|
addEventListener(type, listener[, options]) Parâmetros:
Valor de retorno:
void Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener. |
|
removeEventListener(type, listener[, options]) Parâmetros:
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.
Propriedades | |
---|---|
altitudeMode optional |
Tipo:
AltitudeMode optional Consulte Polyline3DElement.altitudeMode . |
coordinates optional |
Tipo:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> 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.
Construtor | |
---|---|
Polyline3DInteractiveElement |
Polyline3DInteractiveElement([options]) Parâmetros:
Cria um Polyline3DInteractiveElement com as opções especificadas. |
Propriedades | |
---|---|
Herdado:altitudeMode ,
coordinates ,
drawsOccludedSegments ,
extruded ,
geodesic ,
outerColor ,
outerWidth ,
strokeColor ,
strokeWidth ,
zIndex
|
Métodos | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parâmetros:
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:
Valor de retorno:
void Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener. |
Eventos | |
---|---|
gmp-click |
function(clickEvent) Argumentos:
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
.
Propriedades | |
---|---|
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 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.
Construtor | |
---|---|
Polygon3DElement |
Polygon3DElement([options]) Parâmetros:
Cria um Polygon3DElement com as opções especificadas. |
Propriedades | |
---|---|
altitudeMode |
Tipo:
AltitudeMode optional Padrão:
AltitudeMode.CLAMP_TO_GROUND Especifica como os componentes de altitude nas coordenadas são interpretados.
Atributo HTML:
|
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:
|
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:
|
fillColor |
Tipo:
string optional cor de preenchimento. Todas as cores CSS3 são compatíveis.
Atributo HTML:
|
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:
|
innerCoordinates |
Tipo:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional 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. |
outerCoordinates |
Tipo:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional A sequência ordenada de coordenadas que designam um loop fechado. A altitude é ignorada em alguns modos e, portanto, é opcional. |
strokeColor |
Tipo:
string optional A cor do traço. Todas as cores CSS3 são compatíveis.
Atributo HTML:
|
strokeWidth |
Tipo:
number optional A largura do traço em pixels.
Atributo HTML:
|
zIndex |
Tipo:
number optional O zIndex comparado a outras polilinhas/polígonos.
Atributo HTML:
|
Métodos | |
---|---|
|
addEventListener(type, listener[, options]) Parâmetros:
Valor de retorno:
void Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener. |
|
removeEventListener(type, listener[, options]) Parâmetros:
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.
Propriedades | |
---|---|
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 |
Tipo:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral>|Iterable<LatLngLiteral>> optional Consulte Polygon3DElement.innerCoordinates . |
outerCoordinates optional |
Tipo:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> 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.
Construtor | |
---|---|
Polygon3DInteractiveElement |
Polygon3DInteractiveElement([options]) Parâmetros:
Cria um Polygon3DInteractiveElement com as opções especificadas. |
Propriedades | |
---|---|
Herdado:altitudeMode ,
drawsOccludedSegments ,
extruded ,
fillColor ,
geodesic ,
innerCoordinates ,
outerCoordinates ,
strokeColor ,
strokeWidth ,
zIndex
|
Métodos | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parâmetros:
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:
Valor de retorno:
void Remove do destino um listener de eventos registrado anteriormente com addEventListener. Consulte removeEventListener. |
Eventos | |
---|---|
gmp-click |
function(clickEvent) Argumentos:
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
.
Propriedades | |
---|---|
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.
Construtor | |
---|---|
PopoverElement |
PopoverElement([options]) Parâmetros:
|
Propriedades | |
---|---|
altitudeMode |
Tipo:
AltitudeMode optional Padrão:
AltitudeMode.CLAMP_TO_GROUND Especifica como o componente de altitude da posição é interpretado.
Atributo HTML:
|
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:
|
open |
Tipo:
boolean optional Padrão:
false Especifica se o popover deve estar aberto ou não.
Atributo HTML:
|
positionAnchor |
Tipo:
LatLngLiteral|LatLngAltitudeLiteral|Marker3DInteractiveElement|string optional 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:
|
Slots | |
---|---|
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. |
Propriedades de CSS | |
---|---|
--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. |
Métodos | |
---|---|
|
addEventListener(type, listener[, options]) Parâmetros:
Valor de retorno:
void Configura uma função que será chamada sempre que o evento especificado for entregue ao destino. Consulte addEventListener. |
|
removeEventListener(type, listener[, options]) Parâmetros:
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.
Propriedades | |
---|---|
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 |
Tipo:
LatLngLiteral|LatLngAltitudeLiteral|string|Marker3DInteractiveElement 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.
Constantes | |
---|---|
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). |