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 agli 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 dove
viene posizionata la 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'elevazione del terreno sottostante, con gli oggetti sopra il suolo rimossi.
- 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 in relazione 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 terreno.RELATIVE_TO_GROUND: esegue il rendering dell'oggetto in relazione alla superficie del DTM (terreno).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.