Guida rapida Geospaziale per iOS

Questa guida rapida per l'API ARCore Geospatial mostra come eseguire un'app di esempio in Xcode che dimostra l'API Geospatial.

Per una guida allo sviluppo della tua app con l'API Geospatial, consulta la guida per gli sviluppatori Geospatial per iOS.

Consulta le Introduzione all'API ARCore Geospatial per ulteriori informazioni informazioni sull'API Geospatial.

Se non hai mai sviluppato ARCore, consulta la guida introduttiva.

Prerequisiti

  • Xcode 13.0 o versioni successive
  • Cocoapods 1.4.0 o versione successiva se utilizzi Cocoapods
  • Un dispositivo Apple compatibile con ARKit con iOS 12.0 o versioni successive (è richiesto un target di deployment di iOS 12.0 o versioni successive)

Configura l'app di esempio

Il progetto GeospatialExample incluso nell'SDK ARCore per iOS descrive il codice che chiama l'API Geospatial.

  1. Clona o scarica l'SDK ARCore per iOS da GitHub per ottenere il codice dell'app di esempio.

  2. Apri una finestra del Terminale o del Finder e vai alla cartella in cui hai clonato o scaricato l'SDK.

  3. Vai alla cartella arcore-ios-sdk-master/Examples.

  4. Apri la cartella Examples (Esempi), seleziona la cartella GeospatialExample (Esempio geografico) e fai clic su Apri.

Configura un progetto Google Cloud

Prima di utilizzare il sistema di posizionamento visivo (VPS) nella tua app, devi Abilitare l'API ARCore in un progetto Google Cloud nuovo o esistente. Sebbene l'API Geospatial funzioni sia senza chiave sia di autorizzazione delle chiavi API. Per questa guida rapida, utilizza l'API Metodo chiave.

Configura l'autorizzazione

Per effettuare chiamate API Geospaziali al server VPS, l'app di esempio richiede l'autorizzazione e può utilizzare una chiave API senza restrizioni. Se utilizzi una chiave API con restrizioni, devi inoltre fornisci un ID bundle da associare alla chiave API.

  1. In XCode, nell'app di esempio GeospatialExample, apri il file ViewController.m e cerca your-api-key.

  2. Aggiungi la tua chiave API a GARSession: incolla la chiave API che hai copiato da un passaggio precedente sul testo, your-api-key (lascia le virgolette), come mostrato:

    self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                                   bundleIdentifier:nil
                                              error:&error];
    

Configurare l'SDK ARCore

L'app GeospatialExample include un Podfile preconfigurato con L'SDK ARCore e le versioni di iOS necessarie. Per installare queste dipendenze, apri un finestra del terminale ed esegui pod install dalla cartella in cui è presente il progetto Xcode esiste già.

Viene generato un file .xcworkspace che utilizzerai in seguito per creare ed eseguire dell'app.

Crea ed esegui l'app di esempio

  1. In Xcode, seleziona il file dell'area di lavoro GeospatialExample e fai clic su Firma e Funzionalità.

  2. Seleziona la casella Gestisci automaticamente la firma.

  3. Nel campo Team, inserisci un nome per il team.

    Puoi utilizzare l'identificatore pacchetto predefinito per eseguire l'app da Xcode, ma devi modificarlo se usi GeospatialExample come stub per la tua dell'app in produzione.

  4. Connetti il dispositivo per eseguire l'app di esempio.

  5. Crea ed esegui l'app GeospatialExample dal file .xcworkspace per avvialo sul tuo dispositivo.

    Per evitare errori di generazione, assicurati di creare da .xcworkspace e non il file .xcodeproj.

Dovresti riuscire a vedere la visualizzazione della videocamera, insieme alle informazioni di debug che descrivono l'attuale trasformazione geospaziale del tuo dispositivo. Durante la scansione dell'ambiente intorno a te, noterai che i valori di confidenza dell'accuratezza del posizionamento spostarsi, se ti trovi in una zona supportata dalla localizzazione VPS.

Quando ARCore conosce la posizione e l'indirizzo del tuo dispositivo, puoi inserire un Effettua il ancoraggio alla tua posizione attuale utilizzando la trasformazione geospaziale.

La precisione di posizionamento potrebbe essere troppo bassa se le informazioni sui VPS non sono disponibili. La l'app deve essere connessa a internet e la posizione deve essere nota al VPS. Per risultati ottimali, esegui l'app di esempio all'esterno (non al chiuso) durante le ore diurne.

Inoltre, se ti trovi in un'area che non supporta VPS o se i segnali GPS non sono sufficienti, potresti dover modificare le soglie di attendibilità nell'app per inserire un'ancora.

Per regolare le soglie:

  1. In Xcode, apri il file ViewController.m e vai al file seguente sezione:

    // Thresholds for 'good enough' accuracy. These can be tuned for the
    // application. We use both 'low'
    // and 'high' values here to avoid flickering state changes.
    static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
    static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
    static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
    static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;
    
  2. Modifica questi valori in base alle tue esigenze. Più alto è il valore, minore è l'accuratezza.

    Se riduci la precisione, l'app ha una latitudine maggiore per il posizionamento di un ancoraggio. Consulta Regola per l'accuratezza delle trasformazioni per ulteriori informazioni.

Passaggi successivi

Esamina il Guida per gli sviluppatori geospaziali per iOS e iniziare a creare con l'API Geospatial.