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"
|
نص الاستجابة
رسالة الاستجابة trips.search
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"trips": [
{
object (Trip )
}
],
"nextPageToken": string
} |
الحقول |
trips[] |
object (Trip )
تعرض هذه السمة قائمة الرحلات للمركبة المطلوبة.
|
nextPageToken |
string
مرر هذا الرمز المميز في SearchTripsRequest إلى صفحة خلال نتائج القائمة. تعرض واجهة برمجة التطبيقات قائمة رحلات عند كل مكالمة، وعندما لا تظهر أي نتائج أخرى، تكون قائمة الرحلات فارغة.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
{"lastModified": "\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0623\u062e\u064a\u0631: 2024-08-21 (\u062d\u0633\u0628 \u0627\u0644\u062a\u0648\u0642\u064a\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0645\u062a\u0641\u0651\u064e\u0642 \u0639\u0644\u064a\u0647)"}
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)"]]