Configurare i controlli della videocamera

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 in modo programmatico.

Posizione della 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 dalle coordinate di latitudine/longitudine/altitudine, dall'orientamento, dall'inclinazione, dall'intervallo e dalla rotazione.

Latitudine, longitudine, altitudine

La posizione iniziale della videocamera viene definita impostando la latitudine, la longitudine e l'altitudine. Questi valori si combinano per determinare la posizione della videocamera, non il punto verso cui è rivolta o su cui è 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 al valore più vicino all'interno di questo intervallo. Ad esempio, se specifichi una latitudine di 100, il valore verrà impostato su 90.

Orientamento

L'orientamento 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 significa che la videocamera è rivolta verso il basso verso la Terra (nadir). Un'inclinazione di 90 gradi significa che la videocamera è rivolta orizzontalmente nella direzione specificata dall'orientamento.

Intervallo

L'intervallo definisce la distanza in metri tra la posizione della videocamera e il centro della mappa. L'intervallo può variare da zero metri (molto vicino) fino a sessantatré milioni di metri, consentendo visualizzazioni da molto vicino fino a una prospettiva veramente globale. Questo controlla efficacemente il livello di zoom della mappa.

Rotazione

La rotazione imposta l'angolo della videocamera rispetto all'orizzonte, misurato 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

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