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 dimostri l'API Geospatial.

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

Consulta l'introduzione all'API ARCore Geospatial per ulteriori informazioni sull'API Geospatial.

Se è la prima volta che sviluppi con ARCore, consulta la Guida introduttiva.

Requisiti

Assistenza per i dispositivi

Consulta la sezione Dispositivi supportati per un elenco completo dei dispositivi certificati per l'utilizzo con ARCore. Per l'API Geospatial, una delle componenti principali dell'hardware richiesto è un magnetometro che soddisfi le specifiche dell'API Geospatial. Alcuni magnetometri non soddisfano le specifiche; i dispositivi con questi magnetometri non conformi alle specifiche non sono supportati.

Software

  • La versione più recente di Google Play Services per AR installata sul dispositivo supportato.

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

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

    • Scaricala da GitHub ed estraila 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, nel menu File, fai clic su Apri.

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

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

Configura un progetto Google Cloud

Per utilizzare il sistema di posizionamento visivo (VPS), la tua app deve essere associata a un progetto Google Cloud abilitato per l'API ARCore. Vedi Utilizzare l'API ARCore su Google Cloud per configurare l'autorizzazione. Puoi scegliere tra autorizzazione senza chiave o chiave 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 la posizione geospaziale attuale del dispositivo. Mentre esplori l'ambiente circostante, noti che i valori di affidabilità della precisione del posizionamento possono cambiare mentre ti sposti, se ti trovi in un'area supportata dalla localizzazione VPS.

Quando ARCore riconosce la posizione e la direzione del dispositivo, puoi posizionare un ancoraggio nella tua posizione corrente utilizzando la posa geospaziale.

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

Per regolare le soglie:

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

    // 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 è la precisione.

    La riduzione della precisione consente all'app di avere una latitudine maggiore nel posizionamento dell'ancoraggio. Per ulteriori informazioni, vedi Regolare per precisione della posa.

Passaggi successivi