Dokumentasi di bagian ini menunjukkan cara membuat dan menggunakan perjalanan menggunakan layanan perjalanan on-demand Google Maps Mobility. Anda dianggap sudah memahami hal-hal berikut:
- Fleet Engine: Anda harus memahami detail penerapan Fleet Engine, mekanisme permintaan, dan keamanan. Untuk itu, lihat Apa itu layanan Fleet Engine? dan topik keamanan di Menyiapkan Fleet Engine.
- Dasar-dasar kendaraan untuk layanan sesuai permintaan. Lihat Pengantar kendaraan.
- Dasar-dasar perjalanan untuk layanan sesuai permintaan. Lihat Perjalanan sesuai permintaan.
TripService yang akan Anda gunakan tersedia untuk gRPC dan REST.
Demi kesederhanaan, referensi kolom mengikuti konvensi gRPC.
Di Fleet Engine untuk layanan on-demand, perjalanan adalah jenis perjalanan yang memodelkan pemenuhan permintaan pengantaran makanan atau perjalanan dari konsumen Anda. Perjalanan
memiliki status yang Anda laporkan ke Fleet Engine saat perjalanan berlangsung, seperti
NEW, ENROUTE_TO_PICKUP, dan lainnya. Status perjalanan sesuai dengan titik jalan yang berlokasi geografis yang ditetapkan ke kendaraan, dan Fleet Engine mengubah titik jalan kendaraan ini dengan setiap pembaruan perjalanan yang Anda lakukan. Lihat Perjalanan on demand di Dasar-dasar Fleet Engine untuk mengetahui informasi selengkapnya tentang perjalanan dan hubungannya dengan kendaraan.
Masa aktif 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 end-to-end perjalanan yang dibuat di sistem Anda dan tahap siklus prosesnya di Fleet Engine. Panduan ini mengasumsikan 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 terlebih dahulu menerima
permintaan perjalanan atau pengiriman dari konsumen melalui aplikasi Anda atau
sistem pemesanan lainnya. Sistem Anda kemudian membuat entitas perjalanan menggunakan
CreateTrip dengan kolom yang diperlukan, seperti lokasi penjemputan.
Aplikasi juga dapat menyetel kolom lain pada saat ini, seperti penumpang dan
lokasi pengantaran, atau menunggu hingga aplikasi menetapkan kendaraan. Lihat
Membuat perjalanan dengan satu tujuan. |
| 2 | Menetapkan kendaraan. | Anda dapat menetapkan kendaraan ke perjalanan secara langsung dalam sistem dan melaporkan penetapan tersebut ke Fleet Engine, atau Anda dapat menggunakan layanan Search Vehicle untuk menelusuri kendaraan, memfilter menurut atribut perjalanan dan kendaraan untuk menemukan kendaraan terbaik untuk menyelesaikan perjalanan. Kendaraan online dalam radius penelusuran Anda akan memberitahukan kedekatannya melalui pembaruan lokasi yang disediakan oleh Driver SDK. Setelah |
| 3 | Perbarui perjalanan. | Setelah pengemudi menerima perjalanan dan mulai bernavigasi 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 Anda, atau dengan melakukan polling Fleet Engine, yang menerima
aliran berkelanjutan pembaruan lokasi kendaraan dari Driver SDK. Sistem
Anda kemudian melaporkan setiap pencapaian perjalanan ke Fleet Engine, yang memperbarui
daftar titik jalan kendaraan.
|
| 4 | Bagikan perjalanan dengan konsumen. | Fleet Engine menyediakan detail perjalanan dan lokasi kendaraan untuk Consumer SDK, yang menggunakan pemroses untuk menerima update perjalanan dan menampilkannya di aplikasi konsumen. Fleet Engine otomatis memperbarui perkiraan waktu tiba, jarak yang tersisa, rute, dan titik jalan kendaraan yang tersisa. Lihat Membagikan perjalanan untuk perjalanan on-demand untuk mengetahui informasi selengkapnya. |
| 5 | Selesaikan perjalanan. | Setelah kendaraan mencapai titik jalan tujuan perjalanan dan pengemudi Anda menunjukkan perjalanan berhasil, sistem Anda akan menyetel TripStatus ke COMPLETE di Fleet Engine. Perlu diingat bahwa, seperti kendaraan, entitas perjalanan tetap aktif dalam Fleet Engine selama 7 hari terlepas dari statusnya, dan setelah itu akan dihapus. |
Alur urutan perjalanan
Diagram berikut menunjukkan tampilan yang lebih mendetail dari alur ini.
