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:
WGS84-Markierungen:
Mit WGS84-Markierungen können Sie 3D-Inhalte an einem beliebigen Breiten-, Längen- und Höhengrad platzieren.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.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:
Rufen Sie auf Ihrem Computer Google Maps auf.
Klicken Sie auf Ebenen > Dreipunkt-Menü.
Ä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.
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.
So rufen Sie mit Google Earth den Breiten- und Längengrad eines Orts ab:
Rufen Sie auf Ihrem Computer Google Earth auf.
Öffnen Sie das Dreistrich-Menü
und wählen Sie Kartenstil aus.Deaktivieren Sie den Schalter 3D-Gebäude.
Nachdem Sie den Schalter 3D-Gebäude deaktiviert haben, klicken Sie auf das Markierungssymbol
, um am ausgewählten Standort eine Ortsmarkierung hinzuzufügen.Geben Sie ein Projekt an, das Ihre Ortsmarkierung enthalten soll, und klicken Sie auf Speichern.
Geben Sie im Feld Titel einen Namen für die Ortsmarkierung ein.
Klicken Sie im Projektbereich auf den Zurückpfeil
und wählen Sie das Dreipunkt-Menü 
Weitere Aktionen aus.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
GARGeospatialTransformzu 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
GARGeospatialTransformder 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];
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];
„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.
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.