Résoudre les problèmes liés à l'API Geospatial

Appareils XR concernés
Ces conseils vous aideront à créer des expériences pour ces types d'appareils XR.
En savoir plus sur les types d'appareils XR →
Lunettes XR filaires
Lunettes audio et
avec affichage
En savoir plus sur les types d'appareils XR →

Si vous rencontrez des problèmes avec l'API Geospatial, voici quelques étapes courantes à suivre.

L'autorisation de la clé API échoue systématiquement

Si l'autorisation par clé API ne fonctionne pas, procédez comme suit :

  • Assurez-vous d'avoir activé l'API ARCore pour le bon projet dans Google Cloud.
  • Si vous avez activé des restrictions de clé API, désactivez-les temporairement.

  • Utilisez l'analyseur d'APK pour vérifier que la clé API est incluse dans le build de votre application. Il doit se trouver dans un élément <meta-data> de l'élément <application> du fichier AndroidManifest.xml de votre application :

    <meta-data
  android:name="com.google.android.ar.API_KEY"
  android:value="API_KEY"/>

  • Assurez-vous que la clé API listée dans les identifiants de votre projet correspond exactement à la clé API utilisée par votre application, sans espaces ni autres caractères.

La qualité de la localisation géospatiale n'atteint jamais les valeurs attendues

Si la qualité des poses renvoyées par l'API Geospatial ne correspond pas aux résultats attendus, voici quelques causes possibles :

  • La zone n'est pas cartographiée par une source Google Street View officielle.
    • Pour le vérifier, ouvrez Google Maps et accédez à Street View à proximité de la position de localisation attendue. L'attribution des images Street View doit être Google Street View. Les autres sources ne sont pas prises en compte pour le VPS.
  • La zone se trouve dans une région restreinte.
  • La zone ne comporte pas suffisamment de points de repère éligibles.
    • Le VPS n'utilise que des points de repère de haute qualité qui ne sont pas susceptibles de changer sur une longue période. Par exemple, l'apparence des arbres peut varier considérablement au cours de l'année. Ils ne sont donc pas adaptés pour être utilisés comme points de repère.
    • La zone peut avoir considérablement changé en raison de travaux d'infrastructure par rapport aux captures récentes de Google Street View.