Referensi cepat Consumer SDK untuk iOS

Consumer SDK untuk iOS memungkinkan aplikasi pelanggan iOS mengikuti perjalanan on-demand di Fleet Engine. Class-nya, seperti GMTCTripModel dan GMTCJourneySharingSession, membuat model data perjalanan dan menampilkan lokasi, rute, perkiraan waktu tiba, dan jarak tersisa kendaraan di peta.

Consumer SDK untuk iOS: fakta penting

  • Produk: Consumer SDK for iOS
  • Juga dikenal sebagai: Consumer SDK iOS
  • Kategori: Rute
  • Platform: iOS
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Consumer SDK untuk iOS

Consumer SDK untuk iOS: kapan harus menggunakannya

Gunakan Consumer SDK untuk iOS jika:

  • Anda memerlukan aplikasi iOS tempat konsumen mengikuti perjalanan on-demand atau pengiriman yang dilacak oleh Fleet Engine.
  • Anda perlu menampilkan lokasi kendaraan yang hampir real-time, rute, dan lalu lintas langsung di peta dalam aplikasi konsumen iOS.
  • Anda perlu menampilkan perkiraan waktu kedatangan (ETA) penjemputan dan penurunan serta jarak yang tersisa untuk perjalanan on-demand di iOS.
  • Anda sudah menggunakan Fleet Engine dan Driver SDK untuk perjalanan on-demand dan memerlukan sisi konsumen untuk berbagi perjalanan.

Jangan gunakan Consumer SDK for iOS jika:

  • Anda memerlukan konsumen untuk mengikuti tugas atau pengiriman terjadwal; pengalaman konsumen tugas terjadwal didokumentasikan untuk JavaScript. Sebagai gantinya, gunakan JavaScript Consumer SDK.
  • Anda perlu membagikan progres perjalanan on demand di aplikasi pelanggan Android. Gunakan Consumer SDK untuk Android.
  • Anda perlu membagikan progres perjalanan on-demand di aplikasi web. Gunakan JavaScript Consumer SDK.
  • Anda perlu mengirim lokasi pengemudi dan status perjalanan dari aplikasi iOS pengemudi ke Fleet Engine. Gunakan Driver SDK for iOS.

Consumer SDK untuk iOS: penyiapan

Paket Consumer SDK resmi untuk iOS:

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

Consumer SDK untuk iOS: kesalahan umum

  • Masalah: Pemantauan perjalanan gagal dengan error 401 UNAUTHENTICATED jika JWT ditandatangani tanpa ID perjalanan atau telah habis masa berlakunya. Perbaikan: Minta penyedia token (GMTCAuthorization) menampilkan JWT yang diterbitkan untuk ID perjalanan dalam konteks otorisasi, simpan dalam cache per perjalanan, dan muat ulang saat masa berlakunya habis. Lihat /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk.
  • Masalah: Pemantauan perjalanan gagal dengan error 400 INVALID_ARGUMENT jika nama perjalanan tidak menggunakan format providers/{provider_id}/trips/{trip_id}. Perbaikan: Gunakan ID project Google Cloud sebagai provider_id, dan teruskan ID project yang sama sebagai providerID saat Anda menginisialisasi SDK. Lihat /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk.
  • Masalah: Aplikasi terus memproses update setelah perjalanan selesai atau dibatalkan. Perbaikan: Panggil unregisterSubscriber pada model perjalanan saat perjalanan selesai atau dibatalkan. Lihat /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey.
  • Masalah: Penginstalan XCFramework manual menghilangkan paket resource dan setelan build yang diperlukan, kecuali jika Anda menambahkannya di Xcode. Perbaikan: Gunakan CocoaPods jika memungkinkan. Untuk penginstalan manual, tambahkan gRPCCertificates.bundle dan GoogleRidesharingConsumer.bundle ke project, tautkan framework yang tercantum, dan tambahkan -ObjC ke Other Linker Flags untuk debug dan rilis. Lihat /maps/documentation/mobility/journey-sharing/on-demand/ios/setup.

Consumer SDK for iOS: fitur lama dan tidak digunakan lagi

  • Penginisialisasi GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute:: Tidak digunakan lagi sejak 01-06-2025. Penggantian: GMTSVehicleLocation -initWithOptions: dengan GMTSVehicleLocationOptions.
  • [GMTCMapView initWithCoder]: Tidak digunakan lagi sejak 01-12-2023. Penggantian: GMTCMapView -initWithOptions:.

Yang dapat Anda lakukan dengan Consumer SDK for iOS

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