Abilita l'API Geospatial per la tua app per iOS

Configura le impostazioni dell'app in modo che possa utilizzare l'API Geospatial.

Prerequisiti

Prima di procedere, assicurati di conoscere i concetti fondamentali dell'AR e come configurare una sessione ARCore.

Se vuoi eseguire un'app di esempio che dimostri la funzionalità descritta qui, consulta la guida rapida ARCore Geospatial per iOS.

Per ulteriori informazioni sull'API Geospatial, consulta la Introduzione all'API Geospatial.

Se non hai mai sviluppato con ARCore, consulta la sezione Introduzione per informazioni sui requisiti hardware e software, sui prerequisiti e su altre informazioni specifiche per le piattaforme in uso.

Attiva l'API ARCore

Prima di utilizzare il sistema di posizionamento visivo (VPS) nella tua app, devi prima attivare l'API ARCore in un progetto Google Cloud nuovo o esistente. Questo servizio è responsabile dell'hosting, dello stoccaggio e della risoluzione degli ancoraggi geospaziali.

L'autorizzazione senza chiave è preferita, ma è supportata anche l'autorizzazione con chiave API.

Aggiungi le librerie richieste alla tua app

Dopo aver autorizzato la tua app a chiamare l'API ARCore, devi aggiungere librerie per attivare le funzionalità geospaziali nella tua app.

Aggiorna il file Podfile per la tua app in modo da includere l'SDK ARCore e il versionamento iOS supportato. Per:

  1. Aggiungi i seguenti platform e pod al Podfile del progetto:

    platform :ios, '11.0'
pod 'ARCore/Geospatial', '~> 1.48.0'

    Puoi anche specificare platform :ios, '10.0', se vuoi supportare iOS 10, ma tieni presente che l'API Geospatial funzionerà in fase di runtime solo su iOS >= 11.

  2. Apri una finestra del terminale ed esegui pod install dalla cartella in cui si trova il progetto Xcode.

    Viene generato un file .xcworkspace che utilizzi per compilare e eseguire l'app.

Assicurati che l'ambiente di sviluppo soddisfi i requisiti dell'SDK ARCore, come descritto nella guida introduttiva.

Attivare le funzionalità geospaziali nella configurazione della sessione

Verificare la compatibilità del dispositivo

Non tutti i dispositivi che supportano ARCore supportano anche l'API Geospatial, come descritto nella guida introduttiva.

Utilizza GARSession.isGeospatialModeSupported: per controllare il dispositivo, come nell'esempio seguente:

if (![self.garSession isGeospatialModeSupported:GARGeospatialModeEnabled]) {
  [self setErrorStatus:@"GARGeospatialModeEnabled is not supported on this device."];
  return;
}

GARSessionConfiguration *configuration = [[GARSessionConfiguration alloc] init];
configuration.geospatialMode = GARGeospatialModeEnabled;
[self.garSession setConfiguration:configuration error:&error];
if (error) {
  [self setErrorStatus:[NSString stringWithFormat:@"Failed to configure GARSession: %d",
                                                  (int)error.code]];
  return;
}

Chiedere all'utente le autorizzazioni di accesso alla posizione in fase di esecuzione

L'app deve richiedere le seguenti autorizzazioni di accesso alla posizione in fase di esecuzione, prima di configurare la sessione:

Controllare la disponibilità geospaziale nella posizione attuale del dispositivo

Poiché l'API Geospatial utilizza una combinazione di VPS e GPS per determinare una trasformazione geospaziale, può essere utilizzata purché il dispositivo sia in grado di determinare la propria posizione. Nelle aree con scarsa precisione del GPS, come spazi interni e ambienti urbani densi, l'API si basa sulla copertura VPS per generare trasformazioni ad alta precisione. In condizioni normali, ci si aspetta che il servizio VPS fornisca una precisione di posizionamento di circa 5 metri e una precisione di rotazione di 5 gradi. Utilizza GARSession.checkVPSAvailabilityAtCoordinate:completionHandler: per determinare se una determinata località ha copertura VPS.

L'API Geospatial può essere utilizzata anche nelle aree che non hanno copertura VPS. In ambienti esterni con poche o nessuna ostruzione sopraelevata, il GPS potrebbe essere sufficiente per generare una trasformazione con elevata precisione.

Passaggi successivi