Temukan perjalanan

Fleet Engine menyediakan endpoint SearchTripsRequest yang dapat Anda gunakan untuk menemukan perjalanan. Dokumen ini menjelaskan dua skenario tempat Anda dapat 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 pesan SearchTripsRequest untuk menetapkan vehicle_id ke kendaraan yang sedang dipertimbangkan dan menetapkan active_trips_only ke true.

Menyelaraskan 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 dan armada Anda. Hal ini terjadi karena SearchVehicles tidak menampilkan kendaraan dengan perjalanan aktif, atau mendorongnya ke bawah dalam peringkat hasil. Salah satu penyebabnya 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 bahwa TripStatus di sistem Anda cocok dengan Fleet Engine.

Untuk menggunakan SearchTrips dengan cara ini, tetapkan hal berikut dalam pesan SearchTripsRequest:

  • vehicle_id harus kosong.
  • active_trips_only harus true.
  • minimum_staleness harus berupa waktu yang lebih besar dari sebagian besar durasi perjalanan; misalnya, satu jam.

Hasil permintaan tersebut mencakup Perjalanan yang bukan COMPLETE atau CANCELED, dan belum diperbarui selama lebih dari satu jam. Kemudian, Anda dapat memeriksa perjalanan ini untuk memastikan statusnya di Fleet Engine diperbarui dengan benar.

Langkah berikutnya