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 estructuras sobre el nivel del suelo (como los 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 en 3D, como marcadores, polilíneas, polígonos y modelos, en relación con la superficie terrestre.

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

Modelos digitales de elevación

La colocación de las funciones se rige por dos Modelos Digitales de Elevación (MDE) subyacentes a los que se puede acceder en la API:

  • Modelo digital del terreno (DTM) o "Suelo": Es una vista de "tierra desnuda" que muestra la elevación del terreno subyacente, sin objetos sobre el nivel del suelo.
  • Modelo de superficie digital (DSM) o "malla": Es una representación de la superficie que incluye la elevación del terreno y los elementos sobre el nivel del suelo, como edificios y árboles.

En la siguiente imagen, se muestra la diferencia entre las renderizaciones del MTD y el MDS de un área urbana:

Imagen que muestra vistas comparativas del DTM y el DSM de la Torre Eiffel y París

AltitudeMode opciones

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 digitales de elevación.

  • 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 (tierra), ignora cualquier altitud proporcionada y sigue el terreno.
  • RELATIVE_TO_GROUND: Renderiza el objeto en relación con la superficie del DTM (tierra).
  • 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.

En el siguiente ejemplo, puedes 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 desde la superficie base elegida, no una altura fija sobre el nivel del mar. Por ejemplo, una altitud de 100 colocará el elemento 100 metros por encima del MTD o el MDV.

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