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:
- Android uygulaması geliştiriyorsunuz. Bunun yerine Android için Navigasyon SDK'sını kullanın.
- Flutter veya React Native yerel uygulaması geliştiriyorsanız bunun yerine Flutter ve React Native için Google Navigasyon'u kullanın.
- Uygulama içi rehberlik olmadan yalnızca bir sunucuda rotalara, TVS'lere veya mesafelere ihtiyacınız varsa Bunun yerine Routes API'yi kullanın.
iOS için Navigation SDK: kurulum
- Etkinleştirilecek hizmet:
navigationsdk.googleapis.com - Kimlik doğrulama: API anahtarı
- Ayrıca şunu da etkinleştirin: iOS için Haritalar SDK'sı
- Kullanım ilişkilendirmesi: Başlatıcıya kullanım ilişkilendirme kimliği eklemek için
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) yöntemini çağırın. Kapsam dışında kalmayı seçmek için çağrıyı silin veya boş bir dize iletin. - Başlayın: iOS için Navigasyon SDK'sını ayarlama
- Referans: iOS için Navigasyon SDK'sı referansı
- Fiyatlandırma: iOS için Navigasyon SDK'sı kullanımı ve faturalandırması
- Politikalar: iOS için Navigasyon SDK'sı politikaları
- Sürüm notları: iOS için Navigasyon SDK'sı sürüm notları
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ı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: iOS için Haritalar SDK'sı, Routes API, Route Optimization API, iOS için Places SDK
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 = trueayarı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 veInfo.plistiçindeNSMotionUsageDescriptionbulunmayan uygulamalar başlatma sırasında kilitlenecek. Anahtarın eklenmesi, mevcut davranışı etkilemez. Düzeltme:Info.plistdosyasınaNSMotionUsageDescription(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
travelModedeğeridrivingveyatwoWheelerdeğilse rota jetonuyla hedef belirleme işlemi.travelModeUnsupportedhatasıyla başarısız olur. Düzeltme:mapView.travelModedeğerini.drivingveya.twoWheelerolarak ayarlayın. Rotanın kullandığı modu görmek içinresolvedParameters.travelModesimgesini 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.
GMSNavigatorsetDestinations: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.GMSNavigatorcontinueToNextDestination: 07.04.2026 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsveshowsStopSigns: 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
.terrainharita türü: 06.08.2026 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik:.normal(kGMSTypeNormal),.satelliteveya.hybridharita türü. GMSNavigatorDelegateveGMSRoadSnappedLocationProviderDelegateprotokolleri: 13.05.2021 tarihinden itibaren kullanımdan kaldırılmıştır. Değiştirme:GMSNavigatorListenerveGMSRoadSnappedLocationProviderListener(-addListener:ile ekleyin;GMSNavigatorüzerindetimeUpdateThresholdvedistanceUpdateThresholddeğ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
- Mobil uygulamalara etkileşimli, adım adım rota ekleyin.
- Adım adım rota için hedefi ayarlayın.
- Adım adım rota için navigasyonu başlatın.
- Rota isteği için seyahat modunu (araba, yaya, iki tekerlekli, taksi) belirtin.
- Adım adım rota için rota tercihlerini değiştirme
- Adım adım rota için yolun tarafını ve diğer varış tercihlerini belirtin.
- Yeniden kullanılabilir rota jetonuyla adım adım rota için yeniden planlanmış bir rota belirtme
- Adım adım rota oturumundan kullanıcı varış güncellemelerini döndürür.
- Adım adım rota oturumundan kullanıcı konumu güncellemelerini döndürme
- Adım adım rota oturumundan süre ve mesafe güncellemelerini döndürür.
- Adım adım rota oturumundan rota değişikliği güncellemelerini döndürür.
- Adım adım rota oturumundan gece modu güncellemelerini döndürür.
- Adım adım rota oturumundan kullanıcı hızı güncellemelerini döndürün.
- Adım adım rota sırasında görünen kullanıcı arayüzü öğelerini ve kontrollerini özelleştirin.
- Adım adım rotaya yeni bir kullanıcı arayüzü öğesi ekleyin.
- Adım adım rotaya gezi ilerleme durumu göstergesi ekleyin.
- Adım adım rota sırasında gösterilen harita özelliklerini özelleştirin.
- Adım adım rotaya trafik katmanı ekleme
- Adım adım rota için kamera görünümünü ve davranışını değiştirin.
- Adım adım rota için hız göstergesi ve hız sınırı uyarılarını özelleştirme
- Rota boyunca her manevra için bir dizi mesaj olarak adım adım rota feed'i döndürür.
- Adım adım rota feed'iyle kullanılacak özel manevra simgeleri belirtme
- iOS uygulamasına CarPlay için etkileşimli, adım adım rota ekleyin. Önizleme
- Kullanıcıları rotalarındaki aksaklıklar hakkında uyarın.
- Kullanıcıların navigasyonu başlatmadan önce rotalarındaki aksaklıkları görmesine izin verin.
- Kullanıcıların rotaları üzerindeki aksaklıkları bildirmesine izin verin.
- Kullanıcıların rotaları üzerindeki aksaklıkları doğrulamasına izin verin.
- Özel rota aksaklığı bildirme düğmesi ekleyin.