Krótkie wprowadzenie do danych geoprzestrzennych na Androida

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.

  1. W Android Studio otwórz menu Plik i kliknij Otwórz.

  2. Otwórz folder projektu dla arcore-android-sdk.

  3. 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:

  1. 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;

  2. 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