Entender e usar os modos de altitude

AltitudeMode é a propriedade que define o posicionamento vertical de um elemento do mapa. Ele determina se um objeto é renderizado em relação ao terreno, a recursos acima do solo (como edifícios) ou a uma altura absoluta acima do nível do mar.

AltitudeMode é a propriedade que determina onde os elementos adicionados ao mapa 3D, como marcadores, polilinhas, polígonos e modelos, são renderizados em relação à superfície da Terra.

O guia a seguir fornece informações sobre como usar AltitudeMode de maneira eficaz e considerações sobre fatores que afetam a renderização dos elementos.

Modelos digitais de elevação

O posicionamento de recursos é regido por dois modelos digitais de elevação (MDEs) acessíveis na API:

  • Modelo digital de terreno (DTM) / "Solo": uma visualização da superfície da Terra mostrando a elevação do terreno subjacente, com objetos acima do solo removidos.
  • Modelo digital de superfície (DSM) / "Mesh": uma representação da superfície que inclui a elevação do terreno e recursos acima do solo, como edifícios e árvores.

A imagem a seguir mostra a diferença entre as renderizações de DTM e DSM de uma área urbana:

Imagem mostrando vistas lado a lado de DTM e DSM da Torre Eiffel e de Paris

AltitudeMode opções

A escolha de AltitudeMode determina como o valor de altitude do recurso (se fornecido) é interpretado em relação aos modelos digitais de elevação.

  • ABSOLUTE: renderiza o objeto em relação ao nível médio do mar, calculado usando o EGM96.
  • CLAMP_TO_GROUND: renderiza o objeto diretamente no DTM (solo), ignorando qualquer altitude fornecida e seguindo o terreno.
  • RELATIVE_TO_GROUND: renderiza o objeto em relação à superfície do DTM (solo).
  • RELATIVE_TO_MESH: renderiza o objeto em relação ao DSM (malha), a superfície mais alta, incluindo solo, edifícios e água.

Com o exemplo a seguir, é possível mudar o AltitudeMode de uma polilinha para observar como vários modos afetam a renderização da polilinha em uma geometria complexa em um ambiente semiurbano:

Valores de altitude em modos relativos

Ao usar modos relativos (RELATIVE_TO_GROUND ou RELATIVE_TO_MESH), o valor de altitude fornecido é um deslocamento da superfície de base escolhida, não uma altura fixa acima do nível do mar. Por exemplo, uma altitude de 100 vai colocar o recurso 100 metros acima do DTM ou DSM.

Se os dados de atributos não incluírem uma altitude, um modo relativo como RELATIVE_TO_MESH vai colocar o atributo diretamente em cima da malha/superfície. No entanto, para polilinhas e polígonos, as conexões entre pontos serão linhas retas, o que pode fazer com que a linha passe pela malha entre os pontos se você não usar a interpolação.

Próximas etapas