Z tego krótkiego wprowadzenia do ARCore Geospatial API dowiesz się, jak uruchomić w Android Studio przykładową aplikację, która prezentuje interfejs Geospatial API.
Wskazówki dotyczące tworzenia własnej aplikacji przy użyciu interfejsu Geospatial API znajdziesz w przewodniku dla programistów dotyczącym danych geoprzestrzennych na Androida (Kotlin/Java) lub w przewodniku dla programistów dotyczącym danych geoprzestrzennych na Androida NDK (C).
Więcej informacji o interfejsie Geospatial API znajdziesz w artykule Wprowadzenie do ARCore Geospatial API.
Jeśli nie masz doświadczenia w programowaniu z ARCore, zobacz Pierwsze kroki.
Wymagania
Pomoc dotycząca urządzenia
Pełną listę urządzeń, które mają certyfikat zgodności z ARCore, znajdziesz w sekcji Obsługiwane urządzenia. Jednym z najważniejszych elementów niezbędnych do korzystania z interfejsu Geospatial API jest magnetometr zgodny ze specyfikacją tego interfejsu. Niektóre magnetometry nie spełniają wymagań. Urządzenia z niestandardowymi magnetometrami nie są obsługiwane.
Oprogramowanie
Najnowsza wersja Usług Google Play dla AR zainstalowana na obsługiwanym urządzeniu.
Android Studio w wersji 3.0 lub nowszej z Androidem SDK Platform w wersji 7.0 (poziom interfejsu API 24) lub nowszym;
Pakiet ARCore SDK na Androida, który można pobrać na 2 sposoby:
Pobierz go z GitHub i rozpakuj na swój komputer.
Sklonuj repozytorium za pomocą tego polecenia:
git clone https://github.com/google-ar/arcore-android-sdk.git
Otwieranie i konfigurowanie przykładowej aplikacji
Projekt geospatial_java dołączony do pakietu SDK ARCore na Androida zawiera opis kodu, który wywołuje interfejs Geospatial API.
W Android Studio otwórz menu Plik i kliknij Otwórz.
Otwórz folder projektu dla arcore-android-sdk.
Otwórz folder Przykłady, wybierz folder geospatial_java i kliknij Otwórz.
Konfigurowanie projektu Google Cloud
Aby korzystać z systemu Visual Positioning System (VPS), musisz powiązać aplikację z projektem Google Cloud, który obsługuje interfejs ARCore API. Informacje o tym, jak skonfigurować autoryzację, znajdziesz w artykule o używaniu ARCore API w Google Cloud. Możesz wybrać autoryzację bez klucza lub za pomocą klucza interfejsu API.
Uruchamianie przykładowej aplikacji
W Android Studio uruchom przykładową aplikację.
Powinien być widoczny widok z kamery wraz z informacjami na temat debugowania opisującymi aktualną pozycję geoprzestrzenną Twojego urządzenia. Skanując otoczenie, pamiętaj, że wartości ufności dokładności określania pozycji mogą się zmieniać w miarę przemieszczania się, jeśli znajdujesz się w obszarze obsługiwanym przez VPS.
Gdy ARCore ma pewność co do lokalizacji i nagłówka urządzenia, możesz umieścić kotwicę w bieżącej lokalizacji, korzystając z pozycji geoprzestrzennej.
Dokładność pozycjonowania może być zbyt niska, jeśli informacje dotyczące VPS są niedostępne. Aplikacja musi być połączona z internetem, a VPS musi znać lokalizację. Aby uzyskać najlepsze wyniki, uruchom przykładową aplikację na zewnątrz (nie wewnątrz budynku) w ciągu dnia.
Jeśli znajdujesz się w obszarze, który nie obsługuje VPS, lub sygnał GPS jest niewystarczający, być może trzeba będzie skorygować progi ufności w aplikacji, aby umieścić kotwicę.
Aby dostosować progi:
W Android Studio otwórz GeospatialActivity i przejdź do tej sekcji:
// The thresholds that are required for horizontal and heading accuracies before entering into the // LOCALIZED state. Once the accuracies are equal or less than these values, the app will // allow the user to place anchors. private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10; private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;
W razie potrzeby dostosuj te wartości. Im wyższa wartość, tym mniejsza dokładność.
Niższa dokładność pozwala aplikacji na większą szerokość w miejscu zakotwiczenia. Więcej informacji znajdziesz w artykule Dostosowywanie dokładności ułożenia.
Dalsze kroki
Powtórz ćwiczenia z programowania dotyczące danych geoprzestrzennych.
Zapoznaj się z przewodnikiem dla programistów dotyczącym danych geoprzestrzennych na Androida (Kotlin/Java) lub przewodnikiem dla programistów dotyczącym danych geoprzestrzennych na Androida NDK (C) i zacznij tworzyć dane z użyciem interfejsu Geospatial API.