Guide de démarrage rapide de l'API Geospatial pour iOS

Ce guide de démarrage rapide pour l'API ARCore Geospatial vous explique comment exécuter dans Xcode un exemple d'application qui illustre le fonctionnement de l'API Geospatial.

Pour découvrir comment développer votre propre application avec l'API Geospatial, consultez le guide du développeur Geospatial pour iOS.

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 préalables

  • Xcode version 13.0 ou ultérieure
  • CocoaPods 1.4.0 ou version ultérieure si vous utilisez CocoaPods
  • Un appareil Apple compatible ARKit fonctionnant sous iOS 12.0 ou version ultérieure (cible de déploiement requise pour iOS 12.0 ou version ultérieure)

Configurer l'exemple d'application

Le projet GeospatialExample inclus avec le SDK ARCore pour iOS décrit du code qui appelle l'API Geospatial.

  1. Clonez ou téléchargez le SDK ARCore pour iOS depuis GitHub pour obtenir l'exemple de code d'application.

  2. Ouvrez une fenêtre Terminal ou Finder et accédez au dossier dans lequel vous avez cloné ou téléchargé le SDK.

  3. Accédez au dossier arcore-ios-sdk-master/Examples.

  4. Ouvrez le dossier Exemples, sélectionnez le dossier GeospatialExample, puis cliquez sur 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.

Vous devez activer l'API ARCore dans votre projet Google Cloud. Si vous devez créer le projet, procédez comme suit:

  1. Consultez Créer un projet dans Google Cloud Platform.

  2. Saisissez un nom de projet approprié, puis sélectionnez son emplacement.

  3. Cliquez sur Créer.

  4. Dans la barre latérale, sélectionnez API et services, puis Bibliothèque.

  5. Recherchez l'API ARCore, sélectionnez-la, puis cliquez sur Activer.

Configurer les autorisations

Pour effectuer des appels d'API Geospatial vers le VPS, l'application exemple a besoin d'une autorisation et peut utiliser une clé API sans restriction. Si vous utilisez une clé API restreinte, vous devez également fournir un ID de bundle à associer à la clé API.

  1. Dans votre projet Google Cloud, obtenez une clé API comme indiqué dans la section Créer une clé API.

  2. Copiez la clé API (vous la collerez plus tard).

  3. Dans Xcode, dans l'application exemple GeospatialExample, ouvrez le fichier ViewController.m et recherchez your-api-key.

  4. Ajoutez votre clé API à GARSession: collez la clé API que vous avez copiée lors d'une étape précédente sur le texte your-api-key (laissez les guillemets), comme indiqué ci-dessous.

    self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                               bundleIdentifier:nil
                                          error:&error];

Configurer le SDK ARCore

L'application GeospatialExample est fournie avec un Podfile préconfiguré avec le SDK ARCore et les versions d'iOS dont vous avez besoin. Pour installer ces dépendances, ouvrez une fenêtre de terminal et exécutez pod install à partir du dossier dans lequel se trouve le projet Xcode.

Cela génère un fichier .xcworkspace que vous utiliserez plus tard pour compiler et exécuter l'application.

Créer et exécuter l'application exemple

  1. Dans Xcode, sélectionnez le fichier d'espace de travail GeospatialExample, puis cliquez sur Signing & Capabilities (Signature et fonctionnalités).

  2. Cochez la case Gérer automatiquement la signature.

  3. Dans le champ Équipe, saisissez un nom d'équipe.

    Vous pouvez utiliser l'identifiant de bundle par défaut pour exécuter l'application à partir de Xcode, mais vous devez le modifier si vous utilisez GeospatialExample comme bouchon pour votre propre application en production.

  4. Connectez votre appareil pour exécuter l'application exemple.

  5. Créez et exécutez l'application GeospatialExample à partir du fichier .xcworkspace pour la lancer sur votre appareil.

    Pour éviter les erreurs de compilation, assurez-vous de compiler à partir du fichier .xcworkspace et non du fichier .xcodeproj.

Vous devriez voir une vue de la caméra, ainsi que des informations de débogage décrivant la transformation 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 où la localisation VPS est disponible.

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 transformation 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 Xcode, ouvrez le fichier ViewController.m et accédez à la section suivante:

    // Thresholds for 'good enough' accuracy. These can be tuned for the
// application. We use both 'low'
// and 'high' values here to avoid flickering state changes.
static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;

  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 la section Ajuster pour la précision de la transformation.

Étapes suivantes

Consultez le Guide du développeur Geospatial pour iOS et commencez à créer des applications avec l'API Geospatial.