Dokumentasi di bagian ini menunjukkan cara membuat dan menggunakan perjalanan menggunakan layanan perjalanan on demand Google Maps Mobility. Tutorial ini mengasumsikan bahwa Anda sudah memahami hal-hal berikut:
- Fleet Engine: Anda harus memahami detail penerapan, mekanisme permintaan, dan keamanan Fleet Engine. Untuk itu, lihat Apa itu layanan Fleet Engine? dan topik keamanan di Menyiapkan Fleet Engine.
- Dasar-dasar kendaraan untuk layanan on demand. Lihat Pengantar kendaraan.
- Dasar-dasar perjalanan untuk layanan on demand. Lihat Perjalanan on demand.
TripService
yang akan Anda gunakan tersedia untuk gRPC dan REST.
Untuk mempermudah, referensi kolom mengikuti konvensi gRPC.
Di Fleet Engine untuk layanan on-demand, perjalanan adalah jenis perjalanan yang memodelkan
fulfillment permintaan perjalanan atau pesanan makanan dari konsumen Anda. Perjalanan
memiliki status yang Anda laporkan ke Fleet Engine seiring perjalanan berkembang, seperti
NEW
, ENROUTE_TO_PICKUP
, dan lainnya. Status perjalanan sesuai dengan titik jalan berdasarkan lokasi geografis yang ditetapkan untuk kendaraan, dan Fleet Engine memodifikasi titik jalan kendaraan ini pada setiap update perjalanan yang Anda buat. Lihat Perjalanan on demand di Dasar-dasar
Mesin Flotte untuk mengetahui informasi selengkapnya tentang perjalanan dan hubungannya dengan kendaraan.
Masa berlaku perjalanan
Untuk melacak setiap perjalanan di Fleet Engine, Anda harus membuat entitas Trip
terlebih dahulu. Lihat gRPC atau REST untuk referensi.
Tabel berikut menjelaskan contoh alur perjalanan menyeluruh yang dibuat di sistem Anda dan tahapan siklus prosesnya di Fleet Engine. Ini mengasumsikan bahwa Anda telah menyiapkan Fleet Engine dan memiliki kendaraan untuk ditetapkan ke perjalanan, dengan pembaruan lokasi diaktifkan di aplikasi pengemudi. Lihat Driver SDK: Perjalanan on-demand.
1 | Menerima permintaan pemesanan. | Sebelum perjalanan Fleet Engine dimulai, sistem pemesanan Anda akan menerima
permintaan perjalanan atau pengiriman dari konsumen terlebih dahulu melalui aplikasi Anda atau sistem pemesanan
lainnya. Kemudian, sistem Anda akan membuat entitas perjalanan menggunakan
CreateTrip dengan kolom wajib diisi, seperti lokasi pengambilan.
Layanan ini juga dapat menetapkan kolom lain pada titik ini, seperti lokasi penumpang dan
penurunan, atau menunggu hingga kendaraan ditetapkan. Lihat
Membuat perjalanan satu tujuan. |
2 | Tetapkan kendaraan. | Anda dapat menetapkan kendaraan ke perjalanan langsung dalam sistem dan melaporkan penetapan ke Fleet Engine, atau Anda dapat menggunakan layanan Search Vehicle untuk menelusuri kendaraan, memfilter menurut atribut perjalanan dan kendaraan untuk menemukan kendaraan terbaik guna menyelesaikan perjalanan. Setiap kendaraan online dalam radius penelusuran Anda akan membuat kedekatannya diketahui melalui pembaruan lokasi yang disediakan oleh Driver SDK. Setelah |
3 | Perbarui perjalanan. | Setelah pengemudi menerima perjalanan dan mulai menavigasi ke
lokasi penjemputan, sistem Anda akan memperbarui status perjalanan dari NEW
menjadi ENROUTE_TO_PICKUP . Anda terus melakukan polling lokasi
kendaraan selama perjalanan, baik melalui koneksi langsung dari
aplikasi ke backend, atau dengan melakukan polling pada Fleet Engine, yang menerima
streaming pembaruan lokasi kendaraan yang sedang berlangsung dari Driver SDK. Sistem
Anda kemudian melaporkan setiap pencapaian perjalanan ke Fleet Engine, yang memperbarui
daftar titik jalan kendaraan.
|
4 | Bagikan perjalanan kepada konsumen. | Fleet Engine menyediakan detail perjalanan dan lokasi kendaraan ke Consumer SDK, yang menggunakan pemroses untuk menerima pembaruan perjalanan dan menampilkannya di aplikasi konsumen. Fleet Engine otomatis memperbarui perkiraan waktu tiba, jarak tersisa, rute, dan titik jalan kendaraan yang tersisa. Lihat Membagikan perjalanan untuk perjalanan on demand untuk mengetahui informasi selengkapnya. |
5 | Perjalanan selesai. | Setelah kendaraan mencapai titik jalan tujuan perjalanan dan
pengemudi menunjukkan perjalanan yang berhasil, sistem Anda akan menyetel
TripStatus ke COMPLETE di Fleet Engine. Perlu diingat bahwa, seperti kendaraan, entitas perjalanan tetap aktif di dalam Fleet Engine selama 7 hari terlepas dari status penghapusannya. |
Alur urutan perjalanan
Diagram berikut menunjukkan tampilan yang lebih mendetail tentang alur ini.