Pakiet Navigation SDK na iOS dodaje do aplikacji na iOS szczegółowe wskazówki dojazdu z Map Google, umożliwiając dostosowywanie interfejsu i konfigurowanie tras. Rozszerza on pakiet Maps SDK na iOS, który dostarcza warstwę mapy i musi być również zainstalowany w aplikacji.
Navigation SDK na iOS: najważniejsze informacje
- Usługa: Navigation SDK na iOS
- Inna nazwa: Navigation SDK
- Kategoria: Trasy
- Platforma: iOS
- Działa na: kliencie (kod aplikacji lub przeglądarki)
- Etap uruchomienia: GA
- Cykl życia: aktywny
- Omówienie: omówienie pakietu Navigation SDK na iOS
- Dostępność: ograniczona. Trasy samochodowe i trasy piesze są dostępne w większości krajów. Informacje o natężeniu ruchu, utrudnieniach w czasie rzeczywistym, pojazdach dwukołowych, jeździe na rowerze, ograniczeniach prędkości, sygnalizacji świetlnej i znakach stopu różnią się w zależności od kraju. (szczegóły dotyczące zakresu ochrony)
Navigation SDK na iOS: kiedy go używać
Kiedy używać pakietu Navigation SDK na iOS:
- Potrzebujesz szczegółowych wskazówek dojazdu z Map Google w swojej natywnej aplikacji na iOS, aby użytkownicy nie musieli przełączać się między aplikacjami.
- Podczas nawigacji musisz dostosować interfejs nawigacji, style mapy, kamerę lub układ do swojej marki.
- Potrzebujesz ustawień trasy, wielu punktów pośrednich lub tokena trasy z interfejsu Routes API lub Route Optimization API.
- Potrzebujesz zdarzeń związanych z przejazdem (lokalizacja, przyjazd, zmiany trasy, szacowany czas dotarcia na miejsce) lub pliku danych ze szczegółowymi wskazówkami dojazdu na potrzeby niestandardowego interfejsu wskazówek lub CarPlay.
Nie używaj pakietu Navigation SDK na iOS, gdy:
- Tworzysz aplikację na Androida. Zamiast tego użyj pakietu Navigation SDK na Androida.
- Tworzysz aplikację we Flutterze lub React Native. Zamiast tego użyj Nawigacji Google we Flutterze i React Native.
- Potrzebujesz tylko tras, szacowanego czasu dotarcia na miejsce lub odległości na serwerze, bez wskazówek w aplikacji. Zamiast tego użyj interfejsu Routes API.
Pakiet SDK do nawigacji na iOS: konfiguracja
- Usługa do włączenia:
navigationsdk.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Włącz też: Maps SDK na iOS
- Atrybucja wykorzystania: wywołaj
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]), aby dodać identyfikator atrybucji wykorzystania do inicjatora. Aby zrezygnować, usuń wywołanie lub przekaż pusty ciąg znaków. - Pierwsze kroki: konfigurowanie pakietu Navigation SDK na iOS
- Dokumentacja: dokumentacja pakietu Navigation SDK na iOS
- Ceny: korzystanie z pakietu Navigation SDK na iOS i płatności
- Zasady: Zasady dotyczące pakietu Navigation SDK na iOS
- Informacje o wersji: informacje o wersji pakietu Navigation SDK na iOS
Oficjalne pakiety Navigation SDK na iOS:
- swift_package:
https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)
Pakiety, których nie należy używać z Navigation SDK na iOS:
- cocoapods:
GoogleNavigation. Dystrybucja CocoaPods została wycofana w wersji 11.0.0 i 18 sierpnia 2025 r. przeszła w tryb konserwacji. Zamiast tego użyj Swift Package Managera.
Navigation SDK na iOS: produkty powiązane
- Często używane z: Maps SDK na iOS, Routes API, Route Optimization API, Places SDK for iOS
Pakiet SDK do nawigacji na iOS: typowe błędy
- Problem: ekran przyciemnia się lub wyłącza podczas nawigacji, ponieważ pakiet SDK nie wyłącza licznika czasu bezczynności iOS. Rozwiązanie: ustaw
UIApplication.shared.isIdleTimerDisabled = truepodczas nawigacji. See /maps/documentation/navigation/ios-sdk/route. - Problem: przyszła wersja główna pakietu SDK będzie używać wysokościomierza (
CMAltimeter), a aplikacje bezNSMotionUsageDescriptionwInfo.plistbędą ulegać awarii podczas inicjowania. Dodanie klucza teraz nie wpłynie na bieżące działanie. Rozwiązanie: dodajNSMotionUsageDescription(Prywatność – opis wykorzystania danych o ruchu) doInfo.plist. See /maps/documentation/navigation/ios-sdk/route. - Problem: pakiet SDK Miejsc na iOS nie jest dołączony do pakietu SDK do nawigacji (od wersji 5.0 pakietu SDK Miejsc), więc brakuje klas Miejsc. Rozwiązanie: zainstaluj pakiet SDK Miejsc na iOS osobno, używając tej samej wersji co pakiet SDK do nawigacji. Zobacz /maps/documentation/navigation/ios-sdk/xcode-setup.
- Problem: ustawianie miejsc docelowych za pomocą tokena trasy kończy się błędem
.travelModeUnsupported, gdytravelModeaplikacji nie jestdrivinganitwoWheeler. Rozwiązanie: ustawmapView.travelModena.drivinglub.twoWheeler. SprawdźresolvedParameters.travelMode, aby zobaczyć, jaki tryb jest używany na trasie. Więcej informacji znajdziesz na stronie /maps/documentation/navigation/ios-sdk/route-customizations.
Pakiet SDK do nawigacji na iOS: starsze i wycofane funkcje
- Dystrybucja CocoaPods: wycofana 6 sierpnia 2026 r. Zamiennik: Swift Package Manager. Objaw: tryb konserwacji od 18 sierpnia 2025 r. Po II kwartale 2026 r. nie będą wydawane nowe wersje CocoaPods. Zobacz przewodnik po migracji.
GMSNavigatorsetDestinations:callback:,setDestinations:routingOptions:callback:,setDestinations:routeToken:callback:(GMSRouteStatusCallback): wycofane od 2 listopada 2026 r. Wymiana:setDestinations:completionHandler:,setDestinations:routingOptions:completionHandler:,setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler).- Właściwość instancji
GMSServicesappCheckTokenProvider: wycofana od 24 września 2026 r. Zamiennik: właściwość klasyGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). Objaw: w wersji 11.1.0 konfiguracja Sprawdzania aplikacji za pomocąGMSServices.sharedServices()nie powiodła się. Zobacz przewodnik po migracji. GMSNavigatorcontinueToNextDestination: wycofany od 7 kwietnia 2026 r. Wymiana:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsishowsStopSigns: wycofane od 6 sierpnia 2026 r. Zamiennik: nie jest potrzebny. Sygnalizacja świetlna i znaki stopu są domyślnie wyświetlane podczas nawigacji.- Typ mapy
.terrainpodczas aktywnej nawigacji: wycofany 6 sierpnia 2026 r. Zamiennik: typ mapy.normal(kGMSTypeNormal),.satellitelub.hybrid. - Protokoły
GMSNavigatorDelegateiGMSRoadSnappedLocationProviderDelegate: wycofane 13 maja 2021 r. Zamiennik:GMSNavigatorListeneriGMSRoadSnappedLocationProviderListener(dodaj za pomocą-addListener:; ustawtimeUpdateThresholdidistanceUpdateThresholdwGMSNavigator). Zobacz przewodnik po migracji.
Możliwości pakietu Navigation SDK na iOS
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 iOS: styl mapy
Navigation SDK na iOS: 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 iOS interaktywną, szczegółową nawigację dla CarPlay. 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.