Guide de démarrage rapide concernant les données géospatiales pour Android

Ce guide de démarrage rapide pour l'API ARCore Geospatial vous explique comment exécuter un exemple d'application dans Android Studio pour illustrer l'API Geospatial.

Pour savoir comment développer votre propre application avec l'API Geospatial, consultez le Guide du développeur Geospatial pour Android (Kotlin/Java) ou Guide du développeur géospatial pour le NDK Android (C)

Consultez le Présentation de l'API ARCore Geospatial sur l'API Geospatial.

Si vous débutez dans le développement avec ARCore, consultez la page Premiers pas.

Conditions requises

Vérifier si l'appareil est compatible

Consultez la section Appareils compatibles pour obtenir la liste complète des appareils qui : ont été certifiés compatibles avec ARCore. Pour l'API Geospatial, l'une des clés est un magnétomètre compatible avec l'API Geospatial caractéristiques techniques. Certains magnétomètres ne répondent pas aux spécifications. appareils avec ces Les magnétomètres non conformes ne sont pas pris en charge.

Logiciel

  • La dernière version de Services Google Play pour la RA installé sur l'appareil compatible.

  • Android Studio version 3.0 ou ultérieure avec Android SDK Platform version 7.0 (niveau d'API 24) ou ultérieure ;

  • Le SDK ARCore pour Android, disponible de deux manières différentes:

    • Téléchargez-le sur GitHub et l'extraire sur votre machine.

    • Clonez le dépôt à l'aide de la commande suivante: 

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

Ouvrir et configurer l'application exemple

Le projet geospatial_java inclus dans le SDK ARCore pour Android décrit le code qui appelle l'API Geospatial.

  1. Dans le menu File (Fichier) d'Android Studio, cliquez sur Open (Ouvrir).

  2. Accédez au dossier du projet pour arcore-android-sdk.

  3. Ouvrez le dossier samples, sélectionnez geospatial_java, puis cliquez sur Ouvrir.

Configurer un projet Google Cloud

Pour utiliser le système de positionnement visuel (VPS), votre application doit être associée à un projet Google Cloud activé pour l'API ARCore ; Voir Utiliser l'API ARCore sur Google Cloud pour configurer les autorisations. Vous pouvez choisir l'autorisation sans clé ou via une clé API.

Exécuter l'application exemple

Dans Android Studio, exécutez l'application exemple.

Vous devriez voir une vue de la caméra, ainsi que des informations de débogage décrivant l'état géospatial actuel de votre appareil. Lorsque vous analysez l'environnement qui vous entoure, vous remarquerez que les valeurs de confiance de la précision du positionnement peuvent changer lorsque vous vous déplacez, si vous vous trouvez dans une zone où la localisation VPS est disponible.

Lorsque ARCore a confiance dans la position et l'orientation de votre appareil, vous pouvez placer un Ancrez l'appareil sur votre position actuelle à l'aide de la posture géospatiale.

La précision du positionnement peut être trop faible si les informations VPS ne sont pas disponibles. La l'application doit être connectée à Internet et le serveur VPS doit connaître l'emplacement. Pour de meilleurs résultats, exécutez l'application exemple à l'extérieur (et non à l'intérieur) pendant la journée.

De plus, si vous vous trouvez dans une zone non compatible avec le protocole VPS ou si les signaux GPS ne sont pas vous devrez peut-être ajuster les seuils de confiance dans l'application pour placer une ancre.

Pour ajuster les seuils:

  1. Dans Android Studio, ouvrez GeospatialActivity, puis accédez à la section suivante :

    // 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. Ajustez ces valeurs si nécessaire. Plus la valeur est élevée, plus la justesse est inférieure.

    En réduisant la précision, l'application dispose d'une plus grande latitude pour placer un ancrage. Voir Effectuez des ajustements pour améliorer la précision de la posture pour en savoir plus.

Étapes suivantes