Draw on the map

Classe MarkerElement

google.maps.maps3d.MarkerElement class
extends HTMLElement
implements MarkerElementOptions
library "maps3d"

Mostra uma posição em um mapa 3D. O position precisa ser definido para que o MarkerElement seja exibido.

      
<gmp-marker
  altitude-mode="value-name"
  anchor-left="string"
  anchor-top="string"
  autofits-camera
  collision-behavior="value-name"
  collision-priority="number"
  position="lat,lng"
  title="string">
</gmp-marker>
const {MarkerElement} = await google.maps.importLibrary("maps3d");
MarkerElement
MarkerElement([options])
Parâmetros:
Cria um MarkerElement com as opções especificadas.
altitudeMode
attr: altitude-mode
Tipo de entrada: AltitudeMode optional
Tipo de saída: AltitudeMode
Especifica como o componente de altitude da posição é interpretado.
Atributo HTML: altitude-mode="value-name"
anchorLeft
attr: anchor-left
Tipo de entrada: string optional
Tipo de saída: string
Padrão: -50%
Um valor de porcentagem de comprimento CSS usado para deslocar o ponto de fixação do canto superior esquerdo do marcador. Isso é útil ao usar um elemento visual com um ponto de fixação diferente do ponto central inferior típico do marcador padrão.
Atributo HTML: anchor-left="string"
anchorTop
attr: anchor-top
Tipo de entrada: string optional
Tipo de saída: string
Padrão: -100%
Um valor de porcentagem de comprimento CSS usado para deslocar o ponto de fixação do canto superior esquerdo do marcador. Isso é útil ao usar um elemento visual com um ponto de fixação diferente do ponto central inferior típico do marcador padrão.
Atributo HTML: anchor-top="string"
AlphaautofitsCamera
attr: autofits-camera
Tipo: boolean optional
Padrão: false
Se fornecido, o marcador especificado vai ficar visível na janela de visualização do mapa, junto com outros elementos que optaram por participar.
Atributo HTML: autofits-camera
collisionBehavior
attr: collision-behavior
Tipo de entrada: CollisionBehavior optional
Tipo de saída: CollisionBehavior
Uma enumeração que especifica como um MarkerElement deve se comportar quando entra em conflito com outro MarkerElement, Marker3DElement ou com os rótulos do mapa de base.
Atributo HTML: collision-behavior="value-name"
collisionPriority
attr: collision-priority
Tipo de entrada: number optional
Tipo de saída: number optional
Um número usado para ajudar a determinar a prioridade relativa entre os marcadores CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY (incluindo Marker3DElement). Um valor collisionPriority mais alto indica prioridade mais alta.
Atributo HTML: collision-priority="number"
position
attr: position
Tipo de entrada: LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Tipo de saída: LatLngAltitude optional
O local da ponta do marcador. A altitude é ignorada em determinados modos e, portanto, é opcional.
Atributo HTML:
  • position="lat,lng"
  • position="lat,lng,altitude"
title
attr: title
Tipo: string
texto da sobreposição. Se fornecido, um texto de acessibilidade (por exemplo, para uso com leitores de tela) será adicionado ao MarkerElement com o valor fornecido.
Atributo HTML: title="string"
default
Todos os elementos personalizados adicionados diretamente ao MarkerElement serão encaixados.
z-index
O Z-index do marcador. Consulte a documentação do z-index para mais detalhes. Os marcadores sobrepostos com um Z-index maior cobrem aqueles com um Z-index menor. Por padrão, os marcadores são mostrados de acordo com a posição deles no DOM. Os marcadores adicionados posteriormente no DOM aparecem na frente dos adicionados anteriormente.
Herdado: addEventListener, removeEventListener

Interface MarkerElementOptions

Interface google.maps.maps3d.MarkerElementOptions

Objeto MarkerElementOptions usado para definir as propriedades que podem ser definidas em um MarkerElement.

altitudeMode
opcional
Tipo: AltitudeMode optional
anchorLeft
opcional
Tipo: string optional
anchorTop
opcional
Tipo: string optional
AlphaautofitsCamera
opcional
Tipo: boolean optional
collisionBehavior
opcional
Tipo: CollisionBehavior optional
collisionPriority
opcional
Tipo: number optional
position
opcional
title
opcional
Tipo: string optional

Classe MarkerInteractiveElement

google.maps.maps3d.MarkerInteractiveElement class
extends MarkerElement
implements MarkerInteractiveElementOptions
library "maps3d"

Mostra uma posição em um mapa 3D. O position precisa ser definido para que o MarkerInteractiveElement seja exibido. Ao contrário de MarkerElement, MarkerInteractiveElement recebe um evento gmp-click.

<gmp-marker-interactive
  gmp-popover-target-element="popover-id">
</gmp-marker-interactive>
const {MarkerInteractiveElement} = await google.maps.importLibrary("maps3d");
MarkerInteractiveElement
MarkerInteractiveElement([options])
Parâmetros:
Cria um MarkerInteractiveElement com as opções especificadas.
gmpPopoverTargetElement
attr: gmp-popover-target-element
Tipo de entrada: PopoverElement optional
Tipo de saída: PopoverElement optional
Quando definido, o elemento popover será aberto ao clicar no marcador.
Atributo HTML: gmp-popover-target-element="popover-id"
Herdado: altitudeMode (attr: altitude-mode), anchorLeft (attr: anchor-left), anchorTop (attr: anchor-top), AlphaautofitsCamera (attr: autofits-camera), collisionBehavior (attr: collision-behavior), collisionPriority (attr: collision-priority), position (attr: position), title (attr: title)
Herdado: default
Herdado: z-index
Herdado: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Argumentos:
Esse evento é acionado quando o elemento MarkerInteractiveElement é clicado.

Interface MarkerInteractiveElementOptions

google.maps.maps3d.MarkerInteractiveElementOptions interface
extends MarkerElementOptions

Objeto MarkerInteractiveElementOptions usado para definir as propriedades que podem ser definidas em um MarkerInteractiveElement.

gmpPopoverTargetElement
opcional
Tipo: PopoverElement optional
Herdado: altitudeMode, anchorLeft, anchorTop, AlphaautofitsCamera, collisionBehavior, collisionPriority, position, title

Classe Marker3DElement

google.maps.maps3d.Marker3DElement class
extends HTMLElement
implements Marker3DElementOptions
library "maps3d"

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

     
<gmp-marker-3d
  altitude-mode="value-name"
  autofits-camera
  collision-behavior="value-name"
  collision-priority="number"
  draws-when-occluded
  extruded
  label="string"
  position="lat,lng"
  size-preserved
  z-index="number">
</gmp-marker-3d>
const {Marker3DElement} = await google.maps.importLibrary("maps3d");
Marker3DElement
Marker3DElement([options])
Parâmetros:
Cria um Marker3DElement com as opções especificadas.
altitudeMode
attr: altitude-mode
Tipo de entrada: AltitudeMode optional
Tipo de saída: AltitudeMode
Especifica como o componente de altitude da posição é interpretado.
Atributo HTML: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Se fornecido, o marcador especificado vai ficar visível na janela de visualização do mapa, junto com outros elementos que optaram por participar.
Atributo HTML: autofits-camera
collisionBehavior
attr: collision-behavior
Tipo de entrada: CollisionBehavior optional
Tipo de saída: CollisionBehavior
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: collision-behavior="value-name"
collisionPriority
attr: collision-priority
Tipo de entrada: number optional
Tipo de saída: number optional
A prioridade de colisão usada para detecção de colisão.
Atributo HTML: collision-priority="number"
drawsWhenOccluded
attr: draws-when-occluded
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Especifica se o marcador deve ser desenhado ou não quando estiver oculto. O marcador pode ser ocultado pela geometria do mapa (por exemplo, edifícios).
Atributo HTML: draws-when-occluded
extruded
attr: extruded
Tipo de entrada: boolean optional
Tipo de saída: boolean
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: extruded
label
attr: label
Tipo de entrada: string optional
Tipo de saída: string optional
Texto a ser exibido por esse marcador.
Atributo HTML: label="string"
position
attr: position
Tipo de entrada: LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Tipo de saída: LatLngAltitude optional
O local da ponta do marcador. A altitude é ignorada em determinados modos e, portanto, é opcional.
Atributo HTML:
  • position="lat,lng"
  • position="lat,lng,altitude"
sizePreserved
attr: size-preserved
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Especifica se o marcador precisa preservar o tamanho, independentemente da distância da câmera. Por padrão, o marcador é dimensionado com base na distância da câmera/inclinação.
Atributo HTML: size-preserved
zIndex
attr: z-index
Tipo de entrada: number optional
Tipo de saída: number optional
O zIndex em comparação com outros marcadores.
Atributo HTML: z-index="number"
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 agrupados no elemento <template> antes de serem atribuídos ao slot padrão de Marker3DElement.

No momento, as imagens e os SVGs são rasterizados antes de serem renderizados na cena 3D. Por isso, o HTML personalizado incorporado ao SVG ou às classes CSS adicionadas às imagens não será aplicado e talvez não seja refletido quando os marcadores forem mostrados na tela.
Herdado: addEventListener, removeEventListener

Interface Marker3DElementOptions

Interface google.maps.maps3d.Marker3DElementOptions

Objeto Marker3DElementOptions usado para definir as propriedades que podem ser definidas em um Marker3DElement.

altitudeMode
opcional
Tipo: AltitudeMode optional
AlphaautofitsCamera
opcional
Tipo: boolean optional
collisionBehavior
opcional
Tipo: CollisionBehavior optional
collisionPriority
opcional
Tipo: number optional
drawsWhenOccluded
opcional
Tipo: boolean optional
extruded
opcional
Tipo: boolean optional
label
opcional
Tipo: string optional
position
opcional
sizePreserved
opcional
Tipo: boolean optional
zIndex
opcional
Tipo: number optional

Classe Marker3DInteractiveElement

google.maps.maps3d.Marker3DInteractiveElement class
extends Marker3DElement
implements Marker3DInteractiveElementOptions
library "maps3d"

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

 
<gmp-marker-3d-interactive
  gmp-popover-target-element="popover-id"
  title="string">
</gmp-marker-3d-interactive>
const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Parâmetros:
Cria um Marker3DInteractiveElement com as opções especificadas.
gmpPopoverTargetElement
attr: gmp-popover-target-element
Tipo de entrada: PopoverElement optional
Tipo de saída: PopoverElement optional
Quando definido, o elemento popover será aberto ao clicar no marcador.
Atributo HTML: gmp-popover-target-element="popover-id"
title
attr: 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: title="string"
Herdado: altitudeMode (attr: altitude-mode), AlphaautofitsCamera (attr: autofits-camera), collisionBehavior (attr: collision-behavior), collisionPriority (attr: collision-priority), drawsWhenOccluded (attr: draws-when-occluded), extruded (attr: extruded), label (attr: label), position (attr: position), sizePreserved (attr: size-preserved), zIndex (attr: z-index)
default
Todos os elementos personalizados adicionados diretamente ao Marker3DInteractiveElement serão encaixados, mas apenas os elementos do tipo PinElement serão usados para desenhar marcadores. Os outros elementos serão ignorados.
Herdado: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Argumentos:
Esse evento é acionado quando o elemento Marker3DInteractiveElement é clicado.

Interface Marker3DInteractiveElementOptions

google.maps.maps3d.Marker3DInteractiveElementOptions interface
extends Marker3DElementOptions

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

gmpPopoverTargetElement
opcional
Tipo: PopoverElement optional
title
opcional
Tipo: string optional
Herdado: altitudeMode, AlphaautofitsCamera, collisionBehavior, collisionPriority, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Classe Model3DElement

google.maps.maps3d.Model3DElement class
extends HTMLElement
implements Model3DElementOptions
library "maps3d"

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

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

    
<gmp-model-3d
  altitude-mode="value-name"
  orientation="heading,tilt,roll"
  position="lat,lng"
  scale="number"
  src="url">
</gmp-model-3d>
const {Model3DElement} = await google.maps.importLibrary("maps3d");
Model3DElement
Model3DElement([options])
Parâmetros:
Cria um Model3DElement com as opções especificadas.
altitudeMode
attr: altitude-mode
Tipo de entrada: AltitudeMode optional
Tipo de saída: AltitudeMode
Especifica como a altitude na posição é interpretada.
Atributo HTML: altitude-mode="value-name"
orientation
attr: orientation
Tipo de entrada: Orientation3D|Orientation3DLiteral optional
Tipo de saída: Orientation3D optional
Descreve a rotação do sistema de coordenadas de um modelo 3D para posicioná-lo no mapa 3D.

As rotações são aplicadas ao modelo na seguinte ordem: rotação, inclinação e direção.
Atributo HTML: orientation="heading,tilt,roll"
position
attr: position
Tipo de entrada: LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
Tipo de saída: LatLngAltitude optional
Define a posição do Model3DElement. A altitude é ignorada em determinados modos e, portanto, é opcional.
Atributo HTML:
  • position="lat,lng"
  • position="lat,lng,altitude"
scale
attr: scale
Tipo de entrada: number|Vector3D|Vector3DLiteral optional
Tipo de saída: Vector3D optional
Padrão: 1
Dimensiona o modelo ao longo dos eixos x, y e z no espaço de coordenadas do modelo.
Atributo HTML:
  • scale="number"
  • scale="x,y,z"
src
attr: src
Tipo de entrada: string|URL optional
Tipo de saída: URL optional
Especifica o URL do modelo 3D. No momento, apenas modelos no formato .glb são aceitos.

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

Se você hospedar os arquivos do modelo do .glb em um site ou servidor diferente do aplicativo principal, configure os cabeçalhos HTTP de CORS corretos. Isso permite que seu aplicativo acesse com segurança os arquivos do modelo do outro domínio.
Atributo HTML: src="url"
Herdado: addEventListener, removeEventListener

Interface Model3DElementOptions

Interface google.maps.maps3d.Model3DElementOptions

Objeto Model3DElementOptions usado para definir as propriedades que podem ser definidas em um Model3DElement.

altitudeMode
opcional
Tipo: AltitudeMode optional
orientation
opcional
position
opcional
scale
opcional
Tipo: number|Vector3D|Vector3DLiteral optional
src
opcional
Tipo: string|URL optional

Classe Model3DInteractiveElement

google.maps.maps3d.Model3DInteractiveElement class
extends Model3DElement
implements Model3DInteractiveElementOptions
library "maps3d"

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

As propriedades principais do gLTF PBR 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.

<gmp-model-3d-interactive></gmp-model-3d-interactive>
const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Model3DInteractiveElement
Model3DInteractiveElement([options])
Parâmetros:
Cria um Model3DInteractiveElement com as opções especificadas.
Herdado: altitudeMode (attr: altitude-mode), orientation (attr: orientation), position (attr: position), scale (attr: scale), src (attr: src)
Herdado: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Argumentos:
Esse evento é acionado quando o elemento Model3DInteractiveElement é clicado.

Interface Model3DInteractiveElementOptions

google.maps.maps3d.Model3DInteractiveElementOptions interface
extends Model3DElementOptions

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

Herdado: altitudeMode, orientation, position, scale, src

Classe Polyline3DElement

google.maps.maps3d.Polyline3DElement class
extends HTMLElement
implements Polyline3DElementOptions
library "maps3d"

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

      
<gmp-polyline-3d
  altitude-mode="value-name"
  autofits-camera
  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>
const {Polyline3DElement} = await google.maps.importLibrary("maps3d");
Polyline3DElement
Polyline3DElement([options])
Parâmetros:
Cria um Polyline3DElement com as opções especificadas.
altitudeMode
attr: altitude-mode
Tipo de entrada: AltitudeMode optional
Tipo de saída: AltitudeMode
Especifica como os componentes de altitude nas coordenadas são interpretados.
Atributo HTML: altitude-mode="value-name"
AlphaautofitsCamera
attr: autofits-camera
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Se fornecida, a polilinha especificada vai ficar visível na janela de visualização do mapa, junto com outros elementos que optaram por participar.
Atributo HTML: autofits-camera
drawsOccludedSegments
attr: draws-occluded-segments
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Especifica se as partes da polilinha que podem ser obstruídas são desenhadas ou não. As polilinhas podem ser ocultadas pela geometria do mapa (por exemplo, edifícios).
Atributo HTML: draws-occluded-segments
extruded
attr: extruded
Tipo de entrada: boolean optional
Tipo de saída: boolean
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: extruded
geodesic
attr: geodesic
Tipo de entrada: boolean optional
Tipo de saída: boolean
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: geodesic
outerColor
attr: outer-color
Tipo de entrada: string optional
Tipo de saída: string optional
A cor externa. Todas as cores CSS3 são permitidas.
Atributo HTML: outer-color="string"
outerWidth
attr: outer-width
Tipo de entrada: number optional
Tipo de saída: number optional
A largura externa está entre 0.0 e 1.0. É uma porcentagem do strokeWidth.
Atributo HTML: outer-width="number"
path
attr: path
Tipo de entrada: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
Tipo de saída: Array<LatLngAltitude> optional
A sequência ordenada de coordenadas da polilinha. A altitude é ignorada em determinados modos e, portanto, é opcional.
Atributo HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
strokeColor
attr: stroke-color
Tipo de entrada: string optional
Tipo de saída: string optional
A cor do traço. Todas as cores CSS3 são permitidas.
Atributo HTML: stroke-color="string"
strokeWidth
attr: stroke-width
Tipo de entrada: number optional
Tipo de saída: number optional
A largura do traço em pixels.
Atributo HTML: stroke-width="number"
zIndex
attr: z-index
Tipo de entrada: number optional
Tipo de saída: number optional
O zIndex comparado a outras polilinhas/polígonos.
Atributo HTML: z-index="number"
coordinates
A sequência ordenada de coordenadas da polilinha. A altitude é ignorada em determinados modos e, portanto, é opcional.
Herdado: addEventListener, removeEventListener

Interface Polyline3DElementOptions

Interface google.maps.maps3d.Polyline3DElementOptions

Objeto Polyline3DElementOptions usado para definir as propriedades que podem ser definidas em um Polyline3DElement.

altitudeMode
opcional
Tipo: AltitudeMode optional
AlphaautofitsCamera
opcional
Tipo: boolean optional
coordinates
opcional
drawsOccludedSegments
opcional
Tipo: boolean optional
extruded
opcional
Tipo: boolean optional
geodesic
opcional
Tipo: boolean optional
outerColor
opcional
Tipo: string optional
outerWidth
opcional
Tipo: number optional
path
opcional
strokeColor
opcional
Tipo: string optional
strokeWidth
opcional
Tipo: number optional
zIndex
opcional
Tipo: number optional

Classe Polyline3DInteractiveElement

google.maps.maps3d.Polyline3DInteractiveElement class
extends Polyline3DElement
implements Polyline3DInteractiveElementOptions
library "maps3d"

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.

<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>
const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Polyline3DInteractiveElement
Polyline3DInteractiveElement([options])
Parâmetros:
Cria um Polyline3DInteractiveElement com as opções especificadas.
Herdado: altitudeMode (attr: altitude-mode), AlphaautofitsCamera (attr: autofits-camera), drawsOccludedSegments (attr: draws-occluded-segments), extruded (attr: extruded), geodesic (attr: geodesic), outerColor (attr: outer-color), outerWidth (attr: outer-width), path (attr: path), strokeColor (attr: stroke-color), strokeWidth (attr: stroke-width), zIndex (attr: z-index), coordinates
Herdado: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Argumentos:
  • clickEvent: LocationClickEvent optional o objeto de evento vai conter o local de latitude, longitude e altitude do clique.
Esse evento é acionado quando o elemento Polyline3DInteractiveElement é clicado.

Interface Polyline3DInteractiveElementOptions

google.maps.maps3d.Polyline3DInteractiveElementOptions interface
extends Polyline3DElementOptions

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

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

Classe Polygon3DElement

google.maps.maps3d.Polygon3DElement class
extends HTMLElement
implements Polygon3DElementOptions
library "maps3d"

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.

    
<gmp-polygon-3d
  autofits-camera
  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>
const {Polygon3DElement} = await google.maps.importLibrary("maps3d");
Polygon3DElement
Polygon3DElement([options])
Parâmetros:
Cria um Polygon3DElement com as opções especificadas.
altitudeMode
Tipo de entrada: AltitudeMode optional
Tipo de saída: AltitudeMode
Especifica como os componentes de altitude nas coordenadas são interpretados.
AlphaautofitsCamera
attr: autofits-camera
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Se fornecido, o polígono especificado vai ficar visível na janela de visualização do mapa, junto com outros elementos que optaram por isso.
Atributo HTML: autofits-camera
drawsOccludedSegments
attr: draws-occluded-segments
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Especifica se as partes do polígono que podem ser obstruídas são desenhadas ou não. Os polígonos podem ser ocultados pela geometria do mapa (por exemplo, edifícios).
Atributo HTML: draws-occluded-segments
extruded
attr: extruded
Tipo de entrada: boolean optional
Tipo de saída: boolean
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: extruded
fillColor
attr: fill-color
Tipo de entrada: string optional
Tipo de saída: string optional
cor de preenchimento. Todas as cores CSS3 são permitidas.
Atributo HTML: fill-color="string"
geodesic
attr: geodesic
Tipo de entrada: boolean optional
Tipo de saída: boolean
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: geodesic
innerPaths
Tipo de entrada: Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional
Tipo de saída: Array<Array<LatLngAltitude>> 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 recortes dentro dele.
path
attr: path
Tipo de entrada: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
Tipo de saída: Array<LatLngAltitude> optional
A sequência ordenada de coordenadas que designam um loop fechado. A altitude é ignorada em determinados modos e, portanto, é opcional.
Atributo HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
strokeColor
attr: stroke-color
Tipo de entrada: string optional
Tipo de saída: string optional
A cor do traço. Todas as cores CSS3 são permitidas.
Atributo HTML: stroke-color="string"
strokeWidth
attr: stroke-width
Tipo de entrada: number optional
Tipo de saída: number optional
A largura do traço em pixels.
Atributo HTML: stroke-width="number"
zIndex
attr: z-index
Tipo de entrada: number optional
Tipo de saída: number optional
O zIndex comparado a outras polilinhas/polígonos.
Atributo HTML: z-index="number"
outerCoordinates
A sequência ordenada de coordenadas que designam um loop fechado. A altitude é ignorada em determinados 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 recortes dentro dele.
Herdado: addEventListener, removeEventListener

Interface Polygon3DElementOptions

Interface google.maps.maps3d.Polygon3DElementOptions

Objeto Polygon3DElementOptions usado para definir as propriedades que podem ser definidas em um Polygon3DElement.

altitudeMode
opcional
Tipo: AltitudeMode optional
AlphaautofitsCamera
opcional
Tipo: boolean optional
drawsOccludedSegments
opcional
Tipo: boolean optional
extruded
opcional
Tipo: boolean optional
fillColor
opcional
Tipo: string optional
geodesic
opcional
Tipo: boolean optional
innerCoordinates
opcional
innerPaths
opcional
outerCoordinates
opcional
path
opcional
strokeColor
opcional
Tipo: string optional
strokeWidth
opcional
Tipo: number optional
zIndex
opcional
Tipo: number optional

Classe Polygon3DInteractiveElement

google.maps.maps3d.Polygon3DInteractiveElement class
extends Polygon3DElement
implements Polygon3DInteractiveElementOptions
library "maps3d"

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.

<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>
const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d");
Polygon3DInteractiveElement
Polygon3DInteractiveElement([options])
Parâmetros:
Cria um Polygon3DInteractiveElement com as opções especificadas.
Herdado: altitudeMode, AlphaautofitsCamera (attr: autofits-camera), drawsOccludedSegments (attr: draws-occluded-segments), extruded (attr: extruded), fillColor (attr: fill-color), geodesic (attr: geodesic), innerPaths, path (attr: path), strokeColor (attr: stroke-color), strokeWidth (attr: stroke-width), zIndex (attr: z-index), outerCoordinates, innerCoordinates
Herdado: addEventListener, removeEventListener
gmp-click
function(clickEvent)
Argumentos:
  • clickEvent: LocationClickEvent optional o objeto de evento vai conter o local de latitude, longitude e altitude do clique.
Esse evento é acionado quando o elemento Polygon3DInteractiveElement é clicado.

Interface Polygon3DInteractiveElementOptions

google.maps.maps3d.Polygon3DInteractiveElementOptions interface
extends Polygon3DElementOptions

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

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

Classe FlattenerElement

google.maps.maps3d.FlattenerElement class
extends HTMLElement
implements FlattenerElementOptions
library "maps3d"

Um elemento de nivelamento é usado para nivelar uma área especificada no mapa.

<gmp-flattener
  path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ...">
</gmp-flattener>
const {FlattenerElement} = await google.maps.importLibrary("maps3d");
FlattenerElement
FlattenerElement([options])
Parâmetros:
innerPaths
Tipo de entrada: Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional
Tipo de saída: Array<Array<LatLngAltitude>> optional
A sequência ordenada de coordenadas que designam um loop fechado. Esses caminhos definem furos de exclusão no caminho principal do polígono, que é a zona de nivelamento. As áreas dentro de um innerPath estão isentas de nivelamento.
path
attr: path
Tipo de entrada: Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional
Tipo de saída: Array<LatLngAltitude> optional
A sequência ordenada de coordenadas que designam um loop fechado. Esse ciclo define a Zona de Nivelamento.
Atributo HTML: path="lat1,lng1,altitude1 lat2,lng2,altitude2 lat3,lng3,altitude3 ..."
Herdado: addEventListener, removeEventListener

Interface FlattenerElementOptions

Interface google.maps.maps3d.FlattenerElementOptions

Objeto FlattenerElementOptions usado para definir as propriedades que podem ser definidas em um FlattenerElement.

innerPaths
opcional
path
opcional

Classe PopoverElement

google.maps.maps3d.PopoverElement class
extends HTMLElement
implements PopoverElementOptions
library "maps3d"

Um elemento HTML personalizado que renderiza um popover. Ele se parece com um balão e geralmente está conectado a um marcador.

<gmp-popover
  auto-pan-disabled
  light-dismiss-disabled
  open
  position-anchor="lat,lng">
</gmp-popover>
const {PopoverElement} = await google.maps.importLibrary("maps3d");
PopoverElement
PopoverElement([options])
Parâmetros:
altitudeMode
Tipo de entrada: AltitudeMode optional
Tipo de saída: AltitudeMode
Especifica como o componente de altitude da posição é interpretado.
autoPanDisabled
attr: auto-pan-disabled
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Se definido como verdadeiro, desativa a movimentação do mapa para que o popover fique totalmente visível quando for aberto.
Atributo HTML: auto-pan-disabled
lightDismissDisabled
attr: light-dismiss-disabled
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Especifica se esse popover deve ser "dispensado de forma leve" ou não. O comportamento de "dispensa leve" é semelhante à configuração do atributo popover="auto", que faz parte da API Popover do navegador.
Atributo HTML: light-dismiss-disabled
open
attr: open
Tipo de entrada: boolean optional
Tipo de saída: boolean
Padrão: false
Especifica se esse popover deve ser aberto ou não.
Atributo HTML: open
positionAnchor
attr: position-anchor
A posição em que o popover será exibido. Se o popover estiver fixado em um marcador interativo, a posição do marcador será usada.
Atributo HTML:
  • position-anchor="lat,lng"
  • position-anchor="lat,lng,altitude"
  • position-anchor="marker-id"
default
Coloca o conteúdo com slot na seção principal do popover.
header
Coloca o conteúdo com slot na seção de cabeçalho do popover.
--gmp-popover-max-width
Largura máxima do popover, independentemente da largura do conteúdo.
--gmp-popover-min-width
Largura mínima do popover, independentemente 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 em relação ao ponto no mapa em que as coordenadas geográficas do popover estão ancoradas.
--gmp-popover-pixel-offset-y
O deslocamento no eixo y, em pixels, da ponta do popover em relação ao ponto no mapa em que as coordenadas geográficas do popover estão ancoradas.
background-color
A cor de fundo do popover. Consulte a documentação do background-color para mais detalhes. O popover de lugar padrão também é afetado por essa propriedade. Use classes CSS segmentadas ou estilos inline em popovers personalizados para evitar estilizar o popover de lugar padrão.
border-radius
O raio da borda do popover. Consulte a documentação do border-radius para mais detalhes. O popover de lugar padrão também é afetado por essa propriedade. Use classes CSS segmentadas ou estilos inline em popovers personalizados para evitar estilizar o popover de lugar padrão.
box-shadow
A sombra da caixa do popover. Consulte a documentação do box-shadow para mais detalhes. O popover de lugar padrão também é afetado por essa propriedade. Use classes CSS segmentadas ou estilos inline em popovers personalizados para evitar estilizar o popover de lugar padrão.
color-scheme
Indica em qual esquema de cores esse 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.
padding
O padding do popover. Consulte a documentação do padding para mais detalhes. O popover de lugar padrão também é afetado por essa propriedade. Use classes CSS segmentadas ou estilos inline em popovers personalizados para evitar estilizar o popover de lugar padrão.
Herdado: addEventListener, removeEventListener

Interface PopoverElementOptions

Interface google.maps.maps3d.PopoverElementOptions

Objeto PopoverElementOptions usado para definir as propriedades que podem ser definidas em um PopoverElement.

altitudeMode
opcional
Tipo: AltitudeMode optional
autoPanDisabled
opcional
Tipo: boolean optional
lightDismissDisabled
opcional
Tipo: boolean optional
open
opcional
Tipo: boolean optional
positionAnchor
opcional

Constantes AltitudeMode

google.maps.maps3d.AltitudeMode biblioteca de constantes
"maps3d"

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

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo AltitudeModeString.

const {AltitudeMode} = await google.maps.importLibrary("maps3d");
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, independentemente 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 à superfície mais alta de solo + edifício + superfície da água. Quando estiver sobre a água, será a superfície da água. Quando estiver sobre o terreno, será a superfície do edifício (se houver) ou do solo (se não houver edifícios).

Classe CirclePathElement

google.maps.maps3d.CirclePathElement class
extends HTMLElement
implements CirclePathElementOptions
library "maps3d"

Uma sobreposição de círculo 3D em um mapa 3D.

 
<gmp-circle-path
  center="lat,lng,altitude"
  radius="number">
</gmp-circle-path>
const {CirclePathElement} = await google.maps.importLibrary("maps3d");
CirclePathElement
CirclePathElement([options])
Parâmetros:
Cria um CirclePathElement com as opções especificadas.
center
attr: center
Tipo de entrada: LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral optional
Tipo de saída: LatLngAltitude optional
O centro do círculo.
Atributo HTML: center="lat,lng,altitude"
radius
attr: radius
Tipo de entrada: number optional
Tipo de saída: number optional
O raio do círculo em metros.
Atributo HTML: radius="number"
Herdado: addEventListener, removeEventListener

Interface CirclePathElementOptions

Interface google.maps.maps3d.CirclePathElementOptions

Objeto CirclePathElementOptions usado para definir as propriedades que podem ser definidas em um CirclePathElement.

center
opcional
radius
opcional
Tipo: number optional