Comprendere e utilizzare le modalità di altitudine

AltitudeMode è la proprietà che definisce il posizionamento verticale di un elemento della mappa. Determina se un oggetto viene visualizzato rispetto al terreno, rispetto a elementi fuori terra (come gli edifici) o a un'altezza assoluta sopra il livello del mare.

AltitudeMode è la proprietà che determina la posizione in cui vengono visualizzati gli elementi che aggiungi alla mappa 3D, come indicatori, polilinee, poligoni e modelli, rispetto alla superficie terrestre.

La seguente guida fornisce informazioni sull'utilizzo efficace di AltitudeMode e considerazioni sui fattori che influiscono sul rendering degli elementi.

Modelli digitali di elevazione

Il posizionamento delle funzionalità è regolato da due modelli digitali di elevazione (DEM) sottostanti accessibili nell'API:

  • Modello digitale del terreno (DTM) / "Terreno": una visualizzazione "bare-earth" che mostra l'elevazione del terreno sottostante, con gli oggetti fuori terra rimossi.
  • Modello digitale della superficie (DSM) / "Mesh": una rappresentazione della superficie che include l'elevazione del terreno più elementi fuori terra come edifici e alberi.

La seguente immagine mostra la differenza tra i rendering DTM e DSM di un'area urbana:

Immagine che mostra le visualizzazioni DTM e DSM affiancate della Torre Eiffel e di Parigi

AltitudeMode opzioni

La scelta di AltitudeMode determina come viene interpretato il valore di altitudine della funzionalità (se fornito) rispetto ai modelli digitali di elevazione.

  • ABSOLUTE: esegue il rendering dell'oggetto rispetto al livello medio del mare, calcolato utilizzando EGM96.
  • CLAMP_TO_GROUND: esegue il rendering dell'oggetto direttamente sul DTM (Ground), ignorando qualsiasi altitudine fornita e seguendo il terreno.
  • RELATIVE_TO_GROUND: esegue il rendering dell'oggetto rispetto alla superficie DTM (terreno).
  • RELATIVE_TO_MESH: esegue il rendering dell'oggetto rispetto al DSM (mesh), ovvero la superficie più alta, inclusi terreno, edifici e acqua.

L'esempio seguente ti consente di modificare AltitudeMode di una polilinea per osservare come le varie modalità influiscono sul rendering della polilinea su una geometria complessa in un contesto semiurbano:

Valori di altitudine nelle modalità relative

Quando utilizzi le modalità relative (RELATIVE_TO_GROUND o RELATIVE_TO_MESH), il valore di altitudine fornito è un offset dalla superficie di base scelta, non un'altezza fissa sopra il livello del mare. Ad esempio, un'altitudine di 100 posizionerà la funzionalità 100 metri sopra il DTM o il DSM.

Se i dati della funzionalità non includono un'altitudine, una modalità relativa come RELATIVE_TO_MESH posizionerà la funzionalità direttamente sopra la mesh/superficie. Tuttavia, per le polilinee e i poligoni, i collegamenti tra i punti saranno linee rette, il che potrebbe far passare la linea attraverso la mesh tra i punti se non utilizzi l'interpolazione.

Passaggi successivi