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 pozycji z testu działań i przekonwertuj ją na GeospatialPose
. Możesz w niej umieścić dowolny z 3 opisanych typów zakotwiczenia.
Zdjęcie geoprzestrzenne w pozycji AR
AREarthManager.Convert(Pose)
zapewnia dodatkowy sposób określania szerokości i długości geograficznej przez przekształcanie pozycji AR na pozycję geoprzestrzenną.
Zdjęcia AR w pozycji geoprzestrzennej
AREarthManager.Convert(GeospatialPose)
konwertuje określone przez Ziemi położenie w poziomie, wysokość i obrót kwantonu względem układu współrzędnych wschód-południe na położenie AR w odniesieniu do współrzędnych globalnych w 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
GeospatialPose.EunRotation
wyodrębnia orientację z pozycji geoprzestrzennej i generuje kwaternion, który reprezentuje macierz rotacji, która przekształca wektor z celu w układ współrzędnych wschód-północ (EUN). X+ wskazuje na wschód, Y+ w górę od grawitacji, a Z+ na północ.
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 pozycji 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ą
GeospatialPose
, 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
GeospatialPose
kamery 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 ARAnchorManagerExtensions.AddAnchor()
, aby zakotwiczyć treści w określonych współrzędnych geograficznych.
if (earthTrackingState == TrackingState.Tracking)
{
var anchor =
AnchorManager.AddAnchor(
latitude,
longitude,
altitude,
quaternion);
var anchoredAsset = Instantiate(GeospatialAssetPrefab, anchor.transform);
}
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.
Pamiętaj, że na kotwice terenu wpływają Horizontal
i Horizontal | Vertical
.
Aby ustawić tryb wykrywania, użyj menu Tryb wykrywania:
Utwórz kotwicę terenu za pomocą nowego interfejsu Async API
Aby utworzyć i umieścić kotwicę terenu, wywołaj metodę ARAnchorManagerExtensions.resolveAnchorOnTerrainAsync()
.
Reklama zakotwiczona nie będzie gotowa od razu i trzeba rozwiązać ten problem. Po rozwiązaniu problemu będzie on dostępny w ResolveAnchorOnTerrainPromise
.
public GameObject TerrainAnchorPrefab;
public void Update()
{
ResolveAnchorOnTerrainPromise terrainPromise =
AnchorManager.ResolveAnchorOnTerrainAsync(
latitude, longitude, altitudeAboveTerrain, eunRotation);
// The anchor will need to be resolved.
StartCoroutine(CheckTerrainPromise(terrainPromise));
}
private IEnumerator CheckTerrainPromise(ResolveAnchorOnTerrainPromise promise)
{
yield return promise;
var result = promise.Result;
if (result.TerrainAnchorState == TerrainAnchorState.Success &&
result.Anchor != null)
{
// resolving anchor succeeded
GameObject anchorGO = Instantiate(TerrainAnchorPrefab,
result.Anchor.gameObject.transform);
anchorGO.transform.parent = result.Anchor.gameObject.transform;
}
else
{
// resolving anchor failed
}
yield break;
}
Sprawdź stan obietnicy
Obietnica będzie powiązana z obietnicą PromiseState
.
Stan | Opis |
---|---|
Pending |
Operacja jest nadal w toku. |
Done |
Operacja została zakończona, a wynik jest dostępny. |
Cancelled |
Operacja została anulowana. |
Sprawdź stan zakotwiczenia terenu w wyniku Promise
TerrainAnchorState
należy do operacji asynchronicznej i jest częścią ostatecznej obietnicy.
switch (result.TerrainAnchorState)
{
case TerrainAnchorState.Success:
// Anchor has successfully resolved
break;
case TerrainAnchorState.ErrorUnsupportedLocation:
// The requested anchor is in a location that isn't supported by the Geospatial API.
break;
case TerrainAnchorState.ErrorNotAuthorized:
// An error occurred while authorizing your app with the ARCore API. See
// https://developers.google.com/ar/reference/unity-arf/namespace/Google/XR/ARCoreExtensions#terrainanchorstate_errornotauthorized
// for troubleshooting steps.
break;
case TerrainAnchorState.ErrorInternal:
// 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 ARAnchorManagerExtensions.resolveAnchorOnRooftopAsync()
. Podobnie jak w przypadku zakotwiczonych miejsc, masz też dostęp do elementu PromiseState
Promise. Następnie możesz sprawdzić wynik Promise, aby uzyskać dostęp do RooftopAnchorState
.
public GameObject RooftopAnchorPrefab;
public void Update()
{
ResolveAnchorOnRooftopPromise rooftopPromise =
AnchorManager.ResolveAnchorOnRooftopAsync(
latitude, longitude, altitudeAboveRooftop, eunRotation);
// The anchor will need to be resolved.
StartCoroutine(CheckRooftopPromise(rooftopPromise));
}
private IEnumerator CheckRooftopPromise(ResolveAnchorOnTerrainPromise promise)
{
yield return promise;
var result = promise.Result;
if (result.RooftopAnchorState == RooftopAnchorState.Success &&
result.Anchor != null)
{
// resolving anchor succeeded
GameObject anchorGO = Instantiate(RooftopAnchorPrefab,
result.Anchor.gameObject.transform);
anchorGO.transform.parent = result.Anchor.gameObject.transform;
}
else
{
// resolving anchor failed
}
yield break;
}
Sprawdź stan obietnicy
Obietnica będzie powiązana z elementem PromiseState
(patrz tabela powyżej).
Sprawdź stan kotwicy na dachu w wyniku Promise
RooftopAnchorState
należy do operacji asynchronicznej i jest częścią ostatecznej obietnicy.
switch (result.RooftopAnchorState)
{
case TerrainAnchorState.Success:
// Anchor has successfully resolved
break;
case RooftopAnchorState.ErrorUnsupportedLocation:
// The requested anchor is in a location that isn't supported by the Geospatial API.
break;
case RooftopAnchorState.ErrorNotAuthorized:
// An error occurred while authorizing your app with the ARCore API. See
// https://developers.google.com/ar/reference/unity-arf/namespace/Google/XR/ARCoreExtensions#terrainanchorstate_errornotauthorized
// for troubleshooting steps.
break;
case RooftopAnchorState.ErrorInternal:
// 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.