Method: providers.vehicles.list

string

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

object (RequestHeader)

عنوان طلب Fleet Engine العادي

integer

الحد الأقصى لعدد المركبات التي سيتم عرضها القيمة التلقائية: 100.

string

قيمة nextPageToken التي يوفرها استدعاء سابق إلى vehicles.list حتى يكون بإمكانك التقسيم على صفحات بين مجموعات من المركبات. تكون القيمة غير محدّدة إذا لم تكن معايير الفلتر للطلب هي نفسها معايير الفلتر لطلب vehicles.list السابق.

integer

تُستخدَم لتحديد الحد الأدنى المطلوب لسعة المركبة. وسيكون لدى جميع المركبات التي يتم عرضها قيمة maximumCapacity أكبر من أو تساوي هذه القيمة. يجب أن تكون أكبر من أو تساوي 0 في حال ضبطها.

enum (TripType)

يقصر الاستجابة على المركبات التي تتوافق مع نوع واحد على الأقل من أنواع الرحلات المحددة.

string (Duration format)

تقييد الاستجابة على المركبات التي أرسلت تعديلات على الموقع الجغرافي إلى Fleet Engine خلال المدة المحدّدة لا تُعتبر المركبات الثابتة التي لا تزال تُرسِل مواقعها الجغرافية قديمة. يجب أن تكون مدة صالحة موجبة في حال توفّرها.

مدة بالثواني تضم تسعة أرقام كسور كحد أقصى وتنتهي بـ "s"، مثال: "3.5s"

enum (Category)

مطلوب. تعمل هذه السياسة على تقييد الاستجابة للمركبات التي تندرج ضمن إحدى الفئات المحدّدة. لا يُسمح باستخدام UNKNOWN.

string

ويمكن للمتصلين إنشاء عمليات منطقية معقدة باستخدام أي مجموعة من الحقول requiredAttributes وrequiredOneOfAttributes وrequiredOneOfAttributeSets.

requiredAttributes هي قائمة، ويستخدم requiredOneOfAttributes رسالة تسمح بقائمة من القوائم. ويسمح الحقلان معًا بتكوين هذا التعبير:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

تقييد الاستجابة على المركبات التي تحتوي على السمات المحدّدة هذا الحقل هو عملية ربط/و. يُسمح بحد أقصى 50 سمة مطلوبة. يتطابق ذلك مع الحد الأقصى لعدد السمات المسموح به للمركبة. يجب أن تكون كل سلسلة متكررة بالتنسيق "key:value".

string

تعمل هذه السياسة على تقييد الاستجابة للمركبات التي تتضمّن سمة واحدة على الأقل من السمات المحدّدة في كل VehicleAttributeList. وفي كل قائمة، يجب أن تتطابق المركبة مع سمة واحدة على الأقل. يمثّل هذا الحقل عملية فصل/أو عملية شاملة في كل VehicleAttributeList وعملية ضم/و في مجموعة VehicleAttributeList. يجب أن تكون كل سلسلة متكررة بالتنسيق "key1:value1|key2:value2|key3:value3".

string

يوفّر requiredOneOfAttributeSets وظائف إضافية.

على غرار requiredOneOfAttributes، يستخدم requiredOneOfAttributeSets رسالة تسمح بقائمة من القوائم، مع السماح بالتعبيرات مثل هذه:

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

تقييد الاستجابة على المركبات التي تتطابق مع جميع السمات في VehicleAttributeList ويجب أن تتطابق المركبة مع جميع السمات في كل قائمة. هذا الحقل هو عملية ربط/و في كل عملية VehicleAttributeList وعملية فصل/أو عملية شاملة على مستوى مجموعة VehicleAttributeList. يجب أن تكون كل سلسلة متكرّرة بالتنسيق "المفتاح1:القيمة1|المفتاح2:القيمة2|المفتاح3:القيمة3".

enum (VehicleState)

يحدّ من الاستجابة للمركبات التي تتضمّن حالة المركبة هذه.

boolean

إرجاع المركبات ذات الرحلات الحالية فقط

string

اختياريّ. طلب بحث فلتر لتطبيقه عند إدراج المركبات يُرجى الاطّلاع على http://aip.dev/160 للحصول على أمثلة على بنية الفلتر.

تم تصميم هذا الحقل ليحلّ محلّ الحقول requiredAttributes وrequiredOneOfAttributes وrequired_one_of_attributes_sets. في حال تحديد قيمة غير فارغة هنا، يجب أن تكون الحقول التالية فارغة: requiredAttributes وrequiredOneOfAttributes وrequired_one_of_attributes_sets.

يعمل هذا الفلتر كعبارة AND مع قيود أخرى، مثل vehicleState أو onTripOnly.

يُرجى العلم أنّ طلبات البحث المتاحة هي فقط تلك المتعلقة بسمات المركبات (على سبيل المثال، attributes.<key> = <value> أو attributes.<key1> = <value1> AND attributes.<key2> = <value2>)، مع العلم أنّ الحدّ الأقصى المسموح به لعدد القيود في طلب البحث هو 50.

ويتمّ أيضًا تخزين جميع السمات كسلاسل، وبالتالي فإنّ المقارنات الوحيدة المتاحة مع السمات هي مقارنات السلاسل. لإجراء مقارنة مع الأرقام أو القيم المنطقية، يجب وضع علامتَي اقتباس حول القيم صراحةً ليتم التعامل معها كسلسلتَين (على سبيل المثال، attributes.<key> = "10" أو attributes.<key> = "true").

object (Viewport)

اختياريّ. فلتر يحدّ من المركبات التي يتم عرضها عندما كان آخر موقع جغرافي معروف لها يقع في المنطقة المستطيلة التي حدّدها إطار العرض.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

مطلوب. نقطة أسفل إطار العرض.

object (LatLng)

مطلوب. تمثّل هذه السمة النقطة العليا لإطار العرض.