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, con los elementos que se encuentran sobre el suelo (como edificios) o con 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 de la Tierra. Además, AltitudeMode controla dónde
se posiciona la cámara durante las animaciones flyCameraTo y flyCameraAround.
En la siguiente guía, se proporciona información para usar AltitudeMode de manera eficaz y consideraciones sobre los factores que afectan la renderización de los elementos.
Modelos de elevación digital
La ubicación de los componentes se rige por dos modelos digitales de elevación (DEM) subyacentes a los que se puede acceder en la API:
- Modelo digital del terreno (DTM) / "Suelo": Es una vista de la "Tierra sin vegetación" que muestra la elevación del terreno subyacente, sin los objetos que se encuentran sobre el suelo.
- Modelo de superficie digital (DSM) / "malla": Es una representación de la superficie que incluye la elevación del terreno y los elementos que se encuentran sobre el suelo, como edificios y árboles.
En la siguiente imagen, se muestra la diferencia entre las renderizaciones de DTM y DSM de un área urbana:
AltitudeMode opciones
La elección de AltitudeMode determina cómo se interpreta el valor de altitud del elemento (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.
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
a 100 metros por encima del MTD o el MDS.
Si los datos de los componentes no incluyen una altitud, un modo relativo como
RELATIVE_TO_MESH colocará el componente directamente sobre la malla o la superficie.
Sin embargo, en el caso de 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.