Referensi cepat Driver SDK for iOS

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

Paket Driver SDK untuk iOS resmi:

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

Driver SDK untuk iOS: kesalahan umum

  • Masalah: Update kendaraan pertama setelah startup dapat gagal dengan pesan 'update_mask cannot be empty' jika parameter updateMask kosong. Perbaikan: Selalu berikan setidaknya satu nama kolom di updateMask, dan tangani error ini di GMTDVehicleReporterListener didFailVehicleUpdate. Lihat /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot.
  • Masalah: GMSRoadSnappedLocationProvider tidak 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 mulai GMSRoadSnappedLocationProvider (dengan GMTDVehicleReporter sudah 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 ke setDestinations() 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.
  • GMTSServiceType dan fetchAuthTokenForServiceType:authorizationContext:completion:: Tidak digunakan lagi sejak 29-11-2021. Penggantian: GMTDAuthorization fetchTokenWithContext:completion: dengan GMTDAuthorizationContext (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.