Guida rapida ai dati geospaziali per Android

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

Per una guida allo sviluppo della tua app con l'API Geospatial, consulta la Guida per gli sviluppatori geospaziali per Android (Kotlin/Java) o il Guida per gli sviluppatori geospaziali per Android NDK (C).

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

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

Requisiti

Assistenza per i dispositivi

Consulta la sezione Dispositivi supportati per un elenco completo dei dispositivi che hai ottenuto la certificazione per funzionare con ARCore. Per l'API Geospatial, uno dei principali l'hardware necessario è un magnetometro che soddisfa i requisiti dell'API Geospatial specifiche. Alcuni magnetometri non soddisfano le specifiche; dispositivi con questi i magnetometri fuori specifica non sono supportati.

Software

  • L'ultima versione di Google Play Services per AR installata sul dispositivo supportato.

  • Android Studio 3.0 o versioni successive Con Android SDK Platform versione 7.0 (livello API 24) o versioni successive

  • L'SDK ARCore per Android, disponibile in due modi:

    • Scaricalo da GitHub ed estrarlo sulla tua macchina.

    • Clona il repository con il comando seguente: 

      git clone https://github.com/google-ar/arcore-android-sdk.git

Apri e configura l'app di esempio

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

  1. In Android Studio, fai clic su Apri nel menu File.

  2. Vai alla cartella del progetto per arcore-android-sdk.

  3. Apri la cartella samples, seleziona la cartella geospatial_java e fai clic su Apri.

Configura un progetto Google Cloud

Per usare il sistema di posizionamento visivo (VPS), la tua app deve essere associata a un progetto Google Cloud abilitato per l'API ARCore. Consulta Utilizzare l'API ARCore su Google Cloud per configurare l'autorizzazione. Puoi scegliere tra l'autorizzazione senza chiave o l'autorizzazione delle chiavi API.

Esegui l'app di esempio

In Android Studio, esegui l'app di esempio.

Dovresti riuscire a vedere la visualizzazione della videocamera, insieme alle informazioni di debug che descrivono l'attuale posa geospaziale del dispositivo. Mentre esegui la scansione dell'ambiente circostante, tieni presente che i valori di attendibilità della precisione del posizionamento possono cambiare mentre ti sposti, se ti trovi in un'area supportata dalla localizzazione VPS.

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

La precisione di posizionamento potrebbe essere troppo bassa se le informazioni sui VPS non sono disponibili. 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 supportati potrebbe essere necessario regolare le soglie di confidenza nell'app per per posizionare un ancoraggio.

Per regolare le soglie:

  1. In Android Studio, apri GeospatialActivity e vai alla seguente sezione:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

  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. Per ulteriori informazioni, consulta Aggiustare l'accuratezza della posa.

Passaggi successivi