Temukan perjalanan

Fleet Engine menyediakan endpoint SearchTripsRequest yang dapat Anda gunakan untuk menemukan perjalanan. Dokumen ini menjelaskan dua skenario saat 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 tetapkan active_trips_only ke true.

Menyesuaikan 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 menurunkannya dalam peringkat hasil. Salah satu penyebabnya adalah saat kendaraan telah menyelesaikan perjalanan, tetapi status perjalanan belum ditetapkan dengan benar ke COMPLETE atau CANCELED. Dengan menggunakan SearchTrips untuk menemukan perjalanan yang belum selesai, Anda dapat mengevaluasi kendaraan untuk memastikan bahwa TripStatus dalam sistem Anda cocok dengan yang ada di Fleet Engine.

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

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

Hasil permintaan tersebut mencakup Perjalanan yang bukan COMPLETE maupun 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