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. Inoltre, AltitudeMode controlla la posizione della videocamera durante le animazioni flyTo e flyAround.

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 rilievo.
  • RELATIVE_TO_GROUND: esegue il rendering dell'oggetto rispetto alla superficie DTM (Ground).
  • 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 in che modo 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