Gli utenti possono controllare lo zoom, l'inclinazione, la posizione e la rotazione della fotocamera utilizzando i gesti sulla mappa. Puoi anche configurare la videocamera in modo programmatico.
Posizione della videocamera
La visualizzazione mappa è modellata come una fotocamera che guarda un punto specifico in uno spazio 3D. La posizione e l'orientamento della fotocamera (e quindi il rendering della mappa) sono specificati dalle seguenti proprietà: centro (una posizione di latitudine/longitudine/altitudine verso la quale è rivolta la fotocamera), rotta, inclinazione, intervallo e roll.
Centro (latitudine/longitudine/altitudine)
Il centro definisce il punto specifico nello spazio 3D osservato dalla videocamera.
Questo viene specificato utilizzando la classe LatLngAltitude,
che combina i valori di latitudine, longitudine e altitudine. Ciò consente di posizionare con precisione il punto focale della fotocamera in tre dimensioni.
La latitudine può essere compresa tra -90 e 90 gradi, inclusi. La longitudine pu' assumere valori compresi tra -180 e 180 gradi, inclusi. L'altitudine è specificata in metri sul livello del mare.
Titolo
L'orientamento della fotocamera specifica la direzione in cui la fotocamera sarà rivolta, misurata in gradi in senso orario dal vero nord. Il nord corrisponde a 0 gradi, l'est a 90 gradi, il sud a 180 gradi e l'ovest a 270 gradi. Questo determina l'orientamento della fotocamera intorno all'asse verticale del punto centrale.
Inclinazione
L'inclinazione specifica l'angolo della fotocamera rispetto all'asse verticale, misurato in gradi. Un'inclinazione di 0 gradi indica che la fotocamera è rivolta verso il basso, verso la Terra (nadir). Un'inclinazione di 90 gradi indica che la fotocamera è rivolta orizzontalmente nella direzione specificata dall'orientamento.
Intervallo
L'intervallo definisce la distanza in metri tra la posizione della videocamera e il punto centrale che sta guardando. L'intervallo può variare da zero metri (molto vicino) fino a sessantatre milioni di metri, consentendo di visualizzare immagini da molto vicino fino a una prospettiva davvero globale. In questo modo puoi controllare efficacemente l'entità dello zoom della mappa.
Rotazione
L'inclinazione imposta l'angolo della fotocamera rispetto all'orizzonte, misurato in gradi. Questo parametro può essere utilizzato per creare effetti come l'inclinazione durante le simulazioni di volo o persino un tonneau completo, ruotando la fotocamera attorno al suo asse di visualizzazione.
Controllare la videocamera
Il seguente esempio di codice mostra come controllare la videocamera
in modo programmatico chiamando il metodo
setCamera.
Per utilizzare questo esempio di codice, segui le istruzioni riportate in Configurazione e Aggiungi una mappa 3D alla tua app per configurare il progetto Android Studio con una mappa 3D di base. Aggiungi poi il seguente
codice al
file MainActivity.kt:
// Add imports import com.google.android.gms.maps3d.model.latLngAltitude ... // Add to the onMap3DViewReady method, after the googleMap3D object has been initialized googleMap3D.setCamera( camera { center = latLngAltitude { latitude = 38.743502 longitude = -109.499374 altitude = 1467.0 } heading = 350.0 tilt = 58.1 range = 138.2 roll = 0.0 } )