AltitudeMode è la proprietà che definisce il posizionamento verticale di un elemento della mappa.
Determina se un oggetto viene sottoposto a rendering rispetto al terreno, rispetto alle funzionalità 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 sottoposti a rendering 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 flyCameraTo e flyCameraAround.
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ù le funzionalità fuori terra come edifici e alberi.
L'immagine seguente mostra la differenza tra i rendering DTM e DSM di un'area urbana:
Opzioni AltitudeMode
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 (terreno), ignorando l'altitudine fornita e seguendo il rilievo.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), la superficie più alta, inclusi terreno, edifici e acqua.
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à a 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 polilinee e poligoni, le connessioni tra i punti saranno linee rette, il che potrebbe far passare la linea attraverso la mesh tra i punti se non utilizzi l'interpolazione.