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 elementos 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. Além disso, AltitudeMode controla onde a câmera é posicionada durante as animações flyTo e flyAround.

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

Modelos de elevação digital

A posição dos elementos é determinada por dois modelos digitais de elevação (DEMs, na sigla em inglês) acessíveis na API:

  • Modelo digital de terreno (DTM) / "Solo": uma visualização de "terra nua" que mostra a elevação do terreno, com os objetos acima do solo removidos.
  • Modelo de superfície digital (DSM) / "Malha": uma representação de superfície que inclui a elevação do terreno e elementos 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 as visualizações lado a lado do DTM e do DSM da Torre Eiffel e de Paris

AltitudeMode opções

A escolha de AltitudeMode determina como o valor de altitude do elemento (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 (Mesh), a superfície mais alta, incluindo solo, edifícios e água.

O exemplo a seguir permite mudar o AltitudeMode de uma polilinha para observar como vários modos afetam a renderização dela em uma geometria complexa em um ambiente semiurbano:

Valores de altitude em modos relativos

Ao usar os 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 elemento 100 metros acima do DTM ou DSM.

Se os dados do elemento não incluírem uma altitude, um modo relativo como RELATIVE_TO_MESH vai colocar o elemento diretamente sobre a 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