iOS için Navigasyon SDK'sı hızlı referansı

iOS için Navigasyon SDK'sı, kullanıcı arayüzü özelleştirme ve rota yapılandırması ile iOS uygulamalarına Google Haritalar adım adım rota özelliğini ekler. Harita katmanını sağlayan ve uygulamaya da yüklenmesi gereken iOS için Haritalar SDK'sını genişletir.

iOS için Navigasyon SDK'sı: Önemli bilgiler

  • Ürün: iOS için Navigasyon SDK'sı
  • Diğer adları: Navigasyon SDK'sı
  • Kategori: Rotalar
  • Platform: iOS
  • Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: iOS için Navigation SDK'ya genel bakış
  • Kullanılabildiği bölgeler: Sınırlı. Araba ve yaya yol tarifleri çoğu ülkede kullanılabilir. Trafik, gerçek zamanlı aksaklıklar, iki tekerlekli araç, bisiklet, hız sınırları, trafik ışıkları ve dur işaretleri ülkeye göre değişir. (kapsam ayrıntıları)

iOS için Navigasyon SDK'sı: Ne zaman kullanılır?

iOS için Navigasyon SDK'sını şu durumlarda kullanın:

  • Kullanıcıların uygulama değiştirmemesi için kendi yerel iOS uygulamanızda Google Haritalar adım adım rota özelliğine ihtiyacınız var.
  • Rehberlik sırasında markanıza uyacak şekilde navigasyon kullanıcı arayüzünü, harita stillerini, kamerayı veya düzeni özelleştirmeniz gerekir.
  • Rota tercihleri, birden fazla yol noktası veya Routes API ya da Route Optimization API'den bir rota jetonu gerekir.
  • Özel bir rota yardımı kullanıcı arayüzü veya CarPlay için gezi etkinlikleri (konum, varış, rota değişiklikleri, TVS) ya da adım adım veri feed'i gerekir.

iOS için Navigasyon SDK'sını şu durumlarda kullanmayın:

iOS için Navigation SDK: kurulum

iOS için resmi Navigasyon SDK'sı paketleri:

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

iOS için Navigasyon SDK'sı ile kullanılmaması gereken paketler:

  • cocoapods: GoogleNavigation. CocoaPods dağıtımı, 11.0.0 sürümünden itibaren kullanımdan kaldırıldı ve 18.08.2025 tarihinde bakım moduna alındı. Bunun yerine Swift Package Manager'ı kullanın.

iOS için Navigasyon SDK'sı: Sık yapılan hatalar

  • Sorun: SDK, iOS boşta kalma zamanlayıcısını devre dışı bırakmadığı için navigasyon sırasında ekran kararıyor veya kapanıyor. Düzeltme: Navigasyon sırasında UIApplication.shared.isIdleTimerDisabled = true ayarını yapın. /maps/documentation/navigation/ios-sdk/route sayfasına bakın.
  • Sorun: SDK'nın gelecekteki önemli bir sürümünde yükseklik ölçer (CMAltimeter) kullanılacak ve Info.plist içinde NSMotionUsageDescription bulunmayan uygulamalar başlatma sırasında kilitlenecek. Anahtarın eklenmesi, mevcut davranışı etkilemez. Düzeltme: Info.plist dosyasına NSMotionUsageDescription (Gizlilik - Hareket Kullanımı Açıklaması) ekleyin. /maps/documentation/navigation/ios-sdk/route sayfasına bakın.
  • Sorun: iOS için Yerler SDK'sı, Navigation SDK'sı ile birlikte sunulmadığından (Yerler SDK 5.0 itibarıyla) Yerler sınıfları eksik. Düzeltme: iOS için Yerler SDK'sını, Navigation SDK ile aynı sürümü kullanarak ayrı olarak yükleyin. /maps/documentation/navigation/ios-sdk/xcode-setup sayfasına bakın.
  • Sorun: Uygulamanın travelMode değeri driving veya twoWheeler değilse rota jetonuyla hedef belirleme işlemi .travelModeUnsupported hatasıyla başarısız olur. Düzeltme: mapView.travelMode değerini .driving veya .twoWheeler olarak ayarlayın. Rotanın kullandığı modu görmek için resolvedParameters.travelMode simgesini kontrol edin. /maps/documentation/navigation/ios-sdk/route-customizations sayfasına bakın.

iOS için Navigasyon SDK'sı: eski ve desteği sonlandırılmış özellikler

  • CocoaPods dağıtımı: 06.08.2026'dan itibaren desteği sonlandırıldı. Alternatif: Swift Package Manager. Belirti: 18.08.2025'ten beri bakım modunda. 2026'nın 2. çeyreğinden sonra yeni CocoaPods sürümleri yayınlanmayacak. Geçiş rehberini inceleyin.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): 02.11.2026 tarihinden itibaren desteği sonlandırıldı. Değişim: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • GMSServices örnek mülkü appCheckTokenProvider: 24.09.2026 tarihinden itibaren desteği sonlandırıldı. Değişiklik: GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]) sınıf özelliği. Belirti: 11.1.0 sürümünde, Uygulama Kontrolü'nü GMSServices.sharedServices() üzerinden yapılandırma işlemi başarısız oldu. Geçiş rehberini inceleyin.
  • GMSNavigator continueToNextDestination: 07.04.2026 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights ve showsStopSigns: 06.08.2026 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik: Değişiklik yapılması gerekmez. Trafik ışıkları ve dur işaretleri, navigasyon sırasında varsayılan olarak gösterilir.
  • Etkin navigasyon sırasında .terrain harita türü: 06.08.2026 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik: .normal (kGMSTypeNormal), .satellite veya .hybrid harita türü.
  • GMSNavigatorDelegate ve GMSRoadSnappedLocationProviderDelegate protokolleri: 13.05.2021 tarihinden itibaren kullanımdan kaldırılmıştır. Değiştirme: GMSNavigatorListener ve GMSRoadSnappedLocationProviderListener (-addListener: ile ekleyin; GMSNavigator üzerinde timeUpdateThreshold ve distanceUpdateThreshold değerlerini ayarlayın). Geçiş rehberini inceleyin.

iOS için Navigasyon SDK'sı ile yapabilecekleriniz

Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.

iOS için Navigasyon SDK'sı: Harita stilleri

iOS için Navigasyon SDK'sı: Navigasyon