Dokumentasi di bagian ini menunjukkan cara membuat dan menangani perjalanan menggunakan layanan perjalanan on-demand Google Maps Mobility. Model ini mengasumsikan bahwa Anda telah memahami hal berikut:
- Fleet Engine: Anda harus sudah memahami implementasi Fleet Engine detail, mekanisme permintaan, dan keamanan. Untuk mengetahuinya, lihat Apa yang dimaksud dengan Armada Layanan mesin? dan topik keamanan di bagian 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 menjadi model
pemenuhan pesanan makanan atau transportasi
dari konsumen Anda. Sebuah perjalanan
memiliki status yang Anda laporkan ke Fleet Engine saat perjalanan berkembang, seperti
NEW, ENROUTE_TO_PICKUP, dan lainnya. Status perjalanan sesuai dengan lokasi geografis
titik jalan yang ditetapkan untuk kendaraan, dan Fleet Engine memodifikasi kendaraan ini
titik jalan pada setiap
pembaruan perjalanan yang Anda lakukan. Lihat Perjalanan on demand di Armada
Dasar-dasar mesin untuk mengetahui informasi selengkapnya tentang perjalanan dan hubungannya dengan kendaraan.
Kehidupan perjalanan
Untuk melacak setiap perjalanan di Fleet Engine, Anda harus membuat Trip terlebih dahulu
entitas. Lihat gRPC atau REST untuk referensi.
Tabel berikut menjelaskan contoh alur perjalanan yang dibuat di sistem Anda dan tahapan siklus prosesnya di Fleet Engine. Ini mengasumsikan bahwa Anda telah menyiapkan Fleet Engine dan punya kendaraan untuk ditugaskan ke perjalanan, dengan pembaruan lokasi diaktifkan di aplikasi {i>driver<i}. Lihat SDK Driver: Perjalanan on demand.
| 1 | Terima permintaan pemesanan. | Sebelum perjalanan Fleet Engine dimulai, sistem pemesanan Anda terlebih dahulu akan menerima
meminta transportasi atau pengantaran dari konsumen melalui aplikasi Anda atau
sistem pemesanan. Sistem Anda kemudian membuat
entitas perjalanan menggunakan
CreateTrip dengan kolom wajib diisi, seperti lokasi pengambilan.
Juga dapat mengatur isian lain pada titik ini, seperti penumpang
lokasi pengantaran, atau menunggu hingga kendaraan tersebut ditugaskan. Lihat
Membuat perjalanan satu tujuan. |
| 2 | Tugaskan kendaraan. | Anda dapat menetapkan kendaraan untuk perjalanan langsung dalam sistem Anda dan melaporkan tugas ke Fleet Engine, atau menggunakan Telusuri Kendaraan layanan untuk mencari kendaraan, memfilter menurut perjalanan dan kendaraan untuk menemukan kendaraan terbaik guna menyelesaikan perjalanan. Semua online kendaraan dalam radius penelusuran Anda membuat jaraknya diketahui melalui update lokasi yang disediakan oleh Driver SDK. Setelah |
| 3 | Perbarui perjalanan. | Setelah pengemudi menerima perjalanan dan mulai menavigasi ke
lokasi pengambilan, sistem Anda akan memperbarui status perjalanan dari NEW
ke ENROUTE_TO_PICKUP. Anda terus melakukan polling pada kendaraan
lokasi di sepanjang perjalanan, baik melalui koneksi langsung dari
aplikasi ke backend Anda, atau dengan melakukan polling Fleet Engine, yang menerima
aliran pembaruan lokasi kendaraan secara berkelanjutan dari SDK Driver. Nama
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 bagi Consumer SDK, yang menggunakan pemroses untuk menerima info terbaru perjalanan dan menampilkannya di aplikasi konsumen. Fleet Engine memperbarui PWT secara otomatis, tersisa jarak, rute, dan titik jalan kendaraan yang tersisa. Lihat Bagikan perjalanan untuk perjalanan on demand untuk informasi selengkapnya. |
| 5 | Selesaikan perjalanan. | Setelah kendaraan mencapai titik jalan tujuan perjalanan dan
{i>driver <i}menunjukkan perjalanan yang berhasil, sistem Anda akan menyetel
TripStatus ke COMPLETE di Fleet Engine. Tetap di
perlu diingat bahwa, seperti kendaraan, entitas perjalanan tetap aktif di dalam Fleet Engine
selama 7 hari, apa pun statusnya, pada saat mana iklan tersebut akan dihapus. |
Alur urutan perjalanan
Diagram berikut menunjukkan tampilan alur ini yang lebih mendetail.
