Cómo comprender y usar los modos de altitud

AltitudeMode es la propiedad que define la posición vertical de un elemento del mapa. Determina si un objeto se renderiza en relación con el terreno, en relación con las funciones sobre el nivel del suelo (como edificios) o a una altura absoluta sobre el nivel del mar.

AltitudeMode es la propiedad que determina dónde se renderizan los elementos que agregas al mapa 3D, como marcadores, polilíneas, polígonos y modelos, en relación con la superficie de la Tierra. Además, AltitudeMode controla dónde se posiciona la cámara durante las animaciones flyTo y flyAround.

En la siguiente guía, se proporciona información para usar AltitudeMode de manera eficaz y consideraciones sobre los factores que afectan la forma en que se renderizan los elementos.

Modelos de elevación digital

La posición de las funciones se rige por dos modelos de elevación digital (DEM) subyacentes a los que se puede acceder en la API:

• Modelo digital del terreno (DTM) / "Suelo": Una vista de "tierra desnuda" que muestra la elevación del terreno subyacente, con los objetos sobre el nivel del suelo quitados.
• Modelo digital de superficie (DSM) / "Malla": Una representación de la superficie que incluye la elevación del terreno, además de funciones sobre el nivel del suelo, como edificios y árboles.

En la siguiente imagen, se muestra la diferencia entre las renderizaciones de DTM y DSM de un área urbana:

Opciones de AltitudeMode

La elección de AltitudeMode determina cómo se interpreta el valor de altitud de la función (si se proporciona) en relación con los modelos de elevación digital.

• ABSOLUTE: Renderiza el objeto en relación con el nivel medio del mar, calculado con EGM96.
• CLAMP_TO_GROUND: Renderiza el objeto directamente en el DTM (suelo), ignora cualquier altitud proporcionada y sigue el terreno.
• RELATIVE_TO_GROUND: Renderiza el objeto en relación con la superficie del DTM (suelo).
• RELATIVE_TO_MESH: Renderiza el objeto en relación con el DSM (malla), la superficie más alta, incluidos el suelo, los edificios y el agua.

La siguiente muestra te permite cambiar el AltitudeMode de una polilínea para observar cómo los distintos modos afectan la renderización de la polilínea en una geometría compleja en un entorno semiurbano:

Valores de altitud en modos relativos

Cuando se usan modos relativos (RELATIVE_TO_GROUND o RELATIVE_TO_MESH), el valor de altitud proporcionado es un desplazamiento de la superficie base elegida, no una altura fija sobre el nivel del mar. Por ejemplo, una altitud de 100 colocará la función 100 metros por encima del DTM o DSM.

Si los datos de la función no incluyen una altitud, un modo relativo como RELATIVE_TO_MESH colocará la función directamente sobre la malla o la superficie. Sin embargo, para las polilíneas y los polígonos, las conexiones entre los puntos serán líneas rectas, lo que podría hacer que la línea pase por la malla entre los puntos si no usas la interpolación.

Próximos pasos

• Lee el tema del Centro de arquitectura para obtener una descripción general más detallada de AltitudeMode, incluida información sobre AltitudeMode y marcadores.