Wypróbuj wersję demonstracyjną

Dzięki integracji pakietu SDK nawigacji na Androida Twoja aplikacja może mieć coś więcej niż tylko link do zewnętrznego widoku mapy. Dzięki nawigacji w Mapach Google aplikacja może oferować dynamiczne pobieranie i raportowanie danych o podróży kierowcy.

W tym przewodniku przedstawiamy projekt Android Studio oraz pokazujemy, jak zintegrować pakiet Navigation SDK, a także pokazujemy, jak uruchamiać aplikacje demonstracyjne.

Pakiet Navigation SDK to biblioteka statyczna, która zapewnia kontrolę nad wyglądem i dźwiękiem podczas nawigacji w aplikacji. Aby uzyskać szczegółowe informacje o bibliotece, otwórz Dokumentacja pakietu SDK nawigacyjnego (Javadoc) w oddzielnym oknie.

Przygotuj się

Aby rozpocząć korzystanie z pakietu Navigation SDK, musisz mieć te elementy.

  • przedstawiciel Google Maps Platform, który zapewnia dostęp do tych usług:

    • Klucz interfejsu API udostępniony do użytku z pakietem Navigation SDK. Musisz podać identyfikator projektu, który znajdziesz pod nazwą projektu w panelu głównym konsoli Google Cloud.
    • Artefakt pakietu SDK. Upewnij się, że w Twoim projekcie jest używany pakiet Maven na potrzeby pakietu SDK nawigacji.
    • Dla projektów korzystających z wersji 4.99.0 lub starszej. Jeśli nie możesz korzystać z Maven, możesz pobrać skompresowany artefakt z udostępnionego Dysku Google. Plik biblioteki statycznej to plik .aar w katalogu libs/ zawierającym pakiet SDK nawigacji jako pakiet AAR.
    • Co najmniej jedna z aplikacji demonstracyjnych.

  • Android Studio – zalecane środowisko programistyczne do tworzenia aplikacji za pomocą pakietu Navigation SDK.

Ta dokumentacja jest przeznaczona dla osób, które znają pojęcia związane z programowaniem na Androida i programowaniem zorientowanym na obiekty. Musisz też spojrzeć na Mapy Google z perspektywy użytkownika.

Pobierz aplikacje w wersji demonstracyjnej

Google udostępnia 2 aplikacje, które w zależności od Twojego poziomu doświadczenia pomogą Ci zrozumieć, co oprócz interfejsów API Map Google oferuje pakiet Navigation SDK. Programiści, którzy znają interfejsy API Map Google, mogą skupić się na prezentacji funkcji Nawigacji Google. Z pewnością spodobają się one deweloperom obu projektów.

Od pakietu Navigation SDK na Androida w wersji 4.1 poniższe aplikacje demonstracyjne są dostępne do pobrania na udostępnionym Dysku Google.

  • Prezentacja nawigacji Google: prezentacja integracji zachowań i widoków interfejsu API w zależności od wrażeń użytkownika podczas sesji nawigacji.

  • Prezentacja Map Google: pokazuje indywidualne zachowania interfejsu GoogleMap, dzięki czemu możesz dostosować charakter i sposób wyświetlania map.

Uwaga na temat korzystania z narzędzia Maven

Aplikacje demonstracyjne są skonfigurowane tak, aby pobierały artefakt pakietu SDK ze zdalnego repozytorium Maven przy użyciu wtyczki Artifact Registry w Gradle. Aby uzyskać dostęp do pakietu SDK, postępuj zgodnie z instrukcjami konfigurowania projektu.

Prezentacja nawigacji Google

Najnowsza wersja demonstracyjna Nawigacji Google jest dostępna w katalogu głównym udostępnionego Dysku Google. Poprzednie wersje aplikacji znajdziesz w „Archiwum”. W przypadku wersji wcześniejszych niż 4.1 aplikacja jest połączona z AAR w tym samym pliku ZIP.

Budynek

  1. W Android Studio zaimportuj aplikację demonstracyjną 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.

    • Zwróć uwagę na kod implementacji w klasie Java.

    • W pliku XML układu zwróć uwagę na projekt układu i tekst.

    • W pliku build.gradle zanotuj pakiet SDK w zależnościach.

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

Odliczanie

  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: urządzenie wirtualne można skonfigurować za pomocą Menedżera urządzeń wirtualnych (AVD) Android. Wybierając emulator, pamiętaj, aby wybrać obraz zawierający interfejsy API Google.

  2. W Android Studio kliknij opcję 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 pakietu NavSDK prawdopodobnie uznają te 2 opcje za najskuteczniejsze.

Opcja 1: NavViewActivity pokazuje zachowania za pomocą symbolu NavigationView w połączeniu z elementem Navigator.

Opcja 2. Druga opcja o nazwie NavFragmentActivity zawiera zachowania przy użyciu symbolu SupportNavigationFragment obok elementu Navigator.

Po kliknięciu jednej z tych opcji zobaczysz te informacje:

  • interfejs nawigacji
  • przycisk „Ustaw miejsce docelowe” w menu aplikacji;
  • nakładka, z której możesz korzystać w celu dynamicznego wywoływania metod w interfejsie API
  • rozszerzone menu z większą liczbą opcji

Aby rozpocząć, kliknij Ustaw miejsce docelowe i wybierz adres. Następnie aplikacja symuluje trasę z Twojej bieżącej lokalizacji do tego adresu. Dzięki nakładce paneli sterowania możesz sprawdzić, co się dzieje, gdy wywołujesz interfejs API. Możesz na przykład kliknąć View Methods (Wyświetl metody), aby wymusić tryb nocny dla pakietu SDK i sprawdzić, jak to wygląda.

Opcja ReplacepingMapAndNavActivity

SwappingMapAndNavActivity przedstawia te typowe wzorce:

Prezentacja Map Google

Najnowsza wersja demonstracyjna Nawigacji Google jest dostępna w katalogu głównym udostępnionego Dysku Google. Poprzednie wersje aplikacji znajdziesz w „Archiwum”.

Budynek

  1. W Android Studio zaimportuj aplikację demonstracyjną 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.

    • Zwróć uwagę na kod implementacji w klasie Java.

    • W pliku XML układu zwróć uwagę na projekt układu i tekst.

    • W pliku build.gradle zanotuj pakiet SDK w zależnościach.

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

Odliczanie

  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 tak, aby wykrywał urządzenie.
    • Emulator Użyj Menedżera urządzeń wirtualnych (AVD) Android, aby skonfigurować urządzenie wirtualne. Wybierając emulator, pamiętaj, aby wybrać obraz zawierający interfejsy API Google.

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

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

Użytkownicy wersji demonstracyjnych pakietu SDK Map Google powinni znać ten wzorzec prezentacji i odpowiadającą mu strukturę kodu źródłowego. Wynika to z faktu, że wersja demonstracyjna GoogleMap została zaprojektowana tak, aby przypominała aplikację demonstracyjną interfejsu Maps API. Główna różnica polega na tym, że wersja demonstracyjna SDK nawigacji umożliwia użytkownikowi wybór klasy widoku, który chce przetestować: NavigationView lub MapView (w stosownych przypadkach).

Google zachęca użytkowników, by używali NavigationView. Wersja demonstracyjna pozwala wypróbować różne działania w obu wersjach w naszej aplikacji demonstracyjnej i wybrać tę, która najbardziej Ci odpowiada. Na przykład użycie elementu MapView może być konieczne w sytuacjach, gdy używasz biblioteki zewnętrznej, która oczekuje interakcji z tą klasą.