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 d'une grande précision. Vous pouvez utiliser l'API partout 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'appuie 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 au-dessus, 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 VPS à une position horizontale donnée avant le début de la session de RA et l'utiliser pour créer des expériences plus spécifiques (par exemple, pour présenter un "Enter AR") bouton uniquement lorsque VPS est disponible.

Activer l'API ARCore

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

Une fois l'API ARCore activée, vous pouvez vérifier la disponibilité de VPS sans:

Vérifier la disponibilité VPS dans votre application

L'API Geospatial peut être utilisée partout où l'appareil est en mesure de déterminer sa position. Si votre expérience de RA dépend de la couverture VPS, vous pouvez utiliser Session.checkVpsAvailabilityAsync() pour obtenir un VpsAvailabilityFuture, une tâche asynchrone qui vérifie la disponibilité des VPS à une position horizontale donnée. Une fois que vous disposez de VpsAvailabilityFuture, vous pouvez obtenir son résultat par le biais d'une interrogation ou d'un rappel.

Sondage

Utilisez Future.getState() pour obtenir l'état de Future. Il existe trois états différents:

Vous pouvez continuer à vérifier Future.getState() jusqu'à ce que la tâche soit terminée.

Java

// Obtain a VpsAvailabilityFuture and store it somewhere.
VpsAvailabilityFuture future = session.checkVpsAvailabilityAsync(latitude, longitude, null);

// Poll VpsAvailabilityFuture later, for example, in a render loop.
if (future.getState() == FutureState.DONE) {
  switch (future.getResult()) {
    case AVAILABLE:
      // VPS is available at this location.
      break;
    case UNAVAILABLE:
      // VPS is unavailable at this location.
      break;
    case ERROR_NETWORK_CONNECTION:
      // The external service could not be reached due to a network connection error.
      break;

      // Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...
  }
}

Kotlin

// Obtain a VpsAvailabilityFuture and store it somewhere.
val future = session.checkVpsAvailabilityAsync(latitude, longitude, null)

// Poll VpsAvailabilityFuture later, for example, in a render loop.
if (future.state == FutureState.DONE) {
  when (future.result) {
    VpsAvailability.AVAILABLE -> {
      // VPS is available at this location.
    }
    VpsAvailability.UNAVAILABLE -> {
      // VPS is unavailable at this location.
    }
    VpsAvailability.ERROR_NETWORK_CONNECTION -> {
      // The external service could not be reached due to a network connection error.
    }
    else -> {
      TODO("Handle other error states, e.g. ERROR_RESOURCE_EXHAUSTED, ERROR_INTERNAL, ...")
    }
  }
}

Obtenir le résultat via un rappel

Vous pouvez également obtenir le résultat d'une Future via un rappel. Utilisez Session.checkVpsAvailabilityAsync() et fournissez un callback. Ce callback sera appelé sur le thread principal peu de temps après que Future ait l'état DONE.

Java

session.checkVpsAvailabilityAsync(
    latitude,
    longitude,
    result -> {
      // Callback is called on the Main thread.
      switch (result) {
          // Handle the VpsAvailability result as shown above.
          // For example, show UI that enables your AR view.
      }
    });

Kotlin

session.checkVpsAvailabilityAsync(latitude, longitude) { result ->
  // Callback is called on the Main thread.

  // Handle the VpsAvailability result as shown above.
  // For example, show UI that enables your AR view.
  TODO("Handle VpsAvailability " + result)
}

Annuler Future

Utilisez Future.cancel() pour tenter d'annuler Future. En raison du parallélisme des threads, il est possible que votre tentative d'annulation n'aboutisse pas. Future.cancel() renvoie true si la tentative a abouti, et false dans le cas contraire.

Utiliser l'API Geospatial sans couverture VPS

L'API Geospatial peut également être utilisée dans les zones qui ne disposent pas de couverture VPS. En extérieur, le GPS peut suffire à générer une position avec une grande précision dans les environnements où il n'y a pas ou peu d'obstacles au-dessus de la tête.

Étape suivante