Mit raumbezogenen Ankern reale Inhalte auf iOS-Geräten positionieren

Georeferenzierte Anker sind eine Art von Anker, mit denen Sie 3D-Inhalte in der realen Welt platzieren können.

Arten von geografischen Markierungen

Es gibt drei Arten von geografischen Markierungen, die die Höhe unterschiedlich handhaben:

1. WGS84-Markierungen:
   Mit WGS84-Markierungen können Sie 3D-Inhalte an einem beliebigen Breiten-, Längen- und Höhengrad platzieren.

2. Terrain-Markierungen:
   Mithilfe von Terrain-Markierungen können Sie Inhalte nur mithilfe von Breiten- und Längengrad sowie einer Höhe relativ zum Gelände an dieser Position platzieren. Die Höhe wird relativ zum Boden oder zur Etage bestimmt, wie sie VPS bekannt ist.

3. Dachdübel:
   Mit Dachankern können Sie Inhalte nur anhand des Breiten- und Längengrads platzieren, wobei die Höhe an dieser Position relativ zum Dach eines Gebäudes relativ zum jeweiligen Gebäude ist. Die Höhe wird relativ zum Dach eines Gebäudes bestimmt, wie es aus der Straßenraumgeometrie hervorgeht. Wird diese Option nicht auf einem Gebäude platziert, wird standardmäßig die Geländehöhe verwendet.

	WGS84	Gelände	Dach
Horizontale Position	Breitengrad, Längengrad	Breitengrad, Längengrad	Breitengrad, Längengrad
Vertikale Position	Relativ zur WGS84-Höhe	Relativ zur von Google Maps bestimmten Geländehöhe	Relativ zur von Google Maps bestimmten Dachhöhe
Muss serverseitig aufgelöst werden?	Nein	Ja	Ja

Voraussetzungen

Aktivieren Sie die Geospatial API, bevor Sie fortfahren.

Raumbezogene Anker platzieren

Für jeden Ankertyp gibt es spezielle APIs, mit denen er erstellt werden kann. Weitere Informationen finden Sie unter Arten von geografischen Markierungen.

Anker aus einem Treffertest erstellen

Sie können auch einen geografischen Anker aus einem Ergebnis eines Treffertests erstellen. Verwenden Sie die Transformation aus dem Treffertest und konvertieren Sie sie in ein GARGeospatialTransform. Damit können Sie einen der drei beschriebenen Ankertypen platzieren.

Geospatiale Transformation aus einer AR-Transformation abrufen

GARSession.geospatialTransformFromTransform:error: bietet eine zusätzliche Möglichkeit, den Breiten- und Längengrad zu bestimmen, indem eine AR-Transformation in eine geospatiale Transformation umgewandelt wird.

AR-Transformation aus einer geospatialen Transformation abrufen

GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error: wandelt eine von der Erde angegebene horizontale Position, Höhe und Quaternionsdrehung bezogen auf einen Koordinatenrahmen (Osten-Oben-Süd) in eine AR-Transformation bezogen auf die GL-Weltkoordinate um.

Wählen Sie die Methode aus, die für Ihren Anwendungsfall am besten geeignet ist.

Jede Methode zum Erstellen eines Ankers hat Vor- und Nachteile, die Sie berücksichtigen sollten:

• Verwenden Sie bei Verwendung von Streetscape-Geometrie einen Treffertest, um einem Gebäude Inhalte hinzuzufügen.
• Sie sollten Gelände- oder Dachanker gegenüber WGS84-Ankern vorziehen, da sie von Google Maps festgelegte Höhenwerte verwenden.

Längen- und Breitengrad eines Standorts ermitteln

Es gibt drei Möglichkeiten, den Breiten- und Längengrad eines Standorts zu berechnen:

• Mit dem Geospatial Creator können Sie sich die Welt mit 3D-Inhalten ansehen und ergänzen, ohne sich an einen bestimmten Ort begeben zu müssen. So können Sie im Unity-Editor visuelle 3D-Inhalte mithilfe von Google Maps platzieren. Breiten- und Längengrad, Drehung und Höhe der Inhalte werden automatisch für Sie berechnet.
• Google Maps verwenden
• Google Earth verwenden Wenn Sie diese Koordinaten mit Google Earth statt mit Google Maps ermitteln, kann die Fehlertoleranz bis zu mehreren Metern betragen.
• Zum physischen Standort gehen

Google Maps verwenden

So ermitteln Sie mit Google Maps den Breiten- und Längengrad eines Standorts:

1. Rufen Sie auf Ihrem Computer Google Maps auf.

   

2. Klicken Sie auf Ebenen > Dreipunkt-Menü.

   

   

3. Ändern Sie den Kartentyp in Satellit und entfernen Sie das Häkchen im Kästchen Globusansicht links unten auf dem Bildschirm.

   

   Dadurch wird eine 2D-Perspektive erzwungen und mögliche Fehler, die durch eine geneigte 3D-Ansicht entstehen können, werden vermieden.

4. Klicken Sie auf der Karte mit der rechten Maustaste auf den Ort und wählen Sie Längen- und Breitengrad aus, um ihn in die Zwischenablage zu kopieren.

Google Earth verwenden

Sie können den Breiten- und Längengrad eines Orts in Google Earth berechnen, indem Sie in der Benutzeroberfläche auf einen Ort klicken und die Daten aus den Details der Ortsmarkierung lesen.

Hinweis :Wenn Sie diese Koordinaten mit Google Earth statt mit Google Maps ermitteln, kann die Fehlertoleranz bis zu mehreren Metern betragen. Wir empfehlen, Google Maps und die Elevation API zu verwenden, um den Breiten- und Längengrad eines Standorts zu ermitteln.

So rufen Sie mit Google Earth den Breiten- und Längengrad eines Orts ab:

1. Rufen Sie auf Ihrem Computer Google Earth auf.

2. Öffnen Sie das Dreistrich-Menü  und wählen Sie Kartenstil aus.

   

3. Deaktivieren Sie den Schalter 3D-Gebäude.

   

4. Nachdem Sie den Schalter 3D-Gebäude deaktiviert haben, klicken Sie auf das Markierungssymbol , um am ausgewählten Standort eine Ortsmarkierung hinzuzufügen.

5. Geben Sie ein Projekt an, das Ihre Ortsmarkierung enthalten soll, und klicken Sie auf Speichern.

6. Geben Sie im Feld Titel einen Namen für die Ortsmarkierung ein.

7. Klicken Sie im Projektbereich auf den Zurückpfeil  und wählen Sie das Dreipunkt-Menü  Weitere Aktionen aus.

8. Wählen Sie im Menü die Option Als KML-Datei exportieren aus.

   

In der KLM-Datei werden die Breite, Länge und Höhe eines Ortsmarks im <coordinates>-Tag durch Kommas getrennt angegeben, wie hier:

<coordinates>-122.0755182435043,37.41347299422944,7.420342565583832</coordinates>

Verwenden Sie nicht den Breiten- und Längengrad aus den <LookAt>-Tags, da diese die Kameraposition und nicht den Standort angeben.

Zum physischen Standort gehen

Sie können die Höhe eines Standorts berechnen, indem Sie sich dorthin begeben und eine lokale Beobachtung vornehmen.

Rotationsquaternion abrufen

GARGeospatialTransform.eastUpSouthQTarget extrahiert die Ausrichtung aus einer Geospatial-Transformation und gibt eine Quaternion aus, die die Rotationsmatrix darstellt, die einen Vektor vom Ziel in das Ost-auf-Süd-Koordinatensystem (EUS) transformiert. X+ zeigt nach Osten, Y+ nach oben und Z+ nach Süden. Die Werte werden in der Reihenfolge {x, y, z, w} geschrieben.

WGS84-Anker

Ein WGS84-Anchor ist eine Art Anchor, mit dem Sie 3D-Inhalte an einem beliebigen Breiten-, Längen- und Höhengrad platzieren können. Für die Platzierung in der realen Welt ist eine Transformation und eine Ausrichtung erforderlich. Die Position besteht aus einem Breiten- und Längengrad sowie einer Höhe, die im WGS84-Koordinatensystem angegeben sind. Die Ausrichtung besteht aus einer Quaternionsrotation.

Die Höhe wird in Metern über der WGS84-Referenzellipsoid angegeben, sodass die Bodenhöhe nicht bei null liegt. Ihre App muss diese Koordinaten für jeden erstellten Anker bereitstellen.

Platziere einen WGS84-Anker in der realen Welt

Höhe eines Standorts bestimmen

Es gibt mehrere Möglichkeiten, die Höhe eines Standorts für das Setzen von Markierungen zu ermitteln:

• Wenn sich der Ankerort in der Nähe des Nutzers befindet, können Sie eine Höhe verwenden, die der Höhe des Geräts des Nutzers entspricht.
• Sobald Sie die Breiten- und Längengrade haben, verwenden Sie die Elevation API, um eine Höhe gemäß der EGM96-Spezifikation abzurufen. Sie müssen die EGM96-Höhe der Maps API in WGS84 umrechnen, um sie mit der GARGeospatialTransform zu vergleichen. Weitere Informationen finden Sie unter GeoidEval, das sowohl eine Befehlszeile als auch eine HTML-Benutzeroberfläche hat. Die Google Maps API meldet automatisch Breiten- und Längengrade gemäß der WGS84-Spezifikation.
• Breiten- und Längengrad sowie Höhe eines Standorts können Sie in Google Earth abrufen. Das führt zu einer Fehlertoleranz von bis zu mehreren Metern. Verwenden Sie in der KML-Datei die Werte für Breiten-, Längengrad und Höhe aus den <coordinates>-Tags, nicht aus den <LookAt>-Tags.
• Wenn sich ein vorhandener Anker in der Nähe befindet und Sie sich nicht an einem steilen Hang befinden, können Sie die Höhe von der GARGeospatialTransform der Kamera verwenden, ohne eine andere Quelle wie die Maps API zu verwenden.

Anker erstellen

Wenn Sie den Breiten- und Längengrad, die Höhe und das Quaternion für die Drehung haben, können Sie mit createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error: Inhalte an den von Ihnen angegebenen geografischen Koordinaten verankern.

  NSError *error = nil;
  GARAnchor *anchor = [self.garSession createAnchorWithCoordinate:coordinate
                                                         altitude:altitude
                                               eastUpSouthQAnchor:eastUpSouthQAnchor
                                                            error:&error];

Hinweis :Das Erstellen von Markierungen innerhalb von 0,1 Grad vom Nord- oder Südpol (90 Grad bzw.−90 Grad) wird nicht unterstützt. Wenn ein solcher Anker angegeben wird, kann er nicht erstellt werden.

Geländeanker

Ein Geländeanker ist eine Art Anker, mit dem Sie AR-Objekte nur mithilfe von Längen- und Breitengraden platzieren können. Dabei werden Informationen aus dem VPS verwendet, um die genaue Höhe über dem Boden zu ermitteln.

Anstatt die gewünschte Höhe einzugeben, geben Sie die Höhe über dem Gelände an. Wenn dieser Wert null ist, liegt der Anker auf Höhe des Geländes.

Modus für die Flugzeugsuche festlegen

Die Suche nach der Ebene ist optional und nicht erforderlich, um Anker zu verwenden. Beachten Sie, dass nur horizontale Ebenen verwendet werden. Horizontale Ebenen erleichtern die dynamische Ausrichtung von Geländeankern auf dem Boden.

Wählen Sie mit ARWorldTrackingConfiguration.PlaneDetection aus, wie Flugzeuge in Ihrer App erkannt werden sollen.

Geländeanker mit der neuen Async API erstellen

Rufen Sie GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error: auf, um einen Geländeanker zu erstellen und zu platzieren.

Der Anker ist nicht sofort bereit und muss aufgelöst werden. Sobald das Problem behoben ist, ist es in der GARCreateAnchorOnTerrainFuture verfügbar.

GARCreateAnchorOnTerrainFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
                                                                altitudeAboveTerrain:altitude
                                                                  eastUpSouthQAnchor:eastUpSouthQTarget
                                                                   completionHandler:^(GARAnchor *anchor, GARTerrainAnchorState state) {
                                                                     // handle completion
                                                                   }
                                                                               error:&error];

Hinweis :Das Erstellen von Markierungen innerhalb von 0,1 Grad vom Nord- oder Südpol (90 Grad oder −90 Grad) wird nicht unterstützt. Wenn ein solcher Anker angegeben ist, gibt createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error: einen GARSessionErrorCodeInvalidArgument zurück und der Anker wird nicht erstellt.

„State of the Future“ prüfen

Der Zukunft ist ein GARFutureState zugeordnet.

Status	Beschreibung
GARFutureStatePending	Der Vorgang steht noch aus.
GARFutureStateDone	Der Vorgang ist abgeschlossen und das Ergebnis ist verfügbar.
GARFutureStateCancelled	Der Vorgang wurde abgebrochen.

Status des Geländeankers des zukünftigen Ergebnisses prüfen

GARTerrainAnchorState gehört zum asynchronen Vorgang und ist Teil des endgültigen Future-Ergebnisses.

switch (future.resultTerrainAnchorState) {
  case GARTerrainAnchorStateSuccess:
    // Terrain anchor finished resolving.
    break;
  case GARTerrainAnchorStateErrorUnsupportedLocation:
    // The requested anchor is in a location that isn't supported by the Geospatial API.
    break;
  case GARTerrainAnchorStateErrorNotAuthorized:
    // An error occurred while authorizing your app with the ARCore API. See
    // https://developers.google.com/ar/reference/ios/group/GARTerrainAnchorState#garterrainanchorstateerrornotauthorized
    // for troubleshooting steps.
    break;
  case GARTerrainAnchorStateErrorInternal:
    // The Terrain anchor could not be resolved due to an internal error.
    break;
  default:
    break;
}

Dachanker

Dachanker sind eine Art Anker und ähneln den oben beschriebenen Geländeankern. Der Unterschied besteht darin, dass Sie die Höhe über dem Dach angeben, nicht die Höhe über dem Gelände.

Hinweis :Für manche Standorte sind die Dachinformationen genauer als für andere. Weitere Informationen finden Sie im Abschnitt „Qualität“ unter Streetscape-Geometrie.

Dachanker mit der neuen Async API erstellen

Der Anker ist nicht sofort verfügbar und muss aufgelöst werden.

Rufen Sie GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error: auf, um einen Dachanker zu erstellen und zu platzieren. Ähnlich wie bei Geländeankern erhalten Sie auch Zugriff auf die GARFutureState der Zukunft. Anschließend können Sie das Ergebnis für die Zukunft prüfen, um auf die GARRooftopAnchorState zuzugreifen.

GARCreateAnchorOnRooftopFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
                                                                altitudeAboveRooftop:altitude
                                                                  eastUpSouthQAnchor:eastUpSouthQTarget
                                                                   completionHandler:^(GARAnchor *anchor, GARRooftopAnchorState state) {
                                                                     // handle completion
                                                                   }
                                                                               error:&error];

„State of the Future“ prüfen

Der Zukunft ist ein GARFutureState zugeordnet, siehe Tabelle oben.

Dachankerstatus des zukünftigen Ergebnisses prüfen

Die GARRooftopAnchorState gehört zum asynchronen Vorgang und ist Teil des endgültigen Future-Ergebnisses.

switch (future.resultRooftopAnchorState) {
  case GARRooftopAnchorStateSuccess:
    // Rooftop anchor finished resolving.
    break;
  case GARRooftopAnchorStateErrorUnsupportedLocation:
    // The requested anchor is in a location that isn't supported by the Geospatial API.
    break;
  case GARRooftopAnchorStateErrorNotAuthorized:
    // An error occurred while authorizing your app with the ARCore API. See
    // https://developers.google.com/ar/reference/ios/group/GARRooftopAnchorState#garrooftopanchorstateerrornotauthorized
    // for troubleshooting steps.
    break;
  case GARRooftopAnchorStateErrorInternal:
    // The Rooftop anchor could not be resolved due to an internal error.
    break;
  default:
    break;
}

Nächste Schritte

• Informieren Sie sich über das Kontingent für die Nutzung der Geospatial API.