Entender e usar os modos de altitude

AltitudeMode é a propriedade que define o posicionamento vertical de um elemento do mapa. Ela determina se um objeto é renderizado em relação ao terreno, em relação a recursos acima do solo (como edifícios) ou em 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 AltitudeMode de maneira eficaz e considerações sobre fatores que afetam a renderização de elementos.

Modelos digitais de elevação

O posicionamento de recursos é regido por dois modelos digitais de elevação (DEMs, na sigla em inglês) subjacentes acessíveis na API:

  • Modelo digital de terreno (DTM, na sigla em inglês) / "Solo": uma visualização de "terra nua" que mostra a elevação do terreno subjacente, com objetos acima do solo removidos.
  • Modelo digital de superfície (DSM, na sigla em inglês) / "Malha": uma representação de 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

Opções de AltitudeMode

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 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.

O exemplo a seguir permite mudar o AltitudeMode de uma polilinha para observar como vários modos afetam a renderização da polilinha em 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 posicionar o recurso 100 metros acima do DTM ou DSM.

Se os dados do recurso não incluírem uma altitude, um modo relativo como RELATIVE_TO_MESH vai posicionar o recurso diretamente na parte de 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