Krótkie wprowadzenie do pakietu Navigation SDK na Androida

Pakiet Navigation SDK na Androida dodaje do aplikacji na Androida szczegółowe wskazówki dojazdu z Map Google, umożliwiając dostosowywanie interfejsu i konfigurowanie tras. Zawiera on warstwę mapy Maps SDK, więc aplikacje, które go używają, nie mogą też zawierać pakietu Maps SDK na Androida.

Pakiet SDK do nawigacji na Androida: najważniejsze informacje

  • Usługa: Navigation SDK for Android
  • Inna nazwa: Navigation SDK
  • Kategoria: Trasy
  • Platforma: Android
  • Działa na: kliencie (kod aplikacji lub przeglądarki)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie pakietu Navigation SDK na Androida

Pakiet Navigation SDK na Androida: kiedy go używać

Kiedy używać pakietu Navigation SDK na Androida:

  • Potrzebujesz szczegółowej nawigacji Map Google w swojej aplikacji na Androida, aby użytkownicy nie przechodzili do innej aplikacji.
  • Musisz dostosować interfejs nawigacji do swojej marki lub utworzyć niestandardową nawigację.
  • Potrzebujesz nawigacji w aplikacji, aby poruszać się samochodem, pieszo, rowerem lub pojazdem jednośladowym.
  • Musisz poruszać się po trasie zaplanowanej za pomocą interfejsu Routes API, przekazując do pakietu SDK token trasy.

Kiedy nie używać pakietu Navigation SDK na Androida:

  • tworzysz aplikację na iOS. Zamiast tego użyj pakietu Navigation SDK na iOS.
  • Tworzysz aplikację na wiele platform za pomocą Fluttera lub React Native. Zamiast tego użyj Nawigacji Google we Flutter i React Native.
  • Potrzebujesz obliczania trasy, szacowanego czasu dotarcia na miejsce lub tokena trasy po stronie serwera, a nie szczegółowych wskazówek dojazdu w aplikacji. Zamiast tego użyj interfejsu Routes API.

Navigation SDK na Androida: konfiguracja

Oficjalne pakiety Navigation SDK na Androida:

  • maven: com.google.android.libraries.navigation:navigation

Pakiet SDK do nawigacji na Androida: typowe błędy

  • Problem: pakiet Navigation SDK zawiera już pakiet Maps SDK. Kompilacje, które pobierają play-services-maps bezpośrednio lub przez zależność przechodnią, kończą się zduplikowanymi kopiami pakietu Maps SDK. Rozwiązanie: wyklucz com.google.android.gms:play-services-maps ze wszystkich zależności (wykluczenia konfiguracji Gradle lub wykluczenia Maven) i usuń wszystkie bezpośrednie zależności pakietu SDK Map. Zobacz /maps/documentation/navigation/android-sdk/android-studio-setup.
  • Problem: pakiet Navigation SDK w wersji 8.0 lub nowszej deklaruje minAndroidGradlePluginVersion=9.0.1, więc kompilacje ze starszą wersją AGP kończą się niepowodzeniem. Rozwiązanie: zanim zaczniesz kompilować za pomocą wersji 8.0 lub nowszej, przejdź na AGP 9.0.1, Gradle 9.1.0 i Kotlin 2.3.0. Więcej informacji znajdziesz na stronie /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.
  • Problem: wywoływanie metod cyklu życia NavigationView bezpośrednio podczas korzystania z NavigationFragment lub wywoływanie ich w nieprawidłowej kolejności za pomocą NavigationView prowadzi do błędów. Rozwiązanie: użyj NavigationFragment, który zarządza wywołaniami zwrotnymi cyklu życia. Jeśli używasz NavigationView, przekazuj metody cyklu życia w ścisłej kolejności. Zobacz /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.
  • Problem: nawigacja jest niedostępna, dopóki użytkownik nie zaakceptuje Warunków korzystania z usługi Nawigacja Google. Rozwiązanie: pozwól pakietowi SDK wyświetlić prośbę przy pierwszym wywołaniu nawigatora lub wyświetl okno wcześniej (np. podczas rejestracji) za pomocą TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog. Zobacz /maps/documentation/navigation/android-sdk/route.

Navigation SDK for Android: starsze i wycofane funkcje

  • Waypoint fromLatLng() i fromPlaceId(): wycofane od 10 maja 2021 r. Zamiennik: Waypoint.builder() (Waypoint.Builder). Objaw: usunięto w wersji 3.0; wywołania nie kompilują się w wersji 3.0 ani nowszej. Zobacz przewodnik po migracji.
  • SupportNavigationFragment: wycofane od 1 października 2026 r. Wymiana: NavigationFragment. Objaw: wycofano w pakiecie Navigation SDK w wersji 8.0.0. Zobacz przewodnik po migracji.
  • setLocationMarkerEnabled w NavigationView i SupportNavigationFragment: wycofane 7 lipca 2023 r. Wymiana: GoogleMap.setMyLocationEnabled. Objaw: usunięto w wersji 5.0.0 (wycofano w wersji 4.1); wywołania nie kompilują się w wersji 5.0 ani nowszej.
  • DisplayOptions showTrafficLights i showStopSigns: wycofane od 1 października 2026 r. Zamiennik: nie jest potrzebny. Sygnalizacja świetlna i znaki stopu są zawsze włączone podczas nawigacji. Objaw: wywołania tych metod nie kompilują się w wersji 8.0.0.
  • Artefakt Maven com.google.android.maps:navsdk (repozytorium prywatne, wersja 4.x) i pobieranie pakietu AAR: wycofane 7 lipca 2023 r. Zamiennik: com.google.android.libraries.navigation:navigation z repozytorium Maven google(). Objaw: wersja 5.0 i nowsze są dostarczane tylko jako com.google.android.libraries.navigation:navigation w Google Maven. Pakiet AAR nie jest już rozpowszechniany. Zobacz przewodnik po migracji.

Co możesz zrobić za pomocą pakietu Navigation SDK na Androida

Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.

Navigation SDK na Androida: Mapy

Navigation SDK na Androida: adnotacje na mapach

Navigation SDK na Androida: styl mapy

Navigation SDK na Androida: nawigacja