Dengan Consumer SDK JavaScript, aplikasi pelanggan berbasis web dapat menampilkan lokasi kendaraan dan lokasi menarik lainnya yang dilacak di Fleet Engine pada peta, sehingga konsumen dapat mengikuti progres perjalanan on demand atau pengiriman terjadwal. Library ini dimuat sebagai library journeySharing Maps JavaScript API.
SDK Konsumen JavaScript: fakta penting
- Produk: Consumer SDK JavaScript
- Juga dikenal sebagai: Consumer SDK untuk JavaScript, JavaScript perjalanan on-demand layanan mobilitas, JavaScript SDK
- Kategori: Rute
- Platform: JavaScript (browser)
- Berjalan di: Klien (kode aplikasi atau browser)
- Tahap peluncuran: GA
- Siklus proses: Aktif
- Ringkasan: Ringkasan Consumer SDK JavaScript
JavaScript Consumer SDK: kapan harus menggunakannya
Gunakan Consumer SDK JavaScript jika:
- Anda perlu menampilkan lokasi dan rute kendaraan secara live kepada konsumen untuk perjalanan on-demand yang dilacak Fleet Engine, di halaman web atau aplikasi web.
- Anda perlu mengizinkan konsumen mengikuti progres pengambilan atau pengiriman terjadwal yang dilacak di Fleet Engine di browser.
- Anda perlu menampilkan PWT, jarak tersisa, dan lalu lintas langsung di rute untuk perjalanan dalam tampilan peta berbasis web.
- Anda perlu menyesuaikan penanda perjalanan, polyline rute, atau gaya peta dalam tampilan pelacakan konsumen web.
Jangan gunakan Consumer SDK JavaScript jika:
- Anda memerlukan pengalaman konsumen pemantauan perjalanan di dalam aplikasi Android native. Gunakan Consumer SDK untuk Android.
- Anda memerlukan pengalaman konsumen pelacakan perjalanan di dalam aplikasi iOS native. Gunakan Consumer SDK for iOS.
- Anda perlu melaporkan lokasi pengemudi dan progres perjalanan dari aplikasi Android pengemudi ke Fleet Engine. Sebagai gantinya, gunakan Driver SDK for Android.
- Anda perlu melaporkan lokasi pengemudi dan progres perjalanan dari aplikasi iOS pengemudi ke Fleet Engine. Gunakan Driver SDK for iOS.
- Anda memerlukan peta web umum yang tidak mengikuti perjalanan atau tugas Fleet Engine. Gunakan Maps JavaScript API.
SDK Konsumen JavaScript: penyiapan
- Autentikasi: Kunci API, Token Web JSON (JWT)
- Aktifkan juga: Maps JavaScript API, Fleet Engine Service
- Atribusi penggunaan: ID Transaksi Mobilitas opsional (beta): tetapkan
google.maps.Settings.getInstance().experienceIdske array ID Transaksi Mobilitas (atau ID terkait) sebelum Anda membuatJourneySharingMapView.experienceIdshanya tersedia di saluranv=betaMaps JavaScript API. - Memulai: Menyiapkan Consumer SDK JavaScript
- Referensi: Referensi Consumer SDK JavaScript
- Catatan rilis: Catatan rilis Consumer SDK JavaScript
JavaScript Consumer SDK: produk terkait
- Sering digunakan dengan: Fleet Engine Service, Maps JavaScript API, Driver SDK for Android, Driver SDK for iOS
SDK Konsumen JavaScript: kesalahan umum
- Masalah: Jika Anda tidak memberikan area pandang awal (pusat dan zoom) pada peta
JourneySharingMapView, peristiwa'ready'peta mungkin tidak akan diaktifkan. Perbaikan: PanggilmapView.map.setCenter(...)danmapView.map.setZoom(...)setelah Anda membuat tampilan peta. Lihat /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Masalah: Error dari permintaan informasi perjalanan asinkron tidak ditampilkan. Peristiwa ini hanya muncul sebagai peristiwa
'error'di penyedia lokasi, sehingga tidak akan terlihat kecuali jika Anda menambahkan pemroses. Perbaikan: TambahkanlocationProvider.addListener('error', ...)dan gabungkan panggilan library dalam bloktry...catch. Lihat /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Masalah: Class
google.maps.journeySharingtidak tersedia kecuali jika Anda memuat libraryjourneySharing. Perbaikan: Tambahkanlibraries=journeySharingke URL skrip Maps JavaScript API, atau muat class denganawait google.maps.importLibrary("journeySharing"). Lihat /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey. - Masalah: Panggilan Fleet Engine dari browser (lingkungan dengan tingkat kepercayaan rendah) memerlukan JWT yang dikeluarkan oleh server backend Anda. Kunci API saja tidak mengizinkan akses data perjalanan. Perbaikan: Terbitkan JWT dari backend Anda dan berikan
authTokenFetcheryang menampilkan token danexpiresInSeconds. Lihat /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup.
SDK Konsumen JavaScript: fitur lama dan tidak digunakan lagi
- Opsi penyiapan polyline dan penanda
JourneySharingMapViewdanJourneySharingMapViewOptions(vehicleMarkerSetup,originMarkerSetup,destinationMarkerSetup,waypointMarkerSetup,anticipatedRoutePolylineSetup,takenRoutePolylineSetup, dan lainnya): Tidak digunakan lagi. Pengganti: OpsiMarkerCustomizationFunctiondanPolylineCustomizationFunctionpada penyedia lokasi (misalnya,vehicleMarkerCustomization). Gejala: Dijadwalkan untuk dihapus dalam rilis mendatang. Lihat panduan migrasi. JourneySharingMapView.locationProviderdanJourneySharingMapViewOptions.locationProvider: Tidak digunakan lagi. Pengganti:JourneySharingMapView.locationProvidersdanJourneySharingMapViewOptions.locationProviders.- Properti daftar polyline dan penanda
JourneySharingMapView(vehicleMarkers,originMarkers,destinationMarkers,waypointMarkers,anticipatedRoutePolylines,takenRoutePolylines, dan properti penanda tugas): Tidak digunakan lagi. Pengganti: CallbackMarkerCustomizationFunctiondanPolylineCustomizationFunctionpada penyedia lokasi. Lihat panduan migrasi.
Yang dapat Anda lakukan dengan JavaScript Consumer SDK
Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.
- 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.