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 un exemple d'application dans Xcode 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 iOS

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.

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 fonctionnant sous iOS 12.0 ou version ultérieure (cible de déploiement d'iOS 12.0 ou version ultérieure requise)

Configurer l'exemple d'application

Le projet GeospatialExample inclus dans 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 depuis GitHub pour obtenir le code de l'application exemple.

  2. Ouvrez une fenêtre de terminal ou du 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

Avant d'utiliser le système de positionnement visuel (VPS) 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 à la fois l'autorisation sans clé et l'autorisation par clé API. Dans ce guide de démarrage rapide, utilisez l'API Key.

Configurer les autorisations

Pour effectuer des appels d'API Geospatial vers le serveur VPS, l'application exemple a besoin d'une autorisation. 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 XCode, dans l'application exemple GeospatialExample, ouvrez ViewController.m. et recherchez your-api-key.

  2. Ajoutez votre clé API au fichier GARSession: collez la clé API que vous avez copiée à partir d'un à l'étape précédente sur le texte, your-api-key (laissez les guillemets), comme affiché:

    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 la SDK ARCore et versions d'iOS requises. Pour installer ces dépendances, ouvrez un Terminal et exécutez pod install à partir du dossier dans lequel se trouve le projet Xcode. existe.

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 de l'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 l'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, puis lancez-le sur votre appareil.

    Pour éviter les erreurs de compilation, assurez-vous de compiler à partir de .xcworkspace et non le 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 autour de vous, notez que les valeurs de confiance de la précision du positionnement peuvent changer si vous vous trouvez dans une zone où la localisation VPS est disponible.

Lorsque ARCore est sûr de la position et de l'orientation de votre appareil, vous pouvez placer une ancre à votre position actuelle à l'aide de la transformation 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 Xcode, ouvrez le fichier ViewController.m et accédez à ce qui suit. :

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

    Si vous réduisez la précision, l'application bénéficiera d'une plus grande latitude pour placer une ancre. Pour en savoir plus, consultez la section Ajuster la précision de la transformation.

Étapes suivantes

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