1. Übersicht
ARCore ist das Framework von Google zum Erstellen von Augmented-Reality-Erlebnissen auf Smartphones. Die neue ARCore Geospatial API ergänzt die Augmented Reality um eine neue Funktion: Sie können damit standortspezifische Augmented Reality-Wegpunkte um reale Sehenswürdigkeiten herum platzieren.
Aufgaben
In diesem Codelab lernen Sie die ARCore Geospatial API kennen. Sie erfahren, welche Informationen die Geospatial API für Ihre AR-Nutzung insgesamt bietet und wie diese Daten für eine einfache AR-Wegsuche genutzt werden können.
Lerninhalte
- Hier erfährst du, wie du ein ARCore-Projekt einrichtest, das die Geospatial API verwendet.
- Geografische Daten von der Geospatial API anfordern und mit Google Maps darstellen
- Hier erfahren Sie, wie Sie einen Anker an einem realen Ort platzieren.
Voraussetzungen
- Ein unterstütztes ARCore-Android-Gerät, das über ein USB-Kabel mit dem Entwicklungscomputer verbunden und mit USB-Debugging konfiguriert ist.
- Android Studio wurde installiert und zum Erstellen von Android-Apps konfiguriert.
- Google Play-Dienste für AR 1.31 oder höher, installiert auf dem Android-Entwicklergerät
2. Entwicklungsumgebung einrichten
Android Studio einrichten
Für die ersten Schritte mit der Geospatial API haben wir ein Einstiegsprojekt mit den Grundlagen eines in das Google Maps SDK integrierten ARCore-Projekts bereitgestellt. So erhalten Sie einen schnellen Einstieg in die Geospatial API.
- Starten Sie Android Studio und importieren Sie ein Projekt aus VCS.
- Wenn Sie bereits ein Projekt geöffnet haben, verwenden Sie Datei > Neu > Projekt aus Versionsverwaltung...
- Wenn das Fenster Welcome to Android Studio (Willkommen bei Android Studio) angezeigt wird, verwenden Sie Get from VCS.
- Wählen Sie Git aus und verwenden Sie die URL
https://github.com/google-ar/codelab-geospatial.git
, um das Projekt zu importieren.
Google Cloud-Projekt einrichten
Die Geospatial API verwendet Street View-Bilder in Kombination mit dem Magnetometer und den Kamerasensorinformationen des Geräts, um die Ausrichtungswerte zu verbessern. Um diesen Dienst nutzen zu können, müssen Sie ein Google Cloud-Projekt einrichten.
- Erstellen Sie ein Projekt in der Google Cloud Console:
- Informationen dazu finden Sie unter Projekt in der Google Cloud Platform erstellen.
- Geben Sie einen geeigneten Projektnamen ein (z. B. „ARCore Geospatial API-Projekt“) und wählen Sie einen Standort aus.
- Klicken Sie auf Erstellen.
- Informationen dazu finden Sie unter Projekt in der Google Cloud Platform erstellen.
- Aktivieren Sie die erforderlichen APIs:
- Wählen Sie in der Seitenleiste APIs und Dienste und dann auf Mediathek.
- Suchen Sie nach der ARCore API.
- Klicken Sie auf Aktivieren.
- Kehren Sie zur Bibliothek zurück.
- Suchen Sie nach dem Maps SDK for Android.
- Klicken Sie auf Aktivieren.
- Anmeldedaten für API-Schlüssel erstellen:
- Wählen Sie unter APIs und Dienste und wählen Sie Anmeldedaten aus.
- Klicken Sie in der oberen Leiste auf Anmeldedaten erstellen und wählen Sie dann API-Schlüssel aus.
- Notieren Sie sich den erstellten Schlüssel für den nächsten Schritt. Kehren Sie zur Seite Anmeldedaten zurück, wenn Sie diese abrufen müssen.
Mit diesen Schritten haben Sie ein Google Cloud-Projekt mit API-Schlüsselautorisierung erstellt und können jetzt die Geospatial API verwenden.
API-Schlüssel in das Android Studio-Projekt einbinden
Um den API-Schlüssel von Google Cloud mit Ihrem Projekt zu verknüpfen, öffnen Sie das Projekt, das Sie in Android Studio erstellt haben, und ändern Sie die API-Schlüssel:
- App öffnen > src > AndroidManifest.xml abgeschlossen ist.
- Suchen Sie die folgenden
meta-data
-Einträge:<meta-data android:name="com.google.android.ar.API_KEY" android:value="PLACEHOLDER_API_KEY" /> <meta-data android:name="com.google.android.geo.API_KEY" android:value="PLACEHOLDER_API_KEY" />
- Ersetzen Sie
PLACEHOLDER_API_KEY
durch den API-Schlüssel, den Sie in Ihrem Google Cloud-Projekt erstellt haben.
Mit dem in com.google.android.ar.API_KEY
gespeicherten Wert wird die App autorisiert, die Geospatial API zu verwenden. Mit dem in com.google.android.geo.API_KEY
gespeicherten Wert wird die App zur Verwendung des Google Maps SDK autorisiert.
Projekt bestätigen
Stellen Sie sicher, dass Ihr Projekt startklar ist. Führen Sie Ihre App in Android Studio aus. Sie sollten die Kameraansicht sowie eine funktionierende Karte unten auf dem Bildschirm sehen.
3. Position der Nutzenden bestimmen
In diesem Schritt fügen Sie dem Beispielprojekt Code hinzu, um mit der Geospatial API zu beginnen.
ARCore-Sitzung für die Verwendung der Geospatial API konfigurieren
Wenn Sie Geodaten abrufen möchten, müssen Sie die Geospatial API aktivieren. Ändern Sie GeospatialMode
in der Sitzungskonfiguration in ENABLED
, indem Sie die Funktion configureSession
in HelloGeoActivity.kt
ändern:
fun configureSession(session: Session) {
session.configure(
session.config.apply {
// Enable Geospatial Mode.
geospatialMode = Config.GeospatialMode.ENABLED
}
)
}
Der raumbezogene Modus ist ENABLED
, die Anwendung kann aber raumbezogene Informationen abrufen.
Daten von der Geospatial API anfordern
Suchen Sie in HelloGeoRenderer.kt
nach der folgenden Zeile:
// TODO: Obtain Geospatial information and display it on the map.
Überprüfen Sie darunter, ob das Earth-Objekt zur Nutzung verfügbar ist. Dann hat es trackingState
TrackingState.ENABLED
.
val earth = session.earth
if (earth?.trackingState == TrackingState.TRACKING) {
// TODO: the Earth object may be used here.
}
Unter TODO
können Sie raumbezogene Daten von ARCore anfordern. Diese Zeile hinzufügen:
val cameraGeospatialPose = earth.cameraGeospatialPose
Dadurch erhalten Sie ein GeospatialPose
mit diesen Informationen:
- Standort in Breiten- und Längengrad Außerdem wird eine Schätzung der Standortgenauigkeit angegeben.
- Höhe und eine Schätzung der Höhengenauigkeit.
- Überschrift: eine Schätzung der Richtung, in die das Gerät zeigt, und eine Schätzung der Genauigkeit der Ausrichtung.
Positionierungsinformationen auf der Karte anzeigen
Du kannst die in cameraGeospatialPose
gespeicherte GeospatialPose
verwenden, um eine Markierung auf der Karte zu verschieben, die anzeigt, wo sich der Nutzer befindet. Fahren Sie dort fort, wo Sie aufgehört haben, und fügen Sie Folgendes hinzu:
activity.view.mapView?.updateMapPosition(
latitude = cameraGeospatialPose.latitude,
longitude = cameraGeospatialPose.longitude,
heading = cameraGeospatialPose.heading
)
Dadurch wird die Position der Karte kontinuierlich aktualisiert. Dazu werden Werte aus der Geospatial API verwendet.
Jetzt ausprobieren
Klicken Sie in Android Studio auf Wiedergabe. Halte dein Gerät hoch und bewege es hin und her, damit ARCore das Tracking einrichten kann. Nach kurzer Zeit sollten Sie eine grüne Markierung auf der Karte sehen. Die Markierung dreht sich, während Sie Ihre Umgebung betrachten. Sie sollte auch in die richtige Richtung zeigen: Wenn Ihre Sicht nach Norden zeigt, zeigt der Pfeil auch nach Norden.
4. Anker mithilfe von Erdkoordinaten platzieren
Mit der Geospatial API können Anker an jedem Koordinatenpaar und bei jeder Rotation in der realen Welt platziert werden. So sehen Nutzer beim Besuch bestimmter Orte verankerten Content.
In diesem Schritt fügen Sie eine Möglichkeit zum Positionieren eines Ankers hinzu, indem Sie auf die Karte tippen.
Aktion beim Antippen der Karte festlegen
Das Projekt enthält eine onMapClick
-Funktion, die mit einem Breiten- und Längengrad aufgerufen wird, wenn auf das Kartenfragment geklickt wird. Suchen Sie die Funktion onMapClick
in HelloGeoRenderer.kt
.
Sicherstellen, dass das Earth-Objekt verwendet werden kann
Bevor Sie Anker auf der Erde erstellen, muss der TrackingState
-Wert des Erdobjekts TRACKING
lauten. Das bedeutet, dass die Position der Erde bekannt ist. Achte außerdem darauf, dass die EarthState
auf ENABLED
gesetzt ist. Das bedeutet, dass keine Probleme mit der Geospatial API aufgetreten sind. Fügen Sie diese Zeilen innerhalb von onMapClick
ein:
val earth = session?.earth ?: return
if (earth.trackingState != TrackingState.TRACKING) {
return
}
Positionierung des neuen Ankers bestimmen
Nachdem Sie sich vergewissert haben, dass das Earth-Objekt die Tracking-Funktion aktiviert, trennen Sie die vorherige earthAnchor
(falls vorhanden). In den nächsten Schritten ersetzen Sie earthAnchor
durch einen neuen Anker:
earthAnchor?.detach()
Verwenden Sie dann cameraGeospatialPose
, um die Höhe für den neuen Anker zu bestimmen. Sie können zur Positionierung des Ankers das Koordinatenpaar aus dem Tippen auf die Karte verwenden.
// Place the earth anchor at the same altitude as that of the camera to make it easier to view.
val altitude = earth.cameraGeospatialPose.altitude - 1
// The rotation quaternion of the anchor in the East-Up-South (EUS) coordinate system.
val qx = 0f
val qy = 0f
val qz = 0f
val qw = 1f
earthAnchor =
earth.createAnchor(latLng.latitude, latLng.longitude, altitude, qx, qy, qz, qw)
createAnchor
erstellt eine Anchor
, die mit einer gegebenen Rotation auf geodätische Koordinaten fixiert ist. Dieser Anker versucht, stabil und an den angegebenen Koordinaten und der angegebenen Höhe zu bleiben.
Platzieren Sie die Markierung auf der Karte.
Verschieben Sie schließlich eine neue Markierung, die anzeigt, wo die Markierung platziert wurde:
activity.view.mapView?.earthMarker?.apply {
position = latLng
isVisible = true
}
Jetzt ausprobieren
Klicken Sie in Android Studio auf Wiedergabe. Halte dein Gerät hoch und bewege es hin und her, damit ARCore das Tracking einrichten kann. Nach kurzer Zeit sollte auf der Karte eine grüne Markierung angezeigt werden, die Ihre aktuelle Position angibt.
Beim Tippen auf die Karte wird die Geospatial API verwendet, um einen Anker zu platzieren, der mit einem realen Standort verknüpft ist. Platzieren Sie den Anker in der Nähe Ihres aktuellen Standorts, damit Sie ihn in der AR-Ansicht sehen können. Er sollte während der Navigation in Ihrer Umgebung stabil bleiben.
5. Fazit
In diesem Codelab haben Sie gelernt, wie Sie mit der Geospatial API ein einfaches AR-Erlebnis schaffen, das mit der realen Welt verbunden ist.
Behandelte Themen
- Hier erfahren Sie, wie Sie ein Google Cloud-Projekt mit aktivierter Geospatial API einrichten.
- Raumbezogene Daten in einem ARCore-Projekt abrufen und auf einer Karte darstellen
- Hier erfahren Sie, wie Sie einen Anker mithilfe der geografischen Positionierung in der realen Welt platzieren.
Zusätzliche Ressourcen
Weitere Informationen zu den in diesem Codelab verwendeten geografischen Konzepten und SDKs finden Sie in den folgenden zusätzlichen Ressourcen: