Vérifier la disponibilité du service VPS à l'emplacement actuel de l'appareil

L'API Geospatial utilise une combinaison de données VPS et GPS pour générer des transformations géospatiales de haute précision. L'API peut être utilisée partout où l'appareil peut déterminer sa position:

  • Dans les zones où la précision du GPS est faible, comme les espaces intérieurs et les environnements urbains denses, l'API s'appuie sur la couverture du VPS pour générer des transformations de haute précision.
  • Dans les environnements extérieurs où il y a peu ou pas d'obstacles au-dessus, l'API Geospatial peut être en mesure d'utiliser les données de localisation GPS disponibles pour générer des transformations géospatiales avec une grande précision.

Vous pouvez déterminer la disponibilité du VPS à une position horizontale donnée avant le début de la session RA et l'utiliser pour créer des expériences plus spécifiques. Par exemple, vous pouvez afficher un bouton "Accéder à la RA" uniquement lorsque le VPS est disponible.

Activer l'API ARCore

Votre application doit activer l'API ARCore pour vérifier la disponibilité du VPS.

Vérifier la disponibilité du VPS dans votre application

L'API Geospatial peut être utilisée partout où l'appareil peut déterminer sa position. Si votre expérience RA repose sur la couverture VPS, vous pouvez utiliser GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: pour obtenir un GARVPSAvailabilityFuture, une tâche asynchrone qui vérifie la disponibilité du VPS à une position horizontale donnée. Une fois que vous avez le GARVPSAvailabilityFuture, vous pouvez obtenir son résultat par interrogation ou par rappel.

Interroger le résultat

Utilisez GARFuture.state pour obtenir l'état de l'Future. Il existe trois états différents:

  • GARFutureStatePending: l'opération n'est pas encore terminée. Aucun résultat n'est donc connu.
  • GARFutureStateCancelled: l'opération a été annulée par GARFuture#cancel. Aucun rappel enregistré ne sera jamais appelé.
  • GARFutureStateDone: l'opération est terminée. Utilisez GARVPSAvailabilityFuture.result pour obtenir le résultat.

Vous pouvez continuer à vérifier GARFuture.state jusqu'à ce que la tâche soit terminée.

Obtenir le résultat via un rappel

Vous pouvez également obtenir le résultat d'un Future via un rappel. Utilisez GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: et fournissez un completionHandler. Cet completionHandler sera appelé sur le thread principal peu de temps après que l'état de Future est GARFutureStateDone.

Annuler la Future

Utilisez GARFuture#cancel pour tenter d'annuler l'Future. En raison du parallélisme de threads, il est possible que votre tentative d'annulation ne soit pas couronnée de succès. GARFuture#cancel renvoie YES si cette tentative a réussi, et NO dans le cas contraire.

Utiliser l'API Geospatial sans couverture VPS

L'API Geospatial peut également être utilisée dans les zones non couvertes par le VPS. Dans les environnements extérieurs avec peu ou pas d'obstacles au-dessus, le GPS peut suffire à générer une pose avec une grande précision.

Étape suivante