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

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

Pour savoir 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 la section Présentation de l'API ARCore Geospatial.

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

Prérequis

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

Configurer l'exemple d'application

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

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

  2. Ouvrez une fenêtre de terminal ou de Finder, puis 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 Examples (Exemples), sélectionnez le dossier GeospatialExample (Exemple géospatial), puis cliquez sur Open (Ouvrir).

Configurer un projet Google Cloud

Avant d'utiliser le système VPS (Visual Positioning System) dans votre application, vous devez d'abord activer l'API ARCore dans un projet Google Cloud nouveau ou existant. Bien que l'API Geospatial fonctionne avec l'autorisation par clé sans contact et par clé API, utilisez la méthode de clé API pour ce guide de démarrage rapide.

Configurer les autorisations

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

  1. Dans XCode, dans l'application exemple GeospatialExample, ouvrez le fichier ViewController.m et recherchez votre-clé-API.

  2. Ajoutez votre clé API à GARSession: collez la clé API que vous avez copiée à partir d'une étape précédente sur le texte votre-clé-API (laissez les guillemets), comme illustré:

    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 iOS dont vous avez besoin. Pour installer ces dépendances, ouvrez une fenêtre de terminal et exécutez pod install à partir du dossier où se trouve le projet Xcode.

Cela génère un fichier .xcworkspace que vous utiliserez ultérieurement pour créer 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 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 scannez l'environnement qui vous entoure, notez que les valeurs de confiance de la précision de positionnement peuvent changer à mesure que vous vous déplacez, si vous vous trouvez dans une zone prise en charge par la localisation VPS.

Lorsque ARCore est sûr de la position et de l'orientation de votre appareil, vous pouvez placer un ancrage à votre position actuelle à l'aide de la transformation géospatiale.

La précision de 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 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 qui n'est pas compatible avec le VPS ou si les signaux GPS ne sont pas suffisants, vous devrez peut-être ajuster les seuils de confiance dans l'application pour placer un ancrage.

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 faible.

    En réduisant la précision, l'application dispose d'une plus grande latitude pour placer un ancrage. Pour en savoir plus, consultez la section Ajuster 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.