Driver SDK untuk iOS adalah toolkit aplikasi seluler dan komponen Fleet Engine. SDK ini mengirimkan lokasi kendaraan, rute, titik jalan, jarak tersisa, dan perkiraan waktu tiba (ETA) aplikasi pengemudi dari Navigation SDK ke Fleet Engine, untuk perjalanan on-demand dan tugas terjadwal.
Driver SDK untuk iOS: fakta penting
- Produk: Driver SDK for iOS
- Juga dikenal sebagai: Driver SDK, Driver SDK untuk perjalanan on-demand, Driver SDK untuk tugas terjadwal
- Kategori: Rute
- Platform: iOS
- Berjalan di: Klien (kode aplikasi atau browser)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Driver SDK untuk iOS
Driver SDK for iOS: kapan harus menggunakannya
Gunakan Driver SDK for iOS jika:
- Anda memerlukan aplikasi pengemudi iOS untuk mengirim pembaruan lokasi kendaraan secara real-time ke Fleet Engine.
- Anda perlu melaporkan rute, titik jalan, jarak yang tersisa, dan PWT dari Navigation SDK ke Fleet Engine.
- Anda memerlukan pengemudi untuk mengelola perjalanan on-demand yang ditetapkan dan menavigasi dalam satu aplikasi tanpa beralih aplikasi.
- Anda sedang membuat aplikasi pengemudi untuk tugas terjadwal Fleet Engine di iOS.
Jangan gunakan Driver SDK for iOS jika:
- Anda hanya memerlukan navigasi belokan demi belokan di aplikasi iOS, tanpa pelacakan Fleet Engine. Gunakan Navigation SDK for iOS.
- Anda perlu menampilkan progres perjalanan atau pengiriman kepada pengendara atau pelanggan di aplikasi pelanggan. Gunakan Consumer SDK for iOS.
- Anda perlu mengirim update data kendaraan selain lokasi dan rute; update ini dikirim melalui backend Anda ke Fleet Engine. Gunakan Fleet Engine Service sebagai gantinya.
- Aplikasi pengemudi Anda berjalan di Android. Sebagai gantinya, gunakan Driver SDK for Android.
Driver SDK untuk iOS: penyiapan
- Autentikasi: Kunci API, Token Web JSON (JWT)
- Aktifkan juga: Maps SDK for iOS
- Memulai: Menyiapkan Driver SDK untuk iOS
- Referensi: Referensi Driver SDK untuk iOS
- Kebijakan: Kebijakan Driver SDK for iOS
- Catatan rilis: Catatan rilis Driver SDK untuk iOS
Paket Driver SDK untuk iOS resmi:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
Driver SDK for iOS: produk terkait
- Sering digunakan dengan: Navigation SDK for iOS, Fleet Engine Service, Consumer SDK for iOS
Driver SDK untuk iOS: kesalahan umum
- Masalah: Update kendaraan pertama setelah startup dapat gagal dengan pesan 'update_mask cannot be empty' jika parameter
updateMaskkosong. Perbaikan: Selalu berikan setidaknya satu nama kolom diupdateMask, dan tangani error ini diGMTDVehicleReporterListenerdidFailVehicleUpdate. Lihat /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot. - Masalah:
GMSRoadSnappedLocationProvidertidak terus mengirimkan pembaruan lokasi jika perangkat tidak berpindah sejak pembaruan terakhir, misalnya saat pengemudi menunggu dalam keadaan tidak aktif. Perbaikan: Untuk mengirim pembaruan lokasi baru saat perangkat tidak bergerak, hentikan lalu mulaiGMSRoadSnappedLocationProvider(denganGMTDVehicleReportersudah ditambahkan sebagai pemrosesnya). Lihat /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready. - Masalah: Aplikasi pelanggan tidak merender perjalanan dengan benar jika koordinat yang diteruskan ke
setDestinations()tidak cocok dengan titik jalan perjalanan. Perbaikan: Pastikan lintang/bujur yang diteruskan kesetDestinations()cocok dengan koordinat titik jalan perjalanan di Fleet Engine. Lihat /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details. - Masalah: Menggunakan operator versi optimis (
~>) dapat menyebabkan build yang tidak dapat diprediksi dan tidak dapat diulang, dan menghilangkan versi akan memuat SDK terbaru, yang dapat menyertakan perubahan yang dapat menyebabkan gangguan atau menaikkan versi iOS minimum. Carthage tidak didukung. Perbaikan: Sematkan versi Driver SDK yang tepat di CocoaPods atau Swift Package Manager, dan periksa catatan rilis sebelum mengupgrade. Lihat /maps/documentation/mobility/driver-sdk/on-demand/ios/versions.
Driver SDK for iOS: fitur lama dan tidak digunakan lagi
- Class
GMTSVehicleMatch: Tidak digunakan lagi. Pengganti: Tidak diperlukan pengganti di Driver SDK (pencocokan kendaraan ditangani di Fleet Engine). Gejala: Tidak digunakan lagi di Driver SDK for iOS v2.2.0 dan dihilangkan dari referensi Driver SDK saat ini. Lihat panduan migrasi. GMTSServiceTypedanfetchAuthTokenForServiceType:authorizationContext:completion:: Tidak digunakan lagi sejak 29-11-2021. Penggantian:GMTDAuthorizationfetchTokenWithContext:completion:denganGMTDAuthorizationContext(klaim hanya untuk ID kendaraan). Lihat panduan migrasi.
Yang dapat Anda lakukan dengan Driver SDK untuk iOS
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
- Melaporkan posisi real-time kendaraan ke layanan Fleet Engine.
- Laporkan koordinat lintang/bujur titik jalan perjalanan kendaraan dari Navigation SDK ke layanan Fleet Engine.
- Laporkan sisa jarak kendaraan ke titik jalan berikutnya ke layanan Fleet Engine.
- Laporkan perkiraan waktu tiba kendaraan di titik jalan berikutnya ke layanan Fleet Engine.
- Melaporkan rute yang disediakan untuk kendaraan oleh Navigation SDK ke layanan Fleet Engine.