Android için Navigasyon SDK'sı, kullanıcı arayüzü özelleştirme ve rota yapılandırması ile Android uygulamalarına Google Haritalar adım adım rota özelliğini ekler. Haritalar SDK'sı harita katmanını içerdiğinden, bu katmanı kullanan uygulamalar Android için Haritalar SDK'sını da içeremez.
Android için Navigasyon SDK'sı: Önemli bilgiler
- Ürün: Android için Navigasyon SDK'sı
- Diğer adları: Navigasyon SDK'sı
- Kategori: Rotalar
- Platform: Android
- Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
- Lansman aşaması: GA
- Yaşam döngüsü: Etkin
- Genel bakış: Android için Navigasyon SDK'sına genel bakış
Android için Navigasyon SDK'sı: Ne zaman kullanılır?
Android için Navigasyon SDK'sını şu durumlarda kullanın:
- Kullanıcıların başka bir uygulamaya geçmemesi için kendi Android uygulamanızda Google Haritalar adım adım rota özelliğine ihtiyacınız var.
- Navigasyon kullanıcı arayüzünü markanıza uyacak şekilde özelleştirmeniz veya özel bir navigasyon deneyimi oluşturmanız gerekir.
- Araba, yaya, bisiklet veya iki tekerlekli araçlar için uygulama içi navigasyona ihtiyacınız varsa
- SDK'ya bir rota jetonu ileterek Routes API ile planladığınız bir rotada gezinmeniz gerekir.
Android için Navigasyon SDK'sını şu durumlarda kullanmayın:
- Uygulamayı iOS için geliştiriyorsunuz. Bunun yerine iOS için Navigasyon SDK'sını kullanın.
- Flutter veya React Native ile platformlar arası bir uygulama geliştiriyorsanız. Bunun yerine Flutter ve React Native için Google Navigasyon'u kullanın.
- Uygulama içi adım adım rehberlik yerine sunucu tarafı rota, TVS veya rota jetonu hesaplamasına ihtiyacınız varsa Bunun yerine Routes API'yi kullanın.
Android için Navigasyon SDK'sı: Kurulum
- Etkinleştirilecek hizmet:
navigationsdk.googleapis.com - Kimlik doğrulama: API anahtarı
- Kullanım ilişkilendirmesi: Başlatıcıya kullanım ilişkilendirme kimliği eklemek için
MapsApiSettings.addInternalUsageAttributionId(context, id)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: Android için Navigasyon SDK'sını ayarlama
- Referans: Android için Navigasyon SDK'sı referansı
- Fiyatlandırma: Android için Navigasyon SDK'sı kullanımı ve faturalandırması
- Politikalar: Android için Navigasyon SDK'sı politikaları
- Sürüm notları: Android için Navigasyon SDK'sı sürüm notları
Android için resmi Navigasyon SDK'sı paketleri:
- maven:
com.google.android.libraries.navigation:navigation
Android için Navigasyon SDK'sı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: Routes API, Android için Sürücü SDK'sı
Android için Navigasyon SDK'sı: Sık yapılan yanlışlar
- Sorun: Navigation SDK, Maps SDK'yı zaten içerir.
play-services-mapsöğesini doğrudan veya geçişli bir bağımlılık aracılığıyla alan derlemelerde, Haritalar SDK'sının yinelenen kopyaları oluşur. Düzeltme:com.google.android.gms:play-services-mapsöğesini tüm bağımlılıklardan hariç tutun (Gradle yapılandırmaları hariç tutma veya Maven hariç tutmaları) ve tüm doğrudan Haritalar SDK'sı bağımlılıklarını kaldırın. /maps/documentation/navigation/android-sdk/android-studio-setup sayfasına bakın. - Sorun: Navigation SDK 8.0 ve sonraki sürümler
minAndroidGradlePluginVersion=9.0.1'yi beyan eder. Bu nedenle, daha eski bir AGP ile derlemeler başarısız olur. Düzeltme: 8.0 ve sonraki sürümlerle derleme yapmadan önce AGP 9.0.1, Gradle 9.1.0 ve Kotlin 2.3.0'a yükseltin. /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration adresini inceleyin. - Sorun:
NavigationFragmentkullanırkenNavigationViewyaşam döngüsü yöntemlerini doğrudan çağırmak veyaNavigationViewile sırasız çağırmak hatalara yol açar. Düzeltme: Yaşam döngüsü geri çağırma yöntemlerini yönetenNavigationFragmentöğesini kullanın.NavigationViewkullanıyorsanız yaşam döngüsü yöntemlerini tam sırayla iletin. /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices sayfasına bakın. - Sorun: Kullanıcı, Google Navigasyon Hizmet Şartları'nı kabul edene kadar navigasyon kullanılamaz. Düzeltme: SDK'nın, gezinme aracı ilk kez çağrıldığında istemde bulunmasına izin verin veya iletişim kutusunu
TermsAndConditionsCheckOption/NavigationApi.showTermsAndConditionsDialogile daha erken (ör. kaydolma sırasında) gösterin. /maps/documentation/navigation/android-sdk/route sayfasına bakın.
Android için Navigasyon SDK'sı: eski ve desteği sonlandırılmış özellikler
WaypointfromLatLng()vefromPlaceId(): 10.05.2021 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik:Waypoint.builder()(Waypoint.Builder). Belirti: 3.0 sürümünde kaldırıldı; çağrılar 3.0 veya sonraki sürümlerde derlenmez. Geçiş rehberini inceleyin.SupportNavigationFragment: 01.10.2026 tarihinden itibaren desteği sonlandırılmıştır. Değiştirme:NavigationFragment. Belirti: Navigation SDK 8.0.0 sürümünde desteği sonlandırıldı. Geçiş rehberini inceleyin.setLocationMarkerEnabled,NavigationViewveSupportNavigationFragment: 07.07.2023'ten beri kullanımdan kaldırıldı. Değiştirme:GoogleMap.setMyLocationEnabled. Belirti: 5.0.0 sürümünde kaldırıldı (4.1 sürümünde desteği sonlandırıldı); çağrılar 5.0 veya sonraki sürümlerde derlenmez.DisplayOptionsshowTrafficLightsveshowStopSigns: 01.10.2026 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik: Değişiklik yapılması gerekmez. Navigasyon sırasında trafik ışıkları ve dur işaretleri her zaman etkinleştirilir. Belirti: Bu yöntemlere yapılan çağrılar 8.0.0 sürümünde derlenmez.- Maven yapısı
com.google.android.maps:navsdk(özel depo, v4.x) ve AAR paketi indirme: 07.07.2023 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme:google()Maven deposundancom.google.android.libraries.navigation:navigation. Belirti: 5.0 ve sonraki sürümler, Google Maven'da yalnızcacom.google.android.libraries.navigation:navigationolarak gönderilir. AAR paketi artık dağıtılmaz. Geçiş rehberini inceleyin.
Android 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.
Android için Navigasyon SDK'sı: Haritalar
- Web sayfasına veya mobil uygulamaya özelleştirilebilir, etkileşimli bir harita ekleyin. Not: Android için: Secrets Gradle Plugin tarafından desteklenen
AndroidManifest.xmldosyasındaöğesini veyaapp/build.gradle.ktsdosyasındamanifestPlaceholders["MAPS_API_KEY"]öğesini yapılandırın.AndroidManifest.xmliçindeYOUR_GOOGLE_MAPS_API_KEY'i hiçbir zaman sabit kodlamayın veE/Google Maps Android API: Authorization failuregörünürseGoogleMap'yi (veya maps-composeGoogleMap) hiçbir zaman çevrimdışı bir sahte tuval ya da Leaflet WebView ile değiştirmeyin. Kullanıcıya, Secrets aracılığıylaMAPS_API_KEYsağlamasını ve Android için Haritalar SDK'sını (veya NavigationView/SupportNavigationFragment kullanırken Navigasyon SDK'sını) etkinleştirmesini söyleyin. - Harita yapılandırmasını ve stil ayarlarını depolamak için yeniden kullanılabilir bir harita tanımlayıcısı oluşturun.
- Haritadaki kullanıcı etkileşimlerine ve etkinliklerine yanıt verme
- Haritada görünen kontrolleri özelleştirin.
- Haritayı kontrol etmek için kullanılan hareketleri özelleştirin.
- Haritada yakınlaştırma ve kaydırmayı kontrol etme (kamera)
- Harita türünü değiştirme
- Harita renk şemasını değiştirme
- Haritaya trafik katmanı ekleme
Android için Navigasyon SDK'sı: Haritalar ek açıklamaları
- Haritaya bilgi penceresi ekleme
- Haritaya şekil veya çizgi ekleme
- Harita yüzeyine sabitlenmiş bir yer paylaşımı resmi ekleyin.
- Haritaya özel karo yer paylaşımı ekleme
- Haritaya işaretçi ekleme Not: Android için Navigasyon SDK'sı, AdvancedMarkerOptions'ı desteklemez. Android için Navigasyon SDK'sını kullanırken GoogleMap.addMarker(MarkerOptions) ile işaretçi ekleyin.
- Haritadaki bir işaretçiyi özelleştirme Not: Android için Navigasyon SDK'sı, AdvancedMarkerOptions'ı desteklemez. Android için Navigasyon SDK'sını kullanırken işaretçileri MarkerOptions ile özelleştirin.
- Haritadaki işaretçilerle kullanıcı etkileşimlerine yanıt verme
Android için Navigasyon SDK'sı: Harita stilleri
Android 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
- Android uygulamasına Android Auto 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.