Referensi cepat Navigation SDK for iOS

Navigation SDK for iOS menambahkan navigasi belokan demi belokan Google Maps ke aplikasi iOS, dengan penyesuaian UI dan konfigurasi rute. Library ini memperluas Maps SDK for iOS, yang menyediakan lapisan peta dan juga harus diinstal di aplikasi.

Navigation SDK for iOS: fakta penting

  • Produk: Navigation SDK for iOS
  • Juga dikenal sebagai: Navigation SDK
  • Kategori: Rute
  • Platform: iOS
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Navigation SDK for iOS
  • Ketersediaan regional: Terbatas. Rute mobil dan jalan kaki tersedia di sebagian besar negara; lalu lintas, gangguan real-time, kendaraan roda dua, bersepeda, batas kecepatan, serta lampu lalu lintas dan tanda berhenti bervariasi menurut negara. (detail cakupan)

Navigation SDK for iOS: kapan harus menggunakannya

Gunakan Navigation SDK for iOS jika:

  • Anda memerlukan navigasi belokan demi belokan Google Maps di dalam aplikasi iOS native Anda sendiri agar pengguna tidak beralih aplikasi.
  • Anda perlu menyesuaikan UI navigasi, gaya peta, kamera, atau tata letak agar sesuai dengan merek Anda selama panduan.
  • Anda memerlukan preferensi pemilihan rute, beberapa titik jalan, atau token rute dari Routes API atau Route Optimization API.
  • Anda memerlukan peristiwa perjalanan (lokasi, kedatangan, perubahan rute, perkiraan waktu tiba) atau feed data belokan demi belokan untuk UI panduan kustom atau CarPlay.

Jangan gunakan Navigation SDK for iOS jika:

Navigation SDK for iOS: penyiapan

Paket Navigation SDK for iOS resmi:

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

Paket yang tidak boleh digunakan dengan Navigation SDK for iOS:

  • cocoapods: GoogleNavigation. Distribusi CocoaPods tidak digunakan lagi mulai versi 11.0.0 dan memasuki mode pemeliharaan pada 18-08-2025. Gunakan Swift Package Manager.

Navigation SDK for iOS: kesalahan umum

  • Masalah: Layar meredup atau mati selama navigasi karena SDK tidak menonaktifkan timer tidak ada aktivitas iOS. Perbaikan: Tetapkan UIApplication.shared.isIdleTimerDisabled = true saat menavigasi. Lihat /maps/documentation/navigation/ios-sdk/route.
  • Masalah: Rilis utama SDK mendatang akan menggunakan altimeter (CMAltimeter), dan aplikasi tanpa NSMotionUsageDescription di Info.plist akan mengalami error saat inisialisasi. Menambahkan kunci sekarang tidak akan memengaruhi perilaku saat ini. Perbaikan: Tambahkan NSMotionUsageDescription (Privacy - Motion Usage Description) ke Info.plist. Lihat /maps/documentation/navigation/ios-sdk/route.
  • Masalah: Places SDK for iOS tidak dipaketkan dengan Navigation SDK (mulai Places SDK 5.0), sehingga class Places tidak ada. Perbaikan: Instal Places SDK for iOS secara terpisah, menggunakan versi yang sama dengan Navigation SDK. Lihat /maps/documentation/navigation/ios-sdk/xcode-setup.
  • Masalah: Menetapkan tujuan dengan token rute gagal dengan .travelModeUnsupported jika travelMode aplikasi bukan driving atau twoWheeler. Perbaikan: Tetapkan mapView.travelMode ke .driving atau .twoWheeler. Periksa resolvedParameters.travelMode untuk melihat mode yang digunakan rute. Lihat /maps/documentation/navigation/ios-sdk/route-customizations.

Navigation SDK for iOS: fitur lama dan tidak digunakan lagi

  • Distribusi CocoaPods: Tidak digunakan lagi sejak 06-08-2026. Pengganti: Swift Package Manager. Gejala: Mode pemeliharaan sejak 18-08-2025. Tidak ada versi CocoaPods baru setelah Kuartal 2 2026. Lihat panduan migrasi.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback: (GMSRouteStatusCallback): Tidak digunakan lagi sejak 02-11-2026. Pengganti: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler: (GMSNavigationRouteCompletionHandler).
  • Properti instance GMSServices appCheckTokenProvider: Tidak digunakan lagi sejak 24-09-2026. Pengganti: Properti class GMSServices.appCheckTokenProvider (+[GMSServices setAppCheckTokenProvider:]). Gejala: Di versi 11.1.0, konfigurasi App Check melalui GMSServices.sharedServices() gagal. Lihat panduan migrasi.
  • GMSNavigator continueToNextDestination: Tidak digunakan lagi sejak 07-04-2026. Penggantian: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights dan showsStopSigns: Dinonaktifkan sejak 06-08-2026. Pengganti: Tidak perlu pengganti; lampu lalu lintas dan rambu berhenti ditampilkan secara default selama navigasi.
  • Jenis peta .terrain selama navigasi aktif: Dinonaktifkan sejak 06-08-2026. Pengganti: Jenis peta .normal (kGMSTypeNormal), .satellite, atau .hybrid.
  • Protokol GMSNavigatorDelegate dan GMSRoadSnappedLocationProviderDelegate: Dinonaktifkan sejak 13-05-2021. Pengganti: GMSNavigatorListener dan GMSRoadSnappedLocationProviderListener (tambahkan dengan -addListener:; tetapkan timeUpdateThreshold dan distanceUpdateThreshold di GMSNavigator). Lihat panduan migrasi.

Yang dapat Anda lakukan dengan Navigation SDK for iOS

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.

Navigation SDK for iOS: Gaya peta

Navigation SDK for iOS: Navigasi