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
- Autentikasi: Token Web JSON (JWT)
- Aktifkan juga: Fleet Engine Service
- Memulai: Menyiapkan Consumer SDK untuk iOS
- Referensi: Referensi Consumer SDK untuk iOS
- Kebijakan: Kebijakan Consumer SDK for iOS
- Catatan rilis: Catatan rilis Consumer SDK untuk iOS
Paket Consumer SDK resmi untuk iOS:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
Consumer SDK untuk iOS: produk terkait
- Sering digunakan dengan: Fleet Engine Service, Driver SDK for iOS, Driver SDK for Android, Maps SDK for iOS
Consumer SDK untuk iOS: kesalahan umum
- Masalah: Pemantauan perjalanan gagal dengan error 401
UNAUTHENTICATEDjika 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_ARGUMENTjika nama perjalanan tidak menggunakan formatproviders/{provider_id}/trips/{trip_id}. Perbaikan: Gunakan ID project Google Cloud sebagaiprovider_id, dan teruskan ID project yang sama sebagaiproviderIDsaat 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
unregisterSubscriberpada 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.bundledanGoogleRidesharingConsumer.bundleke project, tautkan framework yang tercantum, dan tambahkan-ObjCke 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:denganGMTSVehicleLocationOptions. [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.
- Tambahkan peta interaktif yang dapat disesuaikan yang melacak progres perjalanan dari Fleet Engine ke aplikasi seluler.
- Tambahkan polyline rute yang melacak perjalanan dari Fleet Engine ke peta di halaman web atau aplikasi seluler.
- Memperbarui progres perjalanan di sepanjang rute pada peta di halaman web atau aplikasi seluler untuk perjalanan Fleet Engine.
- Mengubah gaya jalan, polyline, dan poligon pada peta yang melacak progres perjalanan dari Fleet Engine.
- Menampilkan atau menyembunyikan fitur peta pada peta yang melacak progres perjalanan dari Fleet Engine.
- Mengubah gaya ikon dan label teks pada peta yang melacak progres perjalanan dari Fleet Engine.
- Terapkan gaya peta yang berbeda ke berbagai tingkat zoom pada peta yang melacak progres perjalanan dari Fleet Engine.
- Mengubah kepadatan tempat di peta yang melacak progres perjalanan dari Fleet Engine. Eksperimental Catatan: Dukungan Gaya Visual Peta Berbasis Cloud di Consumer SDK sudah berstatus GA, sedangkan kontrol kepadatan POI adalah fitur Gaya Visual Peta Berbasis Cloud Eksperimental (hanya didukung pada gaya peta terang).
- Mengubah gaya bangunan di peta yang melacak progres perjalanan dari Fleet Engine. Eksperimental Catatan: Dukungan Gaya Visual Peta Berbasis Cloud di Consumer SDK berstatus GA, sedangkan penyesuaian gaya bangunan 3D dan jejak adalah fitur Gaya Visual Peta Berbasis Cloud Eksperimental (hanya didukung pada gaya peta terang).
- Mengubah gaya tempat terkenal di peta yang melacak progres perjalanan dari Fleet Engine. Eksperimental Catatan: Dukungan gaya visual peta berbasis cloud di Consumer SDK tersedia secara GA, sedangkan penyesuaian ikon tempat terkenal adalah fitur gaya visual peta berbasis cloud eksperimental (hanya didukung pada gaya peta terang).
- Sesuaikan penanda di peta yang melacak progres perjalanan dari Fleet Engine.
- Sesuaikan polyline rute di peta yang melacak progres perjalanan dari Fleet Engine.