Method: providers.trips.search

الحصول على جميع الرحلات لمركبة معيّنة

طلب HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

مطلوبة. يجب استخدام التنسيق providers/{provider}. يجب أن يكون موفّر الخدمة هو رقم تعريف المشروع (على سبيل المثال، sample-cloud-project) لمشروع Google Cloud الذي يكون حساب الخدمة الذي يجري هذه المكالمة عضوًا فيه.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
الحقول
header

object (RequestHeader)

عنوان الطلب العادي لـ Fleet Engine.
vehicleId

string

المركبة المرتبطة بالرحلات في الطلب إذا لم يتم تحديد هذه الرحلات، لا تتضمّن الرحلات التي تم إرجاعها ما يلي:

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

وفي حال ضبطها على "صحيح"، تتضمّن الاستجابة الرحلات التي تؤثّر في مسار السائق.
pageSize

integer

وفي حال ترك هذه السياسة بدون ضبط، يحدِّد الخادم عدد النتائج التي سيتم عرضها.
pageToken

string

يمكنك ضبط هذه القيمة على قيمة تم عرضها سابقًا في SearchTripsResponse للمتابعة من النتائج السابقة.
minimumStaleness

string (Duration format)

إذا تم تحديدها، سيتم عرض الرحلات التي لم يتم تعديلها بعد الوقت (current - minimumStaleness).

مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ "s". مثال: "3.5s".

نص الاستجابة

رسالة رد trip.search.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
الحقول
trips[]

object (Trip)

قائمة الرحلات للمركبة المطلوبة.
nextPageToken

string

مرِّر هذا الرمز المميّز في SearchTripsRequest إلى الصفحة ضمن نتائج القوائم. تعرض واجهة برمجة التطبيقات قائمة رحلات عند كل طلب، وعندما لا يبقى المزيد من النتائج، تكون قائمة الرحلات فارغة.