Fleet Engine menyediakan endpoint SearchTripsRequest
yang dapat Anda gunakan untuk menemukan
perjalanan. Dokumen ini menjelaskan dua skenario yang memungkinkan Anda menggunakan fitur ini.
Lihat SearchTripsRequest
untuk gRPC atau trips.Search
untuk REST.
Menentukan perjalanan aktif untuk kendaraan
Untuk menemukan perjalanan aktif untuk kolom tertentu, gunakan SearchTripsRequest
pesan untuk menetapkan vehicle_id
ke kendaraan yang dipertimbangkan dan menyetel
active_trips_only
sampai true
.
Merekonsiliasi ketersediaan kendaraan antara sistem Anda dan Fleet Engine
Dalam beberapa situasi, Anda mungkin melihat hasil yang ditampilkan oleh SearchVehicles
yang
tidak sesuai dengan kendaraan yang
Anda ketahui tersedia di sistem Anda dan
armada Anda. Hal ini terjadi karena SearchVehicles
tidak menampilkan kendaraan
dengan perjalanan aktif, atau mendorongnya ke bawah di peringkat hasil. Salah satu penyebab
adalah saat kendaraan telah menyelesaikan perjalanan, tetapi status perjalanan tidak ditetapkan dengan benar
ke COMPLETE
atau CANCELED
. Dengan menggunakan SearchTrips
untuk menemukan perjalanan terbuka,
Anda dapat mengevaluasi kendaraan untuk memastikan TripStatus
dalam sistem Anda cocok
yaitu Fleet Engine.
Untuk menggunakan SearchTrips
dengan cara ini, setel berikut ini di SearchTripsRequest
pesan:
vehicle_id
harus kosong.active_trips_only
harustrue
.- Waktu
minimum_staleness
harus lebih lama dari sebagian besar durasi perjalanan; untuk misalnya, satu jam.
Hasil permintaan tersebut mencakup Perjalanan yang bukan COMPLETE
atau
CANCELED
, dan belum diperbarui selama lebih dari satu jam. Selanjutnya Anda bisa memeriksa
perjalanan ini untuk memastikan statusnya di Fleet Engine diperbarui dengan benar.