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 postures géospatiales de haute précision. L'API peut être utilisée là où l'appareil est capable de 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'appuiera sur la couverture VPS pour générer des postures de haute précision.
• Dans les environnements extérieurs avec peu ou pas d'obstacles aériens, l'API Geospatial peut utiliser les données de localisation GPS disponibles pour générer des postures géospatiales avec une grande précision.

Vous pouvez déterminer la disponibilité des services VPS à une position horizontale donnée avant le début de la session de RA et vous en servir pour créer des expériences plus spécifiques (par exemple, pour n'afficher un bouton "Passer en RA" que lorsque VPS est disponible).

Activer l'API ARCore

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

Vérifier la disponibilité du service VPS dans votre application

L'API Geospatial peut être utilisée là où l'appareil est capable de déterminer sa position. Si votre expérience de RA repose sur une couverture VPS, vous pouvez utiliser AREarthManager.CheckVpsAvailabilityAsync() pour obtenir un VpsAvailabilityPromise, une tâche asynchrone qui vérifie la disponibilité du VPS à une position horizontale donnée. Une fois que vous disposez de VpsAvailabilityPromise, vous pouvez obtenir son résultat en interrogeant.

Interroger le résultat

Utilisez VpsAvailabilityPromise.State pour obtenir l'état de InterruptiblePromise. Il existe trois états différents:

• Pending: l'opération n'est pas encore terminée, donc aucun résultat n'est connu.
• Cancelled: l'opération a été annulée par VpsAvailabilityPromise.Cancel(). Tout rappel enregistré ne sera jamais appelé.
• Done: l'opération est terminée. Utilisez VpsAvailabilityPromise.Result pour obtenir le résultat.

Vous pouvez continuer à vérifier VpsAvailabilityPromise.State jusqu'à ce que l'opération soit terminée.

Annuler le InterruptiblePromise

Utilisez VpsAvailabilityPromise.Cancel() pour tenter d'annuler le InterruptiblePromise. En raison du parallélisme des threads, il est possible que votre tentative d'annulation n'aboutisse pas.

Utiliser l'API Geospatial sans couverture VPS

L'API Geospatial peut également être utilisée dans les zones qui ne sont pas couvertes par un service VPS. Dans les environnements extérieurs avec peu ou pas d'obstacles au-dessus de la tête, le GPS peut suffire à prendre une pose avec une grande précision.

Étapes suivantes

• Obtenez la position géospatiale de la caméra de l'appareil pour déterminer la position exacte de l'appareil de l'utilisateur dans le monde réel.