Geospatial-Kurzanleitung für Android

In dieser Kurzanleitung für die ARCore Geospatial API erfahren Sie, wie Sie eine Beispiel-App ausführen in Android Studio an, das die Geospatial API demonstriert.

Eine Anleitung zum Entwickeln eigener Apps mit der Geospatial API findest du in der Entwicklerleitfaden für Geodaten für Android (Kotlin/Java) oder die Geospatial Developer Guide 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äteunterstützung

Unter Unterstützte Geräte findest du eine vollständige Liste der Geräte, die wurden für die Arbeit mit ARCore zertifiziert. Für die Geospatial API ist eine der Schlüssel erforderlich ist ein Magnetometer, das der Geospatial API entspricht Spezifikationen. Einige Magnetometer entsprechen nicht den Spezifikationen. Geräte mit diesen abweichende Magnetometer werden nicht unterstützt.

Software

  • Die neueste Version von 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:

    • Herunterladen von GitHub und extrahieren 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 Projekt geospatial_java, das im ARCore SDK for Android enthalten ist 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 das arcore-android-sdk.

  3. Öffnen Sie den Ordner samples, 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 Ein Google Cloud-Projekt, das für die ARCore API aktiviert ist Weitere Informationen finden Sie unter ARCore API in Google Cloud verwenden um die Autorisierung einzurichten. Sie können zwischen der schlüssellosen Autorisierung und der API-Schlüsselautorisierung wählen.

Beispiel-App ausführen

Führen Sie die Beispielanwendung in Android Studio aus.

Sie sollten eine Kameraansicht sowie Informationen zur Fehlerbehebung sehen können, die aktuelle raumbezogene Position Ihres Geräts. Wenn Sie Ihre Umgebung scannen, können sich die Konfidenzwerte von Positionierungsgenauigkeit ändern, wenn Sie sich in einem Gebiet befinden, das von der VPS-Lokalisierung unterstützt wird.

Wenn ARCore den Standort und die Ausrichtung Ihres Geräts mit hoher Wahrscheinlichkeit kennt, können Sie mithilfe der geografischen Pose einen Anker an Ihrem aktuellen Standort platzieren.

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

Wenn Sie sich in einem Gebiet befinden, in dem VPS nicht unterstützt wird, reicht es aus, dass Sie die Konfidenzgrenzwerte in der App anpassen müssen, um einen Anker zu platzieren.

So passt du die Schwellenwerte an:

  1. Öffnen Sie in Android Studio GeospatialActivity und suchen Sie nach dem folgenden Abschnitt:

    // 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 die Genauigkeit verringert wird, kann die App einen größeren Breitengrad platzieren. Weitere Informationen finden Sie unter Für korrekte Körperhaltung anpassen.

Nächste Schritte