Risolvere i problemi relativi all'API Geospatial

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Occhiali XR con cavo
Audio e
occhiali con display

Se riscontri problemi con l'API Geospatial, ecco alcuni passaggi comuni da seguire.

L'autorizzazione della chiave API non va mai a buon fine

Se l'autorizzazione della chiave API non funziona, segui questi passaggi:

  • Assicurati di aver abilitato l'API ARCore per il progetto corretto in Google Cloud.
  • Se hai attivato delle restrizioni relative alle chiavi API, disattivale temporaneamente.
  • Utilizza lo Strumento di analisi APK per verificare che la chiave API sia inclusa nella build dell'app. Deve trovarsi in un elemento <meta-data> nell'elemento <application> nel AndroidManifest.xml della tua app:

    <meta-data
      android:name="com.google.android.ar.API_KEY"
      android:value="API_KEY"/>
    
  • Assicurati che la chiave API elencata nelle credenziali del progetto corrisponda esattamente alla chiave API utilizzata dalla tua app, senza spazi o altri caratteri.

La qualità della localizzazione geospaziale non raggiunge mai i valori previsti

Se la qualità delle pose restituite dall'API Geospatial non raggiunge i risultati previsti, ecco alcune possibili cause:

  • L'area non è mappata da una fonte ufficiale di Google Street View.
    • Per verificare, apri Google Maps e accedi a Street View vicino alla posizione di localizzazione prevista. L'attribuzione delle immagini di Street View deve essere Google Street View. Altre fonti non vengono prese in considerazione per il VPS.
  • L'area si trova in una regione con limitazioni.
  • L'area non dispone di un numero sufficiente di punti di riferimento idonei.
    • Il VPS utilizza solo punti di riferimento di alta qualità che difficilmente cambieranno per un lungo periodo di tempo. Ad esempio, l'aspetto degli alberi può variare molto nel corso dell'anno, quindi non sono adatti per essere utilizzati come punti di riferimento.
    • L'area potrebbe essere cambiata in modo significativo a causa di lavori infrastrutturali rispetto alle acquisizioni recenti di Google Street View.