L'API Geospatial utilizza una combinazione di dati VPS e GPS per generare trasformazioni geospaziali ad alta precisione. L'API può essere utilizzata ovunque il dispositivo sia in grado di determinarne la posizione:
- Nelle aree con una scarsa precisione GPS, come gli spazi interni e gli ambienti urbani ad alta densità, l'API si baserà sulla copertura VPS per generare trasformazioni ad alta precisione.
- In ambienti esterni con poche ostruzioni aeree, l'API Geospatial potrebbe essere in grado di utilizzare i dati sulla posizione GPS disponibili per generare trasformazioni geospaziali con elevata precisione.
Puoi determinare la disponibilità dei VPS in una determinata posizione orizzontale prima dell'inizio della sessione AR e utilizzarla per creare esperienze più specifiche, ad esempio per presentare un "Entra in AR" solo quando VPS è disponibile.
Abilita l'API ARCore
La tua app deve abilitare l'API ARCore per verificare la disponibilità dei server VPS.
Verificare la disponibilità dei VPS nell'app
L'API Geospatial può essere utilizzata ovunque il dispositivo sia in grado di determinarne la posizione. Se la tua esperienza AR dipende dalla copertura dei servizi VPS, puoi utilizzare GARSession#checkVPSAvailabilityAtCoordinate:completionHandler:
per ottenere un'GARVPSAvailabilityFuture
, un'attività asincrona che verifica la disponibilità dei servizi VPS in una determinata posizione orizzontale.
Una volta ottenuto il GARVPSAvailabilityFuture
, puoi ottenerne il risultato mediante un sondaggio o una richiamata.
Sondaggio: il risultato
Utilizza GARFuture.state
per ottenere lo stato di Future
. Esistono tre stati diversi:
GARFutureStatePending
: l'operazione non è ancora stata completata, quindi non è noto alcun risultato.GARFutureStateCancelled
: l'operazione è stata annullata daGARFuture#cancel
. Qualsiasi callback registrato non verrà mai chiamato.GARFutureStateDone
: l'operazione è stata completata. UtilizzaGARVPSAvailabilityFuture.result
per ottenere il risultato.
Puoi continuare a controllare GARFuture.state
fino al completamento dell'attività.
Ottenere il risultato tramite una richiamata
Puoi anche ottenere il risultato di un Future
tramite un callback. Utilizza GARSession#checkVPSAvailabilityAtCoordinate:completionHandler:
e fornisci un completionHandler
. completionHandler
verrà chiamato nel thread principale poco dopo che Future
avrà lo stato GARFutureStateDone
.
Annulla Future
Utilizza GARFuture#cancel
per tentare di annullare Future
. A causa del parallelismo dei thread, potrebbe essere possibile che il tentativo di annullamento non vada a buon fine.
GARFuture#cancel
restituisce YES
se questo tentativo è andato a buon fine e NO
in caso contrario.
Usa l'API Geospatial senza copertura VPS
L'API Geospatial può essere utilizzata anche in aree che non hanno una copertura VPS. In ambienti esterni con poche ostruzioni dall'alto o nessuna, il GPS può essere sufficiente per generare una posa con un'elevata precisione.
Passaggi successivi
- Ottieni la posa geospaziale della fotocamera del dispositivo per determinare la posizione esatta del dispositivo dell'utente nel mondo reale.