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 dans Android Studio une application exemple illustrant l'API Geospatial.

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

Pour en savoir plus sur l'API Geospatial, consultez Présentation de l'API ARCore Geospatial.

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

Conditions requises

Assistance relative aux appareils

Consultez la section Appareils compatibles pour obtenir la liste complète des appareils certifiés compatibles avec ARCore. Pour l'API Geospatial, l'un des composants matériels clés requis est un magnétomètre conforme aux spécifications de l'API Geospatial. Certains magnétomètres ne respectent pas les spécifications. Les appareils équipés de ces magnétomètres hors spécifications ne sont pas acceptés.

Logiciels

  • La dernière version des services Google Play pour la RA installée 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, que vous pouvez obtenir de deux manières:

    • Téléchargez-le sur GitHub et extrayez-le sur votre ordinateur.

    • 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 du code qui appelle l'API Geospatial.

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

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

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

Configurer un projet Google Cloud

Pour que vous puissiez utiliser le système de positionnement visuel (VPS), votre application doit être associée à un projet Google Cloud activé pour l'API ARCore. Consultez la page Utiliser l'API ARCore sur Google Cloud pour configurer les autorisations. Vous pouvez choisir entre l'autorisation sans clé et l'autorisation par 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 la position géospatiale actuelle de votre appareil. Lorsque vous analysez l'environnement qui vous entoure, notez que les valeurs de confiance de la précision du positionnement peuvent changer au fur et à mesure que vous vous déplacez, si vous vous trouvez dans une zone couverte par la localisation de serveurs privés virtuels.

Lorsque ARCore est sûr de la position et de la direction de votre appareil, vous pouvez placer une ancre à votre position actuelle à l'aide de la position Geospatial.

La précision du positionnement peut être trop faible si les informations VPS ne sont pas disponibles. L'application doit être connectée à Internet, et l'emplacement doit être connu du serveur VPS. 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 où le VPN n'est pas compatible ou si les signaux GPS ne sont pas suffisants, vous devrez peut-être ajuster les seuils de confiance dans l'application afin de placer une ancre.

Pour ajuster les seuils:

  1. Dans Android Studio, ouvrez GeospatialActivity et 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 précision est inférieure.

    Diminuer la précision permet à l'application d'avoir une plus grande latitude lors du positionnement d'une ancre. Pour en savoir plus, consultez Ajuster la précision des postures.

Étapes suivantes