الحصول على جميع الرحلات لمركبة معيّنة
طلب HTTP
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
parent |
مطلوبة. يجب استخدام التنسيق |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"header": {
object ( |
الحقول | |
---|---|
header |
عنوان الطلب العادي لـ Fleet Engine. |
vehicleId |
المركبة المرتبطة بالرحلات في الطلب إذا لم يتم تحديد هذه الرحلات، لا تتضمّن الرحلات التي تم إرجاعها ما يلي:
|
activeTripsOnly |
وفي حال ضبطها على "صحيح"، تتضمّن الاستجابة الرحلات التي تؤثّر في مسار السائق. |
pageSize |
وفي حال ترك هذه السياسة بدون ضبط، يحدِّد الخادم عدد النتائج التي سيتم عرضها. |
pageToken |
يمكنك ضبط هذه القيمة على قيمة تم عرضها سابقًا في |
minimumStaleness |
إذا تم تحديدها، سيتم عرض الرحلات التي لم يتم تعديلها بعد الوقت مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ " |
نص الاستجابة
رسالة رد trip.search.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"trips": [
{
object ( |
الحقول | |
---|---|
trips[] |
قائمة الرحلات للمركبة المطلوبة. |
nextPageToken |
مرِّر هذا الرمز المميّز في SearchTripsRequest إلى الصفحة ضمن نتائج القوائم. تعرض واجهة برمجة التطبيقات قائمة رحلات عند كل طلب، وعندما لا يبقى المزيد من النتائج، تكون قائمة الرحلات فارغة. |