Geospatial-Kurzanleitung für Android

In dieser Kurzanleitung für die ARCore Geospatial API erfährst du, wie du eine Beispiel-App in Android Studio ausführst, mit der die Geospatial API veranschaulicht wird.

Eine Anleitung zur Entwicklung Ihrer eigenen App mit der Geospatial API finden Sie im Geospatial-Entwicklerleitfaden für Android (Kotlin/Java) oder im Geospatial-Entwicklerleitfaden für Android NDK (C).

Weitere Informationen zur Geospatial API finden Sie unter Einführung in die ARCore Geospatial API.

Wenn Sie zum ersten Mal mit ARCore arbeiten, lesen Sie den Artikel Erste Schritte.

Voraussetzungen

Gerätesupport

Eine vollständige Liste der für ARCore zertifizierten Geräte findest du unter Unterstützte Geräte. Für die Geospatial API wird unter anderem ein Magnetometer benötigt, das den Spezifikationen der Geospatial API entspricht. Einige Magnetometer entsprechen nicht der Spezifikation. Geräte mit solchen Magnetometern werden nicht unterstützt.

Software

  • Die neueste Version der Google Play-Dienste für AR, die auf dem unterstützten Gerät installiert ist.

  • Android Studio Version 3.0 oder höher mit Android SDK Platform Version 7.0 (API-Level 24) oder höher

  • Das ARCore SDK für Android, das Sie auf zwei Arten herunterladen können:

    • Laden Sie sie von GitHub herunter und extrahieren Sie sie auf Ihrem Computer.

    • Klonen Sie das Repository mit dem folgenden Befehl:

      git clone https://github.com/google-ar/arcore-android-sdk.git

Beispiel-App öffnen und einrichten

Das im ARCore SDK for Android enthaltene Projekt geospatial_java beschreibt Code, der die Geospatial API aufruft.

  1. Klicken Sie in Android Studio im Menü Datei auf Öffnen.

  2. Gehen Sie zum Projektordner für arcore-android-sdk.

  3. Öffnen Sie den Ordner Beispiele, wählen Sie den Ordner geospatial_java aus und klicken Sie auf Öffnen.

Google Cloud-Projekt einrichten

Damit Sie das Visual Positioning System (VPS) verwenden können, muss Ihre App mit einem Google Cloud-Projekt verknüpft sein, das für die ARCore API aktiviert ist. Informationen zum Einrichten der Autorisierung finden Sie unter ARCore API in Google Cloud verwenden. Sie können zwischen der Autorisierung ohne Schlüssel und der API-Schlüsselautorisierung wählen.

Beispiel-App ausführen

Führen Sie die Beispiel-App in Android Studio aus.

Sie sollten eine Kameraansicht sowie Fehlerbehebungsinformationen mit einer Beschreibung der aktuellen raumbezogenen Position Ihres Geräts sehen können. Wenn Sie Ihre Umgebung scannen, bemerken Sie, dass sich die Konfidenzwerte der Positionierungsgenauigkeit ändern können, wenn Sie sich bewegen, wenn Sie sich in einem Bereich befinden, der von der VPS-Lokalisierung unterstützt wird.

Wenn ARCore den Standort und die Richtung deines Geräts ermittelt hat, kannst du mithilfe der raumbezogenen Position einen Anker an deinem aktuellen Standort platzieren.

Die Positionierungsgenauigkeit ist möglicherweise zu gering, wenn keine VPS-Informationen verfügbar sind. Die Anwendung muss mit dem Internet verbunden und der Standort dem VPS bekannt sein. Die besten Ergebnisse erzielen Sie, wenn Sie die Beispiel-App bei Tageslicht im Freien (nicht in Innenräumen) ausführen.

Wenn Sie sich in einem Gebiet befinden, in dem VPS nicht unterstützt wird, oder wenn die GPS-Signale nicht ausreichen, müssen Sie möglicherweise die Konfidenzgrenzwerte in der App anpassen, um einen Anker zu platzieren.

So passen Sie die Schwellenwerte an:

  1. Öffnen Sie in Android Studio GeospatialActivity und rufen Sie den folgenden Abschnitt auf:

    // The thresholds that are required for horizontal and heading accuracies before entering into the
// LOCALIZED state. Once the accuracies are equal or less than these values, the app will
// allow the user to place anchors.
private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;

  2. Passen Sie diese Werte nach Bedarf an. Je höher der Wert, desto geringer die Genauigkeit.

    Wenn Sie die Genauigkeit verringern, kann die App beim Platzieren eines Ankers mehr Breitengrad verwenden. Weitere Informationen finden Sie unter Positionsgenauigkeit anpassen.

Nächste Schritte