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:
- Anda sedang membangun aplikasi Android. Gunakan Navigation SDK for Android.
- Anda sedang membangun aplikasi Flutter atau React Native. Gunakan Google Navigation untuk Flutter dan React Native.
- Anda hanya memerlukan rute, perkiraan waktu tiba (ETA), atau jarak di server, tanpa panduan dalam aplikasi. Gunakan Routes API.
Navigation SDK for iOS: penyiapan
- Layanan yang akan diaktifkan:
navigationsdk.googleapis.com - Autentikasi: Kunci API
- Aktifkan juga: Maps SDK for iOS
- Atribusi penggunaan: Panggil
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:]) untuk menambahkan ID atribusi penggunaan ke penginisialisasi. Untuk memilih tidak ikut, hapus panggilan atau teruskan string kosong. - Memulai: Menyiapkan Navigation SDK for iOS
- Referensi: Referensi Navigation SDK for iOS
- Harga: Penggunaan dan penagihan Navigation SDK for iOS
- Kebijakan: Kebijakan Navigation SDK for iOS
- Catatan rilis: Catatan rilis Navigation SDK for iOS
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: produk terkait
- Sering digunakan dengan: Maps SDK for iOS, Routes API, Route Optimization API, Places SDK for iOS
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 = truesaat menavigasi. Lihat /maps/documentation/navigation/ios-sdk/route. - Masalah: Rilis utama SDK mendatang akan menggunakan altimeter (
CMAltimeter), dan aplikasi tanpaNSMotionUsageDescriptiondiInfo.plistakan mengalami error saat inisialisasi. Menambahkan kunci sekarang tidak akan memengaruhi perilaku saat ini. Perbaikan: TambahkanNSMotionUsageDescription(Privacy - Motion Usage Description) keInfo.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
.travelModeUnsupportedjikatravelModeaplikasi bukandrivingatautwoWheeler. Perbaikan: TetapkanmapView.travelModeke.drivingatau.twoWheeler. PeriksaresolvedParameters.travelModeuntuk 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.
GMSNavigatorsetDestinations: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
GMSServicesappCheckTokenProvider: Tidak digunakan lagi sejak 24-09-2026. Pengganti: Properti classGMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). Gejala: Di versi 11.1.0, konfigurasi App Check melaluiGMSServices.sharedServices()gagal. Lihat panduan migrasi. GMSNavigatorcontinueToNextDestination: Tidak digunakan lagi sejak 07-04-2026. Penggantian:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLightsdanshowsStopSigns: Dinonaktifkan sejak 06-08-2026. Pengganti: Tidak perlu pengganti; lampu lalu lintas dan rambu berhenti ditampilkan secara default selama navigasi.- Jenis peta
.terrainselama navigasi aktif: Dinonaktifkan sejak 06-08-2026. Pengganti: Jenis peta.normal(kGMSTypeNormal),.satellite, atau.hybrid. - Protokol
GMSNavigatorDelegatedanGMSRoadSnappedLocationProviderDelegate: Dinonaktifkan sejak 13-05-2021. Pengganti:GMSNavigatorListenerdanGMSRoadSnappedLocationProviderListener(tambahkan dengan-addListener:; tetapkantimeUpdateThresholddandistanceUpdateThresholddiGMSNavigator). 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
- Tambahkan navigasi belokan demi belokan yang interaktif ke aplikasi seluler.
- Menetapkan tujuan untuk navigasi belokan demi belokan.
- Mulai navigasi untuk navigasi belokan demi belokan.
- Tentukan mode perjalanan (mengemudi, berjalan kaki, kendaraan roda dua, taksi) untuk permintaan rute.
- Mengubah preferensi pemilihan rute untuk navigasi belokan demi belokan.
- Tentukan sisi jalan dan preferensi kedatangan lainnya untuk navigasi belokan demi belokan.
- Menentukan rute yang direncanakan ulang untuk navigasi belokan demi belokan dengan token rute yang dapat digunakan kembali.
- Menampilkan info terbaru kedatangan pengguna dari sesi navigasi belokan demi belokan.
- Menampilkan pembaruan lokasi pengguna dari sesi navigasi belokan demi belokan.
- Menampilkan pembaruan waktu dan jarak dari sesi navigasi belokan demi belokan.
- Menampilkan update perubahan rute dari sesi navigasi belokan demi belokan.
- Menampilkan update mode malam dari sesi navigasi belokan demi belokan.
- Menampilkan pembaruan kecepatan pengguna dari sesi navigasi belokan demi belokan.
- Sesuaikan elemen dan kontrol UI yang muncul selama navigasi belokan demi belokan.
- Menambahkan elemen UI baru ke navigasi belokan demi belokan.
- Menambahkan indikator progres perjalanan ke navigasi belokan demi belokan.
- Sesuaikan fitur peta yang muncul selama navigasi belokan demi belokan.
- Menambahkan lapisan lalu lintas ke navigasi belokan demi belokan.
- Mengubah tampilan dan perilaku kamera untuk navigasi belokan demi belokan.
- Sesuaikan notifikasi speedometer dan batas kecepatan untuk navigasi belokan demi belokan.
- Menampilkan feed navigasi belokan demi belokan sebagai serangkaian pesan untuk setiap manuver di sepanjang rute.
- Tentukan ikon manuver kustom untuk digunakan dengan feed navigasi belokan demi belokan.
- Menambahkan navigasi belokan demi belokan yang interaktif untuk CarPlay ke aplikasi iOS. Pratinjau
- Memberi tahu pengguna tentang gangguan di sepanjang rute mereka.
- Izinkan pengguna melihat gangguan di sepanjang rute mereka sebelum memulai navigasi.
- Izinkan pengguna melaporkan gangguan di sepanjang rute mereka.
- Izinkan pengguna memverifikasi gangguan di sepanjang rute mereka.
- Tambahkan tombol pelaporan gangguan rute kustom.