Configurare i controlli della videocamera

Seleziona la piattaforma: Android iOS JavaScript

Gli utenti possono controllare lo zoom, l'inclinazione, la posizione e la rotazione della videocamera utilizzando i gesti sulla mappa. Puoi anche configurare la videocamera a livello di programmazione.

Diagramma che illustra il modello di fotocamera 3D

Posizione videocamera

La visualizzazione della mappa è modellata come una videocamera che guarda un punto specifico nello spazio. La posizione e l'orientamento della videocamera sono definiti da coordinate di latitudine/longitudine/altitudine, direzione, inclinazione, raggio e rollio.

Latitudine, longitudine, altitudine

La posizione iniziale della videocamera è definita impostando latitudine, longitudine e altitudine. Questi valori si combinano per determinare la posizione della videocamera, non la direzione in cui è puntata o centrata.

La latitudine può essere compresa tra -90 e 90 gradi inclusi. La longitudine è compresa tra -180 e 180 gradi inclusi. L'altitudine è specificata in metri sopra il livello del mare.

I valori superiori o inferiori a questo intervallo verranno bloccati sul valore più vicino all'interno di questo intervallo. Ad esempio, se specifichi una latitudine di 100, il valore verrà impostato su 90.

Intestazione

La direzione specifica la direzione della bussola della mappa, misurata in gradi in senso orario rispetto al nord geografico. Il nord corrisponde a 0 gradi, l'est a 90 gradi, il sud a 180 gradi e l'ovest a 270 gradi.

Inclinazione

L'inclinazione specifica l'angolo della videocamera rispetto all'asse verticale, misurato in gradi. Un'inclinazione di 0 gradi indica che la videocamera è puntata verso il basso, verso la Terra (nadir). Un'inclinazione di 90 gradi indica che la videocamera è puntata orizzontalmente nella direzione specificata dalla direzione.

Intervallo

L'intervallo definisce la distanza in metri tra la posizione della videocamera e il centro della mappa. Il raggio può variare da zero metri (primo piano) fino a 63 milioni di metri, consentendo viste da molto vicino fino a una prospettiva davvero globale. In questo modo, puoi controllare in modo efficace il livello di zoom della mappa.

Rotazione

Il rollio imposta l'angolazione della videocamera rispetto all'orizzonte, misurata in gradi. Questo parametro può essere utilizzato per creare effetti come l'inclinazione durante le simulazioni di volo o persino una rotazione completa, ruotando la videocamera attorno al suo asse di visualizzazione.

Controllare la videocamera

Il seguente esempio di codice mostra come controllare la videocamera in modo programmatico.

Swift


public static var sanFrancisco: Camera = .init(
  latitude: 37.7845812,
  longitude: -122.3660241,
  altitude: 585,
  heading: 288.0,
  tilt: 75.0,
  roll: 0.0,
  range: 100)