Verfügbarkeit von VPS am aktuellen Standort des Geräts prüfen

Die Geospatial API verwendet eine Kombination aus VPS- und GPS-Daten, um hochpräzise geospatiale Transformationen zu generieren. Die API kann überall dort verwendet werden, wo das Gerät seinen Standort bestimmen kann:

  • In Gebieten mit geringer GPS-Genauigkeit, z. B. in Innenräumen und in dicht bebauten städtischen Gebieten, nutzt die API die VPS-Abdeckung, um hochpräzise Transformationen zu generieren.
  • In Außenbereichen mit wenigen oder gar keinen Hindernissen kann die Geospatial API verfügbare GPS-Standortdaten verwenden, um georäumliche Transformationen mit hoher Genauigkeit zu generieren.

Sie können die VPS-Verfügbarkeit an einer bestimmten horizontalen Position vor Beginn der AR-Sitzung ermitteln und sie verwenden, um spezifischere Funktionen zu erstellen. So können Sie beispielsweise die Schaltfläche „AR starten“ nur anzeigen, wenn VPS verfügbar ist.

ARCore API aktivieren

In Ihrer App muss die ARCore API aktiviert sein, um die VPS-Verfügbarkeit zu prüfen.

Verfügbarkeit von VPS in Ihrer App prüfen

Die Geospatial API kann überall dort verwendet werden, wo das Gerät seinen Standort ermitteln kann. Wenn die AR-Funktion von der VPS-Abdeckung abhängt, können Sie GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: verwenden, um eine GARVPSAvailabilityFuture abzurufen. Dabei handelt es sich um eine asynchrone Aufgabe, die die VPS-Verfügbarkeit an einer bestimmten horizontalen Position prüft. Sobald du die GARVPSAvailabilityFuture hast, kannst du das Ergebnis durch Abfragen oder über einen Rückruf abrufen.

Ergebnis abfragen

Mit GARFuture.state können Sie den Status der Future abrufen. Es gibt drei verschiedene Status:

  • GARFutureStatePending: Der Vorgang ist noch nicht abgeschlossen, sodass kein Ergebnis vorliegt.
  • GARFutureStateCancelled: Der Vorgang wurde von GARFuture#cancel abgebrochen. Ein registrierter Rückruf wird nie aufgerufen.
  • GARFutureStateDone: Der Vorgang ist abgeschlossen. Verwenden Sie GARVPSAvailabilityFuture.result, um das Ergebnis aufzurufen.

Sie können GARFuture.state weiterhin prüfen, bis die Aufgabe abgeschlossen ist.

Ergebnis über einen Callback abrufen

Du kannst das Ergebnis einer Future auch über einen Callback abrufen. Verwende GARSession#checkVPSAvailabilityAtCoordinate:completionHandler: und gib einen completionHandler an. Diese completionHandler wird im Hauptthread aufgerufen, kurz nachdem die Future den Status GARFutureStateDone hat.

Future stornieren

Verwenden Sie GARFuture#cancel, um zu versuchen, die Future abzubrechen. Aufgrund der Threadparallelität ist es möglich, dass der Abbruchversuch nicht erfolgreich ist. GARFuture#cancel gibt YES zurück, wenn dieser Versuch erfolgreich war, andernfalls NO.

Geospatial API ohne VPS-Abdeckung verwenden

Die Geospatial API kann auch in Gebieten verwendet werden, die nicht von VPS abgedeckt sind. In Außenumgebungen mit wenigen oder gar keinen Hindernissen über Kopf reicht das GPS möglicherweise aus, um eine Pose mit hoher Genauigkeit zu generieren.

Nächste Schritte