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

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:

Android için Navigasyon SDK'sı: Kurulum

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

  • maven: com.google.android.libraries.navigation:navigation

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: NavigationFragment kullanırken NavigationView yaşam döngüsü yöntemlerini doğrudan çağırmak veya NavigationView ile sırasız çağırmak hatalara yol açar. Düzeltme: Yaşam döngüsü geri çağırma yöntemlerini yöneten NavigationFragment öğesini kullanın. NavigationView kullanı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.showTermsAndConditionsDialog ile 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

  • Waypoint fromLatLng() ve fromPlaceId(): 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, NavigationView ve SupportNavigationFragment: 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.
  • DisplayOptions showTrafficLights ve showStopSigns: 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 deposundan com.google.android.libraries.navigation:navigation. Belirti: 5.0 ve sonraki sürümler, Google Maven'da yalnızca com.google.android.libraries.navigation:navigation olarak 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

Android için Navigasyon SDK'sı: Haritalar ek açıklamaları

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

Android için Navigasyon SDK'sı: Navigasyon