AltitudeMode è la proprietà che definisce il posizionamento verticale di un elemento della mappa.
Determina se un oggetto viene visualizzato in relazione al terreno, in relazione a elementi sopra il livello del suolo (come gli edifici) o a un'altezza assoluta sopra il livello del mare.
AltitudeMode è la proprietà che determina dove 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 flyCameraTo e flyCameraAround.
La seguente guida fornisce informazioni su come utilizzare AltitudeMode in modo efficace e considerazioni sui fattori che influiscono sul rendering degli elementi.
Modelli digitali di elevazione
Il posizionamento degli elementi è regolato da due modelli di elevazione digitale (DEM) sottostanti accessibili nell'API:
- Modello digitale del terreno (DTM) / "Suolo": una visualizzazione "senza elementi" che mostra l'altitudine del terreno sottostante, senza gli oggetti sopra il suolo.
- Modello digitale della superficie (DSM) / "Mesh": una rappresentazione della superficie che include l'elevazione del terreno e gli elementi fuori terra, come edifici e alberi.
L'immagine seguente mostra la differenza tra i rendering DTM e DSM di un'area urbana:
AltitudeMode opzioni
La scelta di AltitudeMode determina il modo in cui il valore di altitudine della caratteristica (se fornito) viene interpretato in relazione 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 (suolo), ignorando l'altitudine fornita e seguendo il terreno.RELATIVE_TO_GROUND: esegue il rendering dell'oggetto rispetto alla superficie del DTM (suolo).RELATIVE_TO_MESH: esegue il rendering dell'oggetto in relazione al DSM (mesh), ovvero la superficie più alta, inclusi terreno, edifici e acqua.
Valori di altitudine in modalità relative
Quando utilizzi le modalità relative (RELATIVE_TO_GROUND o RELATIVE_TO_MESH), il valore di altitudine fornito è un offset rispetto alla superficie di base scelta, non un'altezza fissa sul livello del mare. Ad esempio, un'altitudine di 100 posizionerà l'elemento
100 metri sopra il DTM o il DSM.
Se i dati della caratteristica non includono un'altitudine, una modalità relativa come RELATIVE_TO_MESH posizionerà la caratteristica direttamente sopra la mesh/superficie.
Tuttavia, per polilinee e poligoni, i collegamenti tra i punti saranno linee rette, il che potrebbe far sì che la linea passi attraverso la mesh tra i punti se non utilizzi l'interpolazione.