Dokumentasi di bagian ini menunjukkan cara membuat dan menggunakan perjalanan menggunakan layanan perjalanan sesuai permintaan Google Maps Mobility. Dokumentasi ini mengasumsikan bahwa Anda sudah memahami hal-hal berikut:
- Fleet Engine: Anda harus memahami detail penerapan Fleet Engine, mekanisme permintaan, dan keamanan. Untuk itu, lihat Apa yang dimaksud dengan 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.
Untuk mempermudah, referensi kolom mengikuti konvensi gRPC.
Di Fleet Engine untuk layanan sesuai permintaan, perjalanan adalah jenis perjalanan yang memodelkan pemenuhan permintaan pengiriman 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 berlokasi geografis yang ditetapkan ke kendaraan, dan Fleet Engine mengubah titik jalan kendaraan ini dengan setiap update perjalanan yang Anda lakukan. Lihat Perjalanan sesuai permintaan 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 entity Trip terlebih dahulu. Lihat gRPC atau REST sebagai referensi.
Tabel berikut menjelaskan contoh alur perjalanan end-to-end yang dibuat di sistem Anda dan tahap siklus prosesnya di Fleet Engine. Tabel ini mengasumsikan bahwa Anda telah menyiapkan Fleet Engine dan memiliki kendaraan untuk ditetapkan ke perjalanan, dengan update lokasi diaktifkan di aplikasi pengemudi. Lihat Driver SDK: Perjalanan sesuai permintaan.
| 1 | Menerima permintaan pemesanan. | Sebelum perjalanan Fleet Engine dimulai, sistem pemesanan Anda akan menerima
permintaan perjalanan atau pengiriman dari konsumen melalui aplikasi Anda atau sistem pemesanan lainnya. Sistem Anda kemudian membuat entity perjalanan menggunakan
CreateTrip dengan kolom yang diperlukan, seperti lokasi penjemputan.
Sistem ini juga dapat menetapkan kolom lain pada tahap ini, seperti penumpang dan
lokasi pengantaran, atau menunggu hingga menetapkan kendaraan. Lihat
Membuat perjalanan satu tujuan. |
| 2 | Menetapkan 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 berdasarkan atribut perjalanan dan kendaraan untuk menemukan kendaraan terbaik guna menyelesaikan perjalanan. Setiap kendaraan online dalam radius penelusuran akan memberi tahu kedekatannya melalui update lokasi yang disediakan oleh Driver SDK. Setelah |
| 3 | Memperbarui 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 Fleet Engine, yang menerima aliran update lokasi kendaraan berkelanjutan dari Driver SDK. Sistem Anda kemudian melaporkan setiap pencapaian perjalanan ke Fleet Engine, yang memperbarui daftar titik jalan kendaraan.
|
| 4 | Membagikan perjalanan kepada konsumen. | Fleet Engine menyediakan detail perjalanan dan lokasi kendaraan ke Consumer SDK, yang menggunakan pemroses untuk menerima update perjalanan dan menampilkannya di aplikasi konsumen. Fleet Engine otomatis memperbarui ETA, jarak tersisa, rute, dan titik jalan kendaraan yang tersisa. Lihat Membagikan perjalanan untuk perjalanan sesuai permintaan guna mengetahui informasi selengkapnya. |
| 5 | Menyelesaikan perjalanan. | Setelah kendaraan mencapai titik jalan tujuan perjalanan dan pengemudi Anda menunjukkan perjalanan yang berhasil, sistem Anda akan menetapkan TripStatus ke COMPLETE di Fleet Engine. Perlu diingat bahwa, seperti kendaraan, entity perjalanan tetap aktif dalam Fleet Engine selama 7 hari, apa pun statusnya, dan setelah itu akan dihapus. |
Alur urutan perjalanan
Diagram berikut menunjukkan tampilan yang lebih mendetail dari alur ini.
