Krótkie wprowadzenie do pakietu Navigation SDK na iOS

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:

Pakiet SDK do nawigacji na iOS: konfiguracja

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.

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 = true podczas 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 bez NSMotionUsageDescription w Info.plist będą ulegać awarii podczas inicjowania. Dodanie klucza teraz nie wpłynie na bieżące działanie. Rozwiązanie: dodaj NSMotionUsageDescription (Prywatność – opis wykorzystania danych o ruchu) do Info.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, gdy travelMode aplikacji nie jest driving ani twoWheeler. Rozwiązanie: ustaw mapView.travelMode na .driving lub .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.
  • GMSNavigator setDestinations: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 GMSServices appCheckTokenProvider: wycofana od 24 września 2026 r. Zamiennik: właściwość klasy GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Objaw: w wersji 11.1.0 konfiguracja Sprawdzania aplikacji za pomocą GMSServices.sharedServices() nie powiodła się. Zobacz przewodnik po migracji.
  • GMSNavigator continueToNextDestination: wycofany od 7 kwietnia 2026 r. Wymiana: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights i showsStopSigns: wycofane od 6 sierpnia 2026 r. Zamiennik: nie jest potrzebny. Sygnalizacja świetlna i znaki stopu są domyślnie wyświetlane podczas nawigacji.
  • Typ mapy .terrain podczas aktywnej nawigacji: wycofany 6 sierpnia 2026 r. Zamiennik: typ mapy .normal (kGMSTypeNormal), .satellite lub .hybrid.
  • Protokoły GMSNavigatorDelegate i GMSRoadSnappedLocationProviderDelegate: wycofane 13 maja 2021 r. Zamiennik: GMSNavigatorListener i GMSRoadSnappedLocationProviderListener (dodaj za pomocą -addListener:; ustaw timeUpdateThreshold i distanceUpdateThreshold w GMSNavigator). 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