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. يجب أن تكون كل سلسلة متكررة بالتنسيق "key1:value1|key2:value2|key3:value3".

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)

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