Wypróbuj wersję demonstracyjną

Dzięki integracji pakietu Navigation SDK na Androida aplikacja może mieć nie tylko połączenie z zewnętrznym widokiem mapy. Dzięki Nawigacji w Mapach Google Twoja aplikacja może umożliwiać dynamiczne pobieranie i raportowanie danych o ścieżce użytkownika. W tym przewodniku wyjaśniamy, jak uruchamiać aplikacje demonstracyjne pakietu Navigation SDK, które są dostępne na GitHubie.

Przygotuj się

Aby rozpocząć korzystanie z pakietu Navigation SDK, musisz przygotować następujące elementy.

  • Przedstawiciel Google Maps Platform w celu uzyskania dostępu do tych danych:

    • Klucz interfejsu API udostępniony do użycia z pakietem SDK nawigacji. Musisz podać swój identyfikator projektu, który znajdziesz pod nazwą projektu w głównym panelu konsoli Google Cloud.
    • Artefakt pakietu SDK. Upewnij się, że projekt jest skonfigurowany do używania narzędzia Maven na potrzeby pakietu Navigation SDK.
    • Dla projektów korzystających z wersji 4.99.0 lub starszej. Jeśli nie możesz używać Maven, możesz pobrać skompresowany artefakt z udostępnionego Dysku Google. Plik biblioteki statycznej to plik .aar w katalogu libs/ zawierającym pakiet Navigation SDK w formie pakietu AAR.
    • co najmniej jedną z aplikacji w wersji demonstracyjnej.
    • Android Studio – zalecane środowisko programistyczne do tworzenia aplikacji przy użyciu pakietu Navigation SDK.

Ta dokumentacja jest przeznaczona dla osób znających programowanie na Androida i koncepcje programowania zorientowane na obiekty. Musisz też zapoznać się z Mapami Google z punktu widzenia użytkowników.

Pobierz aplikacje w wersji demonstracyjnej

W zależności od poziomu doświadczenia Google udostępnia 2 aplikacje uzupełniające interfejsy API Map Google, które pomogą Ci zrozumieć, jakie korzyści oferuje pakiet Navigation SDK. Programiści znający interfejsy API Map Google mogą skupić się na demonstracji Nawigacji. Deweloperzy, którzy nie mają doświadczenia z obydwoma projektami, mogą okazać się przydatne.

Od pakietu Navigation SDK na Androida w wersji 4.1 te aplikacje demonstracyjne są dostępne do pobrania z GitHub.

  • Prezentacja nawigacji Google: przedstawia integrację działań i widoków interfejsu API w odniesieniu do wrażeń użytkownika podczas sesji nawigacji z przewodnikiem.

  • Prezentacja GoogleMap: pokazuje indywidualne zachowania interfejsu GoogleMap, aby dostosować wygląd i sposób wyświetlania map.

Uwaga na temat korzystania z narzędzia Maven

Aplikacje w wersji demonstracyjnej są skonfigurowane do pobierania artefaktu pakietu SDK ze zdalnego repozytorium Maven za pomocą wtyczki Artifact Registry w Gradle. Aby uzyskać dostęp do pakietu SDK, postępuj zgodnie z instrukcjami konfiguracji projektu.

Demo Nawigacji Google

Najnowsza wersja demonstracyjna Nawigacji Google jest dostępna na GitHub.

Tworzę

  1. W Android Studio zaimportuj aplikację w wersji demonstracyjnej i zezwól na uruchomienie Gradle.

  2. Otwórz local.defaults.properties i zaktualizuj wartość właściwości MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Kliknij Utwórz i sprawdź szczegóły implementacji pakietu SDK.

    • W klasie Java zwróć uwagę na kod implementacji.

    • Zwróć uwagę na projekt i tekst w szablonie XML.

    • W pliku build.gradle zwróć uwagę na pakiet SDK w zależnościach.

Więcej informacji o dodawaniu klucza interfejsu API do pliku manifestu znajdziesz w dokumentacji wtyczki do Gradle obiektów tajnych.

Uruchomiono

  1. Podłącz urządzenie z Androidem do komputera lub użyj emulatora.

    • Urządzenie z Androidem – zapoznaj się z instructions, aby włączyć opcje programisty na urządzeniu z Androidem i skonfigurować system w taki sposób, aby wykrywał urządzenie.
    • Emulatormdash; skonfiguruj urządzenie wirtualne za pomocą menedżera urządzeń wirtualnych z Androidem (AVD). Przy wyborze emulatora wybierz obraz zawierający interfejsy API Google.

  2. W Android Studio kliknij menu Uruchom (lub ikonę przycisku odtwarzania), a następnie wybierz cel wdrożenia.

Po utworzeniu i uruchomieniu aplikacja wyświetla użytkownikowi stronę docelową z listą opcji.

Nowi użytkownicy NavSDK prawdopodobnie uznają te 2 opcje za najbardziej przydatne.

Opcja 1: NavViewActivity pokazuje zachowania, używając NavigationView w połączeniu z Navigator.

Opcja 2. Druga opcja o nazwie NavFragmentActivity pozwala zaprezentować zachowania przy użyciu ikony SupportNavigationFragment obok Navigator.

Po kliknięciu jednej z tych opcji zostaną wyświetlone następujące opcje:

  • interfejs nawigacji
  • przycisk „Ustaw miejsce docelowe” w menu aplikacji,
  • z nakładką umożliwiającą dynamiczne wywoływanie metod w interfejsie API
  • rozszerzone menu z większą liczbą opcji

Aby rozpocząć, kliknij Ustaw miejsce docelowe i wybierz adres. Następnie aplikacja symuluje podróż z Twojej obecnej lokalizacji do tego adresu. Skorzystaj z nakładki paneli sterowania, aby sprawdzić, co się dzieje po wywołaniu interfejsu API. Możesz na przykład kliknąć Wyświetl metody, aby przełączyć pakiet SDK w tryb nocny i sprawdzić, jak to wygląda.

Opcja switchpingMapAndNavActivity

SwappingMapAndNavActivity obejmuje te typowe wzorce:

Wersja demonstracyjna Map Google

Najnowsza wersja demonstracyjna Nawigacji Google jest dostępna na GitHub.

Tworzę

  1. W Android Studio zaimportuj aplikację w wersji demonstracyjnej i zezwól na uruchomienie Gradle.

  2. Otwórz local.defaults.properties i zaktualizuj wartość właściwości MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Kliknij Utwórz i sprawdź szczegóły implementacji pakietu SDK.

    • W klasie Java zwróć uwagę na kod implementacji.

    • Zwróć uwagę na projekt i tekst w szablonie XML.

    • W pliku build.gradle zwróć uwagę na pakiet SDK w zależnościach.

Więcej informacji o dodawaniu klucza interfejsu API do pliku manifestu znajdziesz w artykule secrets gradle plugin.

Uruchomiono

  1. Podłącz urządzenie z Androidem do komputera lub użyj emulatora.

    • Urządzenie z Androidem: zapoznaj się z instructions, aby włączyć opcje programisty na urządzeniu z Androidem i skonfigurować system w taki sposób, aby wykrywał urządzenie.
    • Emulator Skonfiguruj urządzenie wirtualne za pomocą Menedżera urządzeń wirtualnych Android (AVD). Przy wyborze emulatora wybierz obraz zawierający interfejsy API Google.

  2. W Android Studio kliknij menu Uruchom (lub ikonę przycisku odtwarzania), a następnie wybierz cel wdrożenia.

Po utworzeniu i uruchomieniu aplikacja wyświetla użytkownikowi stronę docelową z listą wersji demonstracyjnych.

Ten wzorzec prezentacji i odpowiadająca mu struktura kodu źródłowego powinny być znane użytkownikom wersji demonstracyjnych pakietu SDK Map Google. Wynika to z tego, że wersja demonstracyjna GoogleMap została zaprojektowana tak, by przypominała aplikację demonstracyjną interfejsu Maps API. Główna różnica polega na tym, że wersja demonstracyjna pakietu Navigation SDK umożliwia użytkownikowi wybranie klasy widoku, którą chce przetestować i uruchomienia w przypadku: NavigationView lub MapView (w stosownych przypadkach).

Google zwykle zachęca użytkowników do korzystania z narzędzia NavigationView. Dzięki tej wersji demonstracyjnej możesz wypróbować te funkcje w obu wersjach aplikacji i wybrać opcję, która najbardziej Ci odpowiada. Na przykład użycie MapView może być nadal konieczne w sytuacjach, gdy korzystasz z biblioteki innej firmy, która oczekuje interakcji z tą klasą.