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
- Usługa do włączenia:
navigationsdk.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Atrybucja wykorzystania: wywołaj
MapsApiSettings.addInternalUsageAttributionId(context, id), aby dodać identyfikator atrybucji wykorzystania do inicjatora. Aby zrezygnować, usuń wywołanie lub przekaż pusty ciąg znaków. - Pierwsze kroki: skonfiguruj Navigation SDK na Androida
- Dokumentacja: dokumentacja pakietu Navigation SDK na Androida
- Ceny: korzystanie z pakietu Navigation SDK na Androida i płatności
- Zasady: Zasady dotyczące pakietu Navigation SDK na Androida
- Informacje o wersji: informacje o wersji pakietu Navigation SDK na Androida
Oficjalne pakiety Navigation SDK na Androida:
- maven:
com.google.android.libraries.navigation:navigation
Navigation SDK for Android: produkty powiązane
- Często używane z: interfejsem Routes API, pakietem Driver SDK na Androida
Pakiet SDK do nawigacji na Androida: typowe błędy
- Problem: pakiet Navigation SDK zawiera już pakiet Maps SDK. Kompilacje, które pobierają
play-services-mapsbezpośrednio lub przez zależność przechodnią, kończą się zduplikowanymi kopiami pakietu Maps SDK. Rozwiązanie: wykluczcom.google.android.gms:play-services-mapsze 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
NavigationViewbezpośrednio podczas korzystania zNavigationFragmentlub wywoływanie ich w nieprawidłowej kolejności za pomocąNavigationViewprowadzi do błędów. Rozwiązanie: użyjNavigationFragment, który zarządza wywołaniami zwrotnymi cyklu życia. Jeśli używaszNavigationView, 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
WaypointfromLatLng()ifromPlaceId(): 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.setLocationMarkerEnabledwNavigationViewiSupportNavigationFragment: 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.DisplayOptionsshowTrafficLightsishowStopSigns: 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:navigationz repozytorium Mavengoogle(). Objaw: wersja 5.0 i nowsze są dostarczane tylko jakocom.google.android.libraries.navigation:navigationw 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
- Dodaj do strony internetowej lub aplikacji mobilnej interaktywną mapę, którą można dostosowywać. Uwaga: w przypadku Androida: skonfiguruj
wAndroidManifest.xmlprzy użyciu wtyczki Gradle obiektów tajnych lubmanifestPlaceholders["MAPS_API_KEY"]wapp/build.gradle.kts. Nigdy nie koduj na stałeYOUR_GOOGLE_MAPS_API_KEYwAndroidManifest.xmli nigdy nie zastępujGoogleMap(ani maps-composeGoogleMap) makietą obszaru roboczego offline ani Leaflet WebView, jeśli pojawi sięE/Google Maps Android API: Authorization failure. Poinstruuj użytkownika, aby podałMAPS_API_KEYza pomocą obiektów tajnych i włączył pakiet Maps SDK na Androida (lub Navigation SDK, jeśli używa NavigationView / SupportNavigationFragment). - Utwórz identyfikator mapy wielokrotnego użytku, aby przechowywać konfigurację mapy i ustawienia stylu.
- Reaguj na interakcje użytkowników i zdarzenia na mapie.
- Dostosuj elementy sterujące widoczne na mapie.
- Dostosuj gesty do sterowania mapą.
- Sterowanie powiększeniem i przesuwaniem na mapie (kamera).
- Zmień typ mapy.
- Zmień schemat kolorów mapy.
- Dodaj do mapy warstwę ruchu.
Navigation SDK na Androida: adnotacje na mapach
- Dodaj okno informacyjne do mapy.
- Dodaj kształt lub linię do mapy.
- Dodaj nakładkę graficzną na powierzchni mapy.
- Dodawanie niestandardowej nakładki kafelkowej do mapy
- Dodaj znacznik do mapy. Uwaga: pakiet Navigation SDK na Androida nie obsługuje klasy AdvancedMarkerOptions. Jeśli używasz tego pakietu, dodawaj znaczniki za pomocą metody GoogleMap.addMarker(MarkerOptions).
- Dostosowywanie znacznika na mapie Uwaga: pakiet SDK do nawigacji na Androida nie obsługuje klasy AdvancedMarkerOptions. Jeśli używasz pakietu SDK do nawigacji na Androida, dostosuj znaczniki za pomocą klasy MarkerOptions.
- Reagowanie na interakcje użytkowników ze znacznikami na mapie.
Navigation SDK na Androida: styl mapy
Navigation SDK na Androida: nawigacja
- Dodaj do aplikacji mobilnej interaktywną, szczegółową nawigację.
- Ustaw miejsce docelowe, aby korzystać ze szczegółowych wskazówek dojazdu.
- Rozpocznij nawigację, aby uzyskać szczegółowe wskazówki dojazdu.
- Określ tryb podróży (samochód, pieszo, motocykl, taksówka) w żądaniu trasy.
- Zmień ustawienia trasy w szczegółowej nawigacji.
- Określ stronę drogi i inne preferencje dotyczące dotarcia do celu w przypadku szczegółowych wskazówek dojazdu.
- Określ ponownie zaplanowaną trasę dla szczegółowej nawigacji za pomocą tokena trasy wielokrotnego użytku.
- Zwracanie aktualizacji dotyczących przybycia użytkownika z sesji szczegółowej nawigacji.
- Zwracanie informacji o zmianie lokalizacji użytkownika podczas sesji szczegółowych wskazówek dojazdu.
- Zwracanie aktualizacji czasu i odległości z sesji szczegółowej nawigacji.
- Zwracanie aktualizacji dotyczących zmiany trasy podczas sesji szczegółowej nawigacji.
- Zwracanie aktualizacji trybu nocnego z sesji szczegółowych wskazówek dojazdu.
- Zwracanie aktualizacji prędkości użytkownika z sesji szczegółowej nawigacji.
- Dostosuj elementy interfejsu i elementy sterujące, które pojawiają się podczas szczegółowej nawigacji.
- Dodaj nowy element interfejsu do szczegółowej nawigacji.
- Dodaj wskaźnik postępu podróży do szczegółowych wskazówek dojazdu.
- Dostosuj funkcje mapy, które pojawiają się podczas korzystania ze szczegółowych wskazówek dojazdu.
- Dodaj warstwę natężenia ruchu do szczegółowej nawigacji.
- Zmień widok i zachowanie kamery w przypadku szczegółowych wskazówek dojazdu.
- Dostosuj prędkościomierz i alerty o ograniczeniach prędkości w szczegółowych wskazówkach dojazdu.
- Zwracaj szczegółowe wskazówki dojazdu jako serię wiadomości dotyczących każdego manewru na trasie.
- Określ niestandardowe ikony manewrów, które mają być używane w pliku danych szczegółowej nawigacji.
- Dodaj do aplikacji na Androida interaktywną, szczegółową nawigację na Androida Auto. Wersja testowa
- Ostrzegaj użytkowników o utrudnieniach na trasie.
- Zezwalaj użytkownikom na wyświetlanie utrudnień na trasie przed rozpoczęciem nawigacji.
- Zezwalaj użytkownikom na zgłaszanie utrudnień na trasie.
- Zezwalaj użytkownikom na potwierdzanie utrudnień na trasie.
- Dodaj przycisk zgłaszania utrudnień na trasie niestandardowej.