Saat Anda menggunakan fitur berbagi perjalanan Fleet Engine untuk perjalanan on-demand, konsumen dapat melacak perkembangan pesanan, perjalanan, atau layanan lain yang Anda berikan kepada mereka.
Apa itu {i>user journey<i}?
Berbagi perjalanan adalah fitur Fleet Engine untuk perjalanan on-demand, yang digunakan untuk SDK Konsumen. Menyediakan antarmuka yang membuat model data perjalanan dan mengikuti perjalanan di Fleet Engine, dan menyediakan kelas yang Anda gunakan untuk membuat tampilan berbasis peta untuk informasi perjalanan kepada pengguna konsumen. Anda mengintegrasikan SDK ke dalam aplikasi Anda dan tetapkan profil peran yang sesuai dalam Fleet Engine untuk mendukung penggunaan berbagi perjalanan oleh konsumen.
Berbagi perjalanan menyediakan API khusus platform, sehingga Anda dapat membangun perjalanan berbagi secara native ke dalam aplikasi Anda. Consumer SDK tersedia untuk platform berikut:
Mengapa menggunakan berbagi perjalanan?
Dengan mengintegrasikan berbagi perjalanan ke dalam aplikasi perjalanan on demand, Anda memberikan pengalaman pemantauan kendaraan yang komprehensif, dengan waktu yang mendekati real-time pembaruan lokasi dan posisi yang diambil jalan. Nama konsumen dapat melihat rute kendaraan terhampar di atas peta, termasuk detail kemajuan yang membantu mereka memahami di mana mereka dapat mengantar atau antar.
Apa yang dapat Anda lakukan dengan berbagi perjalanan?
Anda dapat menggunakan informasi dari Driver SDK dan Fleet Engine untuk membuat multimedia tampilan SDK seluler dan respons layanan web yang menyediakan fitur berikut:
Berikan penyesuaian UI peta agar sesuai dengan kebutuhan branding Anda.
Lokasi kendaraan saat ini dalam perjalanan di sepanjang rute, dengan posisinya diperbarui secara berkala.
Perkiraan waktu tiba (PWT) untuk lokasi penjemputan dan pengantaran.
Jarak yang tersisa.
Lalu lintas langsung di rute.
Cara kerja berbagi perjalanan
Secara umum, fitur berbagi perjalanan bergantung pada mekanisme berikut:
- Peran pengguna Fleet Engine yang sesuai sehingga pengguna aplikasi yang diautentikasi dapat mengambil perjalanan yang terkait dengan pesanannya.
- Pengaitan antara konsumen dan perjalanan, yang diberikan oleh sistem backend.
- Consumer SDK
TripModeldanJourneySharingSession, class SDK yang membuat model data perjalanan dan membagikan sesi perjalanan di aplikasi konsumen.
Consumer SDK juga menyediakan antarmuka dan class lain sehingga Anda dapat membuat antarmuka pengguna pemetaan untuk aplikasi Anda, sehingga konsumen memiliki pengalaman aplikasi yang lengkap dengan detail seperti lalu lintas, penanda peta, PWT, dan data rute.
Tabel ini menunjukkan alur perjalanan bersama.
| 1 | Aplikasi konsumen meminta Perjalanan. | Server backend Anda menerima permintaan perjalanan on-demand dan
berikut ini:
|
| 2 | Pengemudi menerima perjalanan | Aplikasi pengemudi mendapatkan ID perjalanan dan informasi perjalanan, serta pengemudi menerima perjalanan. |
| 3 | Aplikasi konsumen meminta akses ke perjalanan | Aplikasi konsumen mendapatkan ID perjalanan dari backend Anda dan untuk memulai {i>user journey<i}. |
| 4 | Pengemudi memulai perjalanan | Saat pengemudi menggunakan aplikasi pengemudi untuk menunjukkan bahwa perjalanan telah dimulai, aplikasi akan memberi tahu server backend Anda melalui Driver SDK. Misalnya, saat {i>driver<i} akan meninggalkan restoran atau mengemudi ke lokasi penjemputan. |
| 5 | Fleet Engine mulai berbagi perjalanan | Fleet Engine mulai melacak perjalanan dan berbagi kemajuannya dengan aplikasi konsumen. |
| 6 | Aplikasi konsumen menampilkan perjalanan | Aplikasi konsumen memberi tahu konsumen dan mulai menampilkan perjalanan bersama mereka, dan memperbarui perjalanan mereka. |
| 7 | Perjalanan selesai atau dibatalkan | Saat pengemudi membatalkan atau menyelesaikan perjalanan, aplikasi pengemudi menonaktifkan pelacakan lokasi, dan server backend Anda memberi tahu Fleet Engine untuk menandai perjalanan sebagai dibatalkan atau selesai. |
| 8 | Aplikasi konsumen menghentikan berbagi perjalanan | Perjalanan akan ditampilkan sebagai dibatalkan atau selesai. |
| 9 | Proses berulang untuk perjalanan berikutnya | Perjalanan baru dibuat dan proses tersebut berulang. |
Cara menggunakan fitur berbagi perjalanan
Pilih platform Anda untuk melihat cara memulai berbagi perjalanan.
Android
| 1 | Menyiapkan Consumer SDK di Android | Untuk membagikan perjalanan dalam perjalanan on demand di aplikasi Anda, siapkan SDK Konsumen. Untuk informasi selengkapnya, lihat Mendapatkan Android Consumer SDK. |
| 2 | Menyiapkan antarmuka visual berbagi perjalanan | Tentukan peta dan tambahkan dukungan untuk peta vektor untuk menyiapkan antarmuka perjalanan Anda. Untuk informasi selengkapnya, lihat Menyiapkan peta. |
| 3 | Bagikan perjalanan | Ikuti perjalanan untuk membagikan lokasi kendaraan yang sesuai kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Mengikuti perjalanan. |
| 5 | Memperbarui progres perjalanan dan menangani error perjalanan | Perbarui detail tentang perjalanan Anda, seperti jarak perjalanan dan perkiraan waktu tiba, dan tangani error selama perjalanan tersebut. Untuk informasi selengkapnya, lihat Memperbarui progres perjalanan dan Menangani error perjalanan. |
| 5 | Berhenti berbagi saat perjalanan sudah selesai | Berhenti mengikuti perjalanan untuk berhenti membagikan lokasi kendaraan kepada konsumen Anda. Untuk informasi selengkapnya, lihat Berhenti mengikuti perjalanan. |
iOS
| 1 | Menyiapkan Consumer SDK di iOS | Untuk membagikan perjalanan dalam perjalanan on demand di aplikasi Anda, siapkan SDK Konsumen. Untuk informasi selengkapnya, lihat Mendapatkan iOS Consumer SDK. |
| 2 | Menyiapkan antarmuka visual berbagi perjalanan | Lakukan inisialisasi tampilan peta dan tangani peristiwa peta untuk menyiapkan antarmuka perjalanan Anda. Untuk informasi selengkapnya, lihat Menyiapkan peta. |
| 3 | Bagikan perjalanan | Ikuti perjalanan untuk membagikan lokasi kendaraan yang sesuai kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Mengikuti perjalanan. |
| 5 | Memperbarui progres perjalanan dan menangani error perjalanan | Perbarui detail tentang perjalanan Anda, seperti jarak perjalanan dan perkiraan waktu tiba, dan tangani error selama perjalanan tersebut. Untuk informasi selengkapnya, lihat Memperbarui progres perjalanan dan Menangani error perjalanan. |
| 5 | Berhenti berbagi saat perjalanan sudah selesai | Berhenti mengikuti perjalanan untuk berhenti membagikan lokasi kendaraan kepada konsumen Anda.Untuk informasi selengkapnya, lihat Berhenti mengikuti perjalanan. |
JavaScript
| 1 | Menyiapkan Berbagi perjalanan di JavaScript | Untuk membagikan perjalanan dalam perjalanan on demand di aplikasi Anda, siapkan SDK Konsumen. Untuk informasi selengkapnya, lihat Menyiapkan JavaScript Consumer SDK. |
| 2 | Memuat dan menyesuaikan peta berbagi perjalanan | Aktifkan Maps JavaScript API dan siapkan otorisasi untuk menyiapkan antarmuka perjalanan Anda. Untuk informasi selengkapnya, lihat Menyiapkan peta. |
| 3 | Bagikan perjalanan | Ikuti perjalanan untuk membagikan lokasi kendaraan yang sesuai kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Mengikuti perjalanan. |
| 5 | Memperbarui progres perjalanan dan menangani error perjalanan | Perbarui detail tentang perjalanan Anda, seperti jarak perjalanan dan perkiraan waktu tiba, dan tangani error selama perjalanan tersebut. Untuk informasi selengkapnya, lihat Memperbarui dan mengikuti progres perjalanan serta Menangani error perjalanan. |
| 5 | Berhenti berbagi saat perjalanan sudah selesai | Berhenti mengikuti perjalanan untuk berhenti membagikan lokasi kendaraan kepada konsumen Anda. Untuk mengetahui informasi selengkapnya, lihat Menghentikan berbagi perjalanan. |
Komponen
Bagian ini merangkum dua komponen yang diperlukan untuk berbagi perjalanan:
Jika perlu, Anda juga dapat menyesuaikan pengalaman berbagi perjalanan dengan komponen:
Pengambil token autentikasi
Untuk mengontrol akses ke data lokasi yang disimpan di Fleet Engine, Anda harus melakukan berikut ini:
Mengimplementasikan layanan pembuatan JSON Web Token (JWT) untuk Fleet Engine di server Anda.
Mengimplementasikan pengambil token autentikasi di web atau aplikasi seluler Anda untuk mengautentikasi akses ke data lokasi.
Sebagai informasi selengkapnya, lihat panduan penyiapan untuk Android, iOS, atau JavaScript.
Tampilan peta dan pelacak perjalanan
Berbagi perjalanan mencakup komponen untuk visualisasi kendaraan dan titik jalan, serta feed data mentah untuk PWT pengemudi atau jarak tempuh yang tersisa.
Tabel berikut menjelaskan komponen ini:
| Komponen | Deskripsi |
|---|---|
| Tampilan peta berbagi perjalanan | Tampilan peta mengelola siklus proses sebuah perjalanan, dengan menampilkan titik jalan untuk mengetahui lokasi kendaraan selama perjalanan berlangsung. Jika rute untuk kendaraan diketahui, tampilan peta akan memperbarui rute kendaraan polyline untuk menunjukkan kemajuan kendaraan di sepanjang rutenya. |
| Penyedia lokasi perjalanan di JavaScript | Untuk aplikasi web JavaScript, lokasi feed penyedia lokasi perjalanan
informasi untuk objek yang dilacak
ke dalam peta perjalanan bersama. Untuk selengkapnya
informasi, lihat
Membuat instance penyedia lokasi perjalanan.
Anda dapat menggunakan penyedia lokasi perjalanan untuk melacak detail berikut untuk
perjalanan:
|
Objek lokasi yang dilacak
Penyedia lokasi melacak lokasi objek seperti titik jalan dan kendaraan, dijelaskan dalam tabel berikut.
| Lokasi yang dilacak | Deskripsi |
|---|---|
| Lokasi pengambilan | Lokasi penjemputan adalah lokasi awal perjalanan. Menandai lokasi penjemputan. |
| Lokasi tujuan | Lokasi tujuan adalah lokasi tempat perjalanan berakhir. Penanda menandai lokasi pengantaran. |
| Lokasi titik jalan | Lokasi titik jalan adalah lokasi perantara di sepanjang rute perjalanan yang terlacak. Sementara titik jalan secara teknis bisa berupa lokasi penjemputan dan pengantaran, titik jalan biasanya mengacu pada perantara perhentian di sepanjang rute. Misalnya, perhentian antara penjemputan dan tujuan lokasi pada rute pengiriman adalah lokasi titik jalan. Untuk informasi selengkapnya, lihat Titik jalan perjalanan di dokumentasi Fleet Engine. |
| Lokasi kendaraan | Lokasi kendaraan adalah lokasi kendaraan yang dilaporkan. Untuk selengkapnya informasi, lihat Lokasi kendaraan di dokumentasi Fleet Engine. |
Menata gaya peta
Gaya penanda dan polyline menentukan tampilan dan nuansa objek lokasi terlacak di peta. Anda dapat menggunakan opsi gaya kustom untuk mengubah gaya default agar sesuai dengan gaya aplikasi web Anda.
Mengontrol visibilitas lokasi yang dilacak
Penyedia lokasi yang telah ditentukan di Fleet Engine mengikuti aturan visibilitas ini untuk objek lokasi terlacak di peta. Jika Anda membuat model kustom penyedia lokasi, Anda dapat mengubah aturan visibilitas.
Kendaraan hanya terlihat saat perjalanan sedang berlangsung: Perjalanan kendaraan bersama dapat terlihat sejak kendaraan itu ditetapkan ke perjalanan ke waktu pengiriman. Jika perjalanan dibatalkan, kendaraan akan lebih terlihat.
Semua penanda lokasi lainnya selalu terlihat: Semua penanda lokasi lainnya untuk asal, tujuan, dan titik jalan selalu ditampilkan pada peta. Sebagai contoh, lokasi pengantaran atau pengiriman barang di satu tempat lokasi akan selalu ditampilkan di peta, terlepas dari status perjalanan atau pengiriman.
Langkah berikutnya
Lihat dokumentasi untuk platform tempat Anda ingin membagikan perjalanan: