Krótkie wprowadzenie do danych geoprzestrzennych na Androida

Ten krótki przewodnik po interfejsie ARCore Geospatial API pokazuje, jak uruchomić w Android Studio aplikację demonstrującą Geospatial API.

Przewodnik po tworzeniu własnej aplikacji za pomocą interfejsu Geospatial API znajdziesz w przewodniku Geospatial API dla programistów na Androida (Kotlin/Java) lub przewodniku Geospatial API dla programistów na Androida NDK (C).

Zobacz Wprowadzenie do interfejsu ARCore Geospatial API informacje o interfejsie Geospatial API.

Jeśli nie masz doświadczenia w programowaniu z ARCore, przeczytaj artykuł Pierwsze kroki.

Wymagania

Obsługa urządzeń

Pełną listę urządzeń, które obsługują tę funkcję, znajdziesz w sekcji Obsługiwane urządzenia mają certyfikat współpracy z ARCore. W przypadku interfejsu Geospatial API jednym z kluczowych elementów sprzętowych jest magnetometr zgodny ze specyfikacją interfejsu Geospatial API. Niektóre magnetometry nie są zgodne ze specyfikacją. urządzeń z tymi funkcjami nie są obsługiwane.

Oprogramowanie

  • Najnowsza wersja Usług Google Play dla AR zainstalowanych na obsługiwanym urządzeniu.

  • Android Studio w wersji 3.0 lub nowszej, z pakietem Android SDK Platform w wersji 7.0 (poziom interfejsu API 24) lub nowszym

  • Pakiet ARCore SDK na Androida, który możesz pobrać na 2 sposoby:

    • Pobierz GitHub i wyodrębnij go na komputerze.

    • Wykonaj klona 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 zawarty w pakiecie ARCore SDK na Androida opisuje kod wywołujący interfejs Geospatial API.

  1. W Android Studio w menu Plik kliknij Otwórz.

  2. Przejdź do folderu projektu dla pakietu arcore-android-sdk.

  3. Otwórz folder samples, wybierz folder geospatial_java i kliknij Otwórz.

Konfigurowanie projektu Google Cloud

Aby korzystać z wizualnego systemu pozycjonowania (VPS), aplikacja musi być powiązana z projektem Google Cloud, w którym włączono interfejs ARCore API. Aby skonfigurować autoryzację, przeczytaj artykuł Używanie interfejsu ARCore API w Google Cloud. Możesz wybrać autoryzację bez klucza lub klucza interfejsu API.

Uruchamianie przykładowej aplikacji

Uruchom przykładową aplikację w Android Studio.

Powinien być widoczny widok z kamery wraz z opisem danych debugowania bieżącej pozycji geoprzestrzennej urządzenia. Skanując otoczenie, zauważ, że wartości ufności dotyczące dokładności określania pozycji mogą się zmieniać, jeśli znajdujesz się w obszarze obsługiwanym przez lokalizację VPS.

Gdy ARCore ma pewność co do lokalizacji i kierunku urządzenia, możesz umieścić Zakotwicz swoją bieżącą lokalizację, korzystając z pozycji geoprzestrzennej.

Dokładność pozycjonowania może być zbyt niska, jeśli informacje VPS są niedostępne. Aplikacja musi być połączona z internetem, a VPS musi znać lokalizację. Aby uzyskać najlepsze wyniki, uruchamiaj przykładową aplikację na zewnątrz (nie wewnątrz budynków) w ciągu dnia.

Jeśli znajdziesz się na obszarze, w którym nie są obsługiwane VPS, lub jeśli sygnały GPS nie jest wystarczające, może być konieczne dostosowanie progów ufności w aplikacji, aby aby umieścić reklamę zakotwiczoną.

Aby dostosować progi:

  1. W Android Studio otwórz GeospatialActivity i przejdź do ta sekcja:

    // 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 niższa dokładność.

    Zmniejszenie dokładności daje aplikacji większą szerokość miejsca zakotwiczenia. Zobacz Dostosowywanie dokładności pozycji .

Dalsze kroki