Kotwice geoprzestrzenne to typ kotwic, które umożliwiają umieszczanie treści 3D w świecie rzeczywistym.
Typy kotwic geoprzestrzennych
Istnieją 3 typy kotwic geoprzestrzennych, z których każdy inaczej obsługuje wysokość:
Kotwice WGS84:
Kotwice WGS84 umożliwiają umieszczanie treści 3D o dowolnej szerokości, długości geograficznej i wysokości.Kotwice terenu:
Zakotwiczone elementy terenu umożliwiają umieszczanie treści wyłącznie na podstawie szerokości i długości geograficznej oraz wysokości zależnej od terenu w danej pozycji. Wysokość jest określana względem ziemi lub piętra, zgodnie ze wskazówką VPS.Kotwice na dachu:
Kotwice na dachu umożliwiają umieszczanie treści tylko przy użyciu szerokości i długości geograficznej, w stosunku do wysokości dachu budynku. Wysokość jest określana w odniesieniu do szczytu budynku, co jest znane przez narzędzie Streetscape Geometry. Jeśli nie ustawisz wysokości na budynku, domyślnie ustawiona będzie wysokość terenu.
| WGS84 | Teren | Dach | |
|---|---|---|---|
| Pozycja w poziomie | Szerokość geograficzna, długość geograficzna | Szerokość geograficzna, długość geograficzna | Szerokość geograficzna, długość geograficzna |
| Położenie w pionie | Względem wysokości WGS84 | Względem poziomu terenu określonego przez Mapy Google | Względem poziomu dachu określonego przez Mapy Google |
| Problem wymaga rozwiązania z serwera? | Nie | Tak | Tak |
Wymagania wstępne
Zanim przejdziesz dalej, włącz interfejs Geospatial API.
Umieść kotwice geoprzestrzenne
Każdy typ kotwicy używa specjalnych interfejsów API do ich tworzenia. Więcej informacji znajdziesz w artykule Typy zakotwiczonych kotwic geoprzestrzennych.
Tworzenie kotwicy z testu trafień
Możesz też utworzyć kotwicę geoprzestrzenną na podstawie wyniku testu działań.
Użyj funkcji Przekształcenie z testu działań i przekonwertuj ją na wartość GARGeospatialTransform. Możesz w niej umieścić dowolny z 3 opisanych typów zakotwiczenia.
Uzyskiwanie przekształceń geoprzestrzennych z przekształceń AR
GARSession.geospatialTransformFromTransform:error: zapewnia dodatkowy sposób określania szerokości i długości geograficznej przez przekształcenie przekształcenia AR w przekształcenie geoprzestrzenne.
Uzyskiwanie przekształceń AR z przekształceń geoprzestrzennych
GARSession.transformFromGeospatialCoordinate:altitude:eastUpSouthQTarget:error: konwertuje określone przez Ziemi położenie w poziomie, wysokość i obrót kwantonu względem ramki współrzędnych wschód-południe na przekształcenie AR w odniesieniu do współrzędnych globalnych GL.
Wybierz metodę odpowiednią do Twojego zastosowania
Każda metoda tworzenia kotwicy ma pewne ograniczenia, o których warto pamiętać:
- Jeśli używasz funkcji Streetscape Geometry, przeprowadź test trafień, aby dołączyć treści do budynku.
- Kotwice do terenu i na dachach preferują od kotwic z WGS84, ponieważ używają wartości wysokości określonych przez Mapy Google.
Określanie szerokości i długości geograficznej lokalizacji
Długość i szerokość geograficzną lokalizacji możesz obliczyć na 3 sposoby:
- Korzystaj z Kreatora geoprzestrzennego, by przeglądać i wzbogacać świat o materiały 3D bez konieczności fizycznego odwiedzania konkretnej lokalizacji. Dzięki temu możesz umieścić atrakcyjne treści 3D, korzystając z Map Google w edytorze Unity. Szerokość i długość geograficzna, obrót oraz wysokość nad poziomem morza zostaną obliczone automatycznie.
- Użyj Map Google
- korzystać z Google Earth, Pamiętaj, że uzyskanie tych współrzędnych w Google Earth, a nie w Mapach Google, spowoduje błąd z błędem sięgającym do kilku metrów.
- Przejdź do lokalizacji fizycznej
Użyj Map Google
Aby sprawdzić długość i szerokość geograficzną lokalizacji w Mapach Google:
Otwórz Mapy Google na komputerze.
Kliknij kolejno Warstwy > Więcej.
Zmień Typ mapy na Satelita i odznacz pole Widok kuli ziemskiej w lewym dolnym rogu ekranu.
Powoduje to wymuszenie widoku 2D i wyeliminowanie ewentualnych błędów, które mogą wynikać z widoku 3D pod kątem.
Na mapie kliknij lokalizację prawym przyciskiem myszy i wybierz długość i szerokość geograficzną, aby skopiować ją do schowka.
Korzystanie z Google Earth
W Google Earth możesz obliczyć szerokość i długość geograficzną lokalizacji, klikając lokalizację w interfejsie i odczytując dane ze szczegółów oznaczenia miejsca.
Aby sprawdzić długość i szerokość geograficzną lokalizacji w Google Earth:
Otwórz Google Earth na komputerze.
Przejdź do menu
i wybierz Styl mapy.Wyłącz przełącznik Budynki 3D.
Po przełączeniu przełącznika Budynki 3D kliknij ikonę pinezki
, aby dodać oznaczenie miejsca w wybranej lokalizacji.Określ projekt, w którym ma znajdować się oznaczenie miejsca, i kliknij Zapisz.
W polu Tytuł wpisz nazwę oznaczenia miejsca.
Kliknij strzałkę wstecz
w panelu projektu i wybierz menu 
Więcej działań.Z menu wybierz Eksportuj jako plik KML.
Plik KLM podaje w tagu <coordinates> szerokość i długość geograficzną oraz wysokość nad poziomem morza, rozdzielone przecinkami, w ten sposób:
<coordinates>-122.0755182435043,37.41347299422944,7.420342565583832</coordinates>
Nie używaj szerokości i długości geograficznej z tagów <LookAt>, które określają pozycję kamery, a nie jej lokalizację.
Przejdź do lokalizacji fizycznej
Aby obliczyć wysokość w danym miejscu, możesz się tam udać i zrobić lokalne obserwacje.
Pobierz kwaternion obrotu
GARGeospatialTransform.eastUpSouthQTarget wyodrębnia orientację z przekształcenia geoprzestrzennego i zwraca kwaternion, który reprezentuje macierz rotacji, która przekształca wektor z celu w układ współrzędnych wschód-południ (EUS). X+ punktów na wschód, Y+ punktów na południe, Z+ punktów na południe. Wartości są zapisywane w kolejności {x, y, z, w}.
Kotwice WGS84
Kotwica WGS84 to typ kotwicy, który umożliwia umieszczenie treści 3D o dowolnej szerokości, długości geograficznej i wysokości. Opiera się on na przekształceniu i orientacji, które trzeba umieścić w świecie rzeczywistym. Położenie obejmuje szerokość i długość geograficzną oraz wysokość, które są określane w układzie współrzędnych WGS84. Orientacja składa się z obrotu kwantonu.
Wysokość jest podawana w metrach powyżej referencyjnej elipsoidy WGS84, tak aby poziom gruntu nie miał wartości zero. Twoja aplikacja jest odpowiedzialna za podanie tych współrzędnych dla każdej utworzonej kotwicy.
Umieść kotwicę WGS84 w świecie rzeczywistym
Określanie wysokości lokalizacji
Istnieje kilka sposobów na określenie wysokości, na której będą umieszczane kotwice:
- Jeśli lokalizacja kotwicy znajduje się fizycznie blisko użytkownika, możesz użyć wysokości podobnej do wysokości urządzenia użytkownika.
- Po określeniu szerokości i długości geograficznej użyj interfejsu Elevation API, aby określić wysokość na podstawie specyfikacji EGM96. Aby porównać wysokość z wysokością
GARGeospatialTransform, musisz przekonwertować wysokość interfejsu API Map Google EGM96 na WGS84. Zapoznaj się z narzędziem GeoidEval, które zawiera zarówno wiersz poleceń, jak i interfejs HTML. Interfejs API Map Google od razu raportuje szerokość i długość geograficzną zgodnie ze specyfikacją WGS84. - Szerokość i długość geograficzną oraz wysokość nad poziomem morza możesz uzyskać w Google Earth. Spowoduje to wystąpienie błędu z błędem do kilku metrów. Użyj szerokości i długości geograficznej oraz wysokości z tagów
<coordinates>, a nie z tagów<LookAt>w pliku KML. - Jeśli istniejąca kotwica znajduje się w pobliżu i jeśli nie jesteś na stromym zboczu, możesz użyć wysokości
GARGeospatialTransformkamery bez innego źródła, takiego jak interfejs API Map Google.
Tworzenie kotwicy
Gdy podasz długość i szerokość geograficzną (wysokość, wysokość i kwitanion obrotu), użyj createAnchorWithCoordinate:altitude:eastUpSouthQAnchor:error:, aby zakotwiczyć treści w określonych współrzędnych geograficznych.
NSError *error = nil;
GARAnchor *anchor = [self.garSession createAnchorWithCoordinate:coordinate
altitude:altitude
eastUpSouthQAnchor:eastUpSouthQAnchor
error:&error];
Kotwice terenu
Kotwica terenu to typ kotwicy, który umożliwia umieszczanie obiektów AR tylko na podstawie szerokości i długości geograficznej. Korzystając z informacji z VPS, możesz określić dokładną wysokość nad ziemią.
Zamiast wprowadzać żądaną wysokość, podaje się wysokość nad terenem. Jeśli wartość wynosi zero, kotwica będzie wyrównana względem terenu.
Ustawianie trybu wyszukiwania samolotu
Znajdowanie płaszczyzny jest opcjonalne i nie jest wymagane przy korzystaniu z kotwic. Pamiętaj, że używane są tylko płaszczyzny poziome. Płaszczyny poziome ułatwiają dynamiczne wyrównywanie punktów zakotwiczenia terenu na powierzchni ziemi.
Użyj ARWorldTrackingConfiguration.PlaneDetection, aby wybrać sposób, w jaki aplikacja ma wykrywać samoloty.
Utwórz kotwicę terenu za pomocą nowego interfejsu Async API
Aby utworzyć i umieścić kotwicę terenu, wywołaj metodę GARSession.createAnchorWithCoordinate:altitudeAboveTerrain:eastUpSouthQAnchor:completionHandler:error:.
Reklama zakotwiczona nie będzie gotowa od razu i trzeba rozwiązać ten problem. Po rozwiązaniu problemu będzie on dostępny w GARCreateAnchorOnTerrainFuture.
GARCreateAnchorOnTerrainFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveTerrain:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARTerrainAnchorState state) {
// handle completion
}
error:&error];
Poznaj przyszłość
Przyszłość będzie powiązana z elementem GARFutureState.
| Stan | Opis |
|---|---|
GARFutureStatePending |
Operacja jest nadal w toku. |
GARFutureStateDone |
Operacja została zakończona, a wynik jest dostępny. |
GARFutureStateCancelled |
Operacja została anulowana. |
Sprawdzanie stanu zakotwiczenia terenu w wyniku Przyszłość
GARTerrainAnchorState należy do operacji asynchronicznej i jest częścią ostatecznego wyniku typu Future.
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;
}
Kotwice dachowe
Kotwice dachowe to rodzaj kotwic, które są bardzo podobne do kotwic terenowych powyżej. Różnica polega na tym, że podajesz wysokość nad dachem, a nie nad powierzchnią terenu.
Utwórz kotwicę na dachu za pomocą nowego interfejsu Async API
Reklama zakotwiczona nie będzie gotowa od razu i trzeba rozwiązać ten problem.
Aby utworzyć i umieścić na dachu kotwicę, wywołaj GARSession.createAnchorWithCoordinate:altitudeAboveRooftop:eastUpSouthQAnchor:completionHandler:error:. Podobnie jak w przypadku zakotwiczonych miejsc, masz też dostęp do GARFutureState przyszłości. Następnie możesz sprawdzić wynik Przyszły, aby uzyskać dostęp do GARRooftopAnchorState.
GARCreateAnchorOnRooftopFuture *future = [self.garSession createAnchorWithCoordinate:coordinate
altitudeAboveRooftop:altitude
eastUpSouthQAnchor:eastUpSouthQTarget
completionHandler:^(GARAnchor *anchor, GARRooftopAnchorState state) {
// handle completion
}
error:&error];
Poznaj przyszłość
Przyszłość będzie powiązana z elementem GARFutureState (patrz tabela powyżej).
Sprawdź stan zakotwiczenia na dachu w wyniku Przyszłości
GARRooftopAnchorState należy do operacji asynchronicznej i jest częścią ostatecznego wyniku typu Future.
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;
}
Co dalej
- Upewnij się, że znasz limit wykorzystania interfejsu API geoprzestrzennych.