Package maps.fleetengine.v1

BatteryStatus

حالة البطارية، سواء كانت مشحونة بالكامل أو قيد الشحن وما إلى ذلك

PowerSource

حالة مصدر طاقة البطارية

float

نسبة شحن البطارية الحالية [0-100].

SpeedReadingInterval

سرعة حركة المرور على طول المسار من نقطة المرور السابقة إلى نقطة المرور الحالية

string

المسار الذي يسلكه السائق من نقطة الطريق السابقة إلى نقطة الطريق الحالية. يتضمّن هذا المسار معالم حتى يتمكّن العملاء من عرض علامات حركة المرور على طول المسار (راجِع speed_reading_interval). لا تتوفّر ميزة فك التشفير بعد.

RequestHeader

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

string

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

string

مطلوب. معرّف الرحلة الفريد يخضع ذلك للقيود التالية:

• يجب أن تكون سلسلة Unicode صالحة.
• الحد الأقصى لعدد الأحرف هو 64 حرفًا.
• تم تسويتها وفقًا لنموذج تسويتها في يونيكود (Unicode Normalization Form C).
• يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.

Trip

مطلوب. كيان الرحلة المطلوب إنشائه.

عند إنشاء رحلة، تكون الحقول التالية مطلوبة:

• trip_type
• pickup_point

يتم استخدام الحقول التالية في حال تقديمها:

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

ويتم تجاهل جميع حقول الرحلة الأخرى. على سبيل المثال، تبدأ جميع الرحلات بقيمة trip_status من NEW حتى إذا أدخلت قيمة trip_status من CANCELED في طلب الإنشاء.

لا تتوفّر ميزة intermediate_destinations إلا في الرحلات التي تستغرق EXCLUSIVE فقط.

عند ضبط vehicle_id لرحلة مشتركة، يجب تقديم قائمة Trip.vehicle_waypoints لتحديد ترتيب نقاط الطريق المتبقية للمركبة، وإلا لن يكون ترتيب النقاط على الطريق غير محدَّد.

عند تحديد Trip.vehicle_waypoints، يجب أن تحتوي القائمة على جميع نقاط التوقف المتبقية لرحلات المركبة، بدون نقاط توقف إضافية. يجب ترتيب نقاط التوقف هذه بحيث تكون نقطة الاستلام قبل الوجهات الوسيطة في رحلة معيّنة، وتكون جميع الوجهات الوسيطة قبل نقطة الاستلام. يجب ألا تتداخل نقاط الطريق لرحلة EXCLUSIVE مع أي رحلات أخرى.

يتم استخدام الحقول trip_id وwaypoint_type وlocation، ويتم تجاهل جميع حقول TripWaypoint الأخرى في vehicle_waypoints.

RequestHeader

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

string

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

string

مطلوب. رقم تعريف المركبة الفريد يخضع ذلك للقيود التالية:

• يجب أن تكون سلسلة Unicode صالحة.
• الحد الأقصى لعدد الأحرف هو 64 حرفًا.
• تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
• يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.

Vehicle

مطلوب. كيان المركبة المطلوب إنشاؤه: عند إنشاء مركبة، تكون الحقول التالية مطلوبة:

• vehicleState
• supportedTripTypes
• maximumCapacity
• vehicleType

عند إنشاء مركبة، يتم تجاهل الحقول التالية:

• name
• currentTrips
• availableCapacity
• current_route_segment
• current_route_segment_end_point
• current_route_segment_version
• current_route_segment_traffic
• route
• waypoints
• waypoints_version
• remaining_distance_meters
• remaining_time_seconds
• eta_to_next_waypoint
• navigation_status

وجميع الحقول الأخرى اختيارية وتُستخدَم في حال توفيرها.

LocationPowerSaveMode

كيفية ضبط ميزات الموقع الجغرافي على الجهاز عند تفعيل ميزة "توفير شحن البطارية"

bool

ما إذا كان الجهاز في وضع توفير الطاقة حاليًا

bool

ما إذا كان الجهاز في حالة تفاعلية.

BatteryInfo

معلومات عن حالة البطارية

RequestHeader

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

string

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

TripView

مجموعة فرعية من حقول الرحلة التي يجب عرضها وتفسيرها

Timestamp

يشير إلى الحد الأدنى للطابع الزمني (حصريًا) الذي يتم استرداد بيانات Trip.route أو Trip.current_route_segment له. إذا لم تتغيّر بيانات المسار منذ الطابع الزمني هذا، لن يتم ضبط حقل المسار في الردّ. إذا لم يتم تحديد حدّ أدنى، يتم استرداد بيانات المسار دائمًا.

Timestamp

تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي تم استرداد Trip.remaining_waypoints له. وفي حال عدم تغيير هذه السمة منذ هذا الطابع الزمني، لن يتم ضبط remaining_waypoints في الردّ. في حال عدم تحديد هذا الحقل، يتم استرداد remaining_waypoints دائمًا.

PolylineFormatType

تنسيق المسار الحالي المعروض، LAT_LNG_LIST_TYPE (باللون Trip.route)، أو ENCODED_POLYLINE_TYPE (باللون Trip.current_route_segment). والقيمة التلقائية هي LAT_LNG_LIST_TYPE.

Timestamp

يشير إلى الحد الأدنى للطابع الزمني (الحصري) الذي يتم استرداد Trip.current_route_segment_traffic له. إذا لم تتغيّر بيانات الزيارات منذ هذا الطابع الزمني، لن يتم ضبط الحقل current_route_segment_traffic في الردّ. في حال عدم تحديد حدّ أدنى، يتم استرداد بيانات الزيارات دائمًا. تجدر الإشارة إلى أنّ الزيارات لا تتوفّر إلا لعملاء "حلول متعلقة بعمليات التسليم والرحلات عند الطلب".

Timestamp

تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي يتم استرداد بيانات Trip.remaining_waypoints.traffic_to_waypoint وTrip.remaining_waypoints.path_to_waypoint له. إذا لم تتغيّر البيانات منذ الطابع الزمني هذا، لن يتم ضبط الحقول أعلاه في الاستجابة. إذا لم يتم تحديد remaining_waypoints_route_version، يتم دائمًا استرداد حركة المرور والمسار.

RequestHeader

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

string

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

Timestamp

تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي تم استرداد قيمة Vehicle.current_route_segment له. إذا لم يتغيّر المسار منذ الطابع الزمني هذا، لن يتم ضبط الحقل current_route_segment في الردّ. إذا لم يتم تحديد حدّ أدنى، يتم استرداد current_route_segment دائمًا.

Timestamp

تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي يتم استرداد بيانات Vehicle.waypoints له. إذا لم تتغيّر نقاط التوقف منذ الطابع الزمني هذا، لن يتم ضبط بيانات vehicle.waypoints في الاستجابة. في حال عدم تحديد هذا الحقل، يتم استرداد vehicle.waypoints دائمًا.

string

مطلوب. رمز البلد أو المنطقة وفقًا لـ CLDR على سبيل المثال، US للولايات المتحدة أو IN للهند.

string

لا يتضمّن لوحة الترخيص الرقم الأخير أو الرقم "-1" للإشارة إلى عدم توفّر قيمة رقمية.

• "ABC 1234" -> "4"
• "AB 123 CD" -> "3"
• "ABCDEF -> "-1"

RequestHeader

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

string

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

int32

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

string

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

Int32Value

تحدّد هذه السمة الحدّ الأدنى المطلوب لسعة المركبة. سيكون لكل المركبات التي تم إرجاعها maximum_capacity أكبر من أو تساوي هذه القيمة. يجب أن تكون أكبر من أو تساوي 0 في حال ضبطها.

TripType

تقييد الاستجابة على المركبات التي تتيح استخدام نوع واحد على الأقل من أنواع الرحلات المحدّدة

Duration

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

Category

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

string

يمكن للمتصلين إنشاء عمليات منطقية معقّدة باستخدام أيّ مجموعة من الحقول required_attributes وrequired_one_of_attributes وrequired_one_of_attribute_sets.

required_attributes هي قائمة، ويستخدم required_one_of_attributes رسالة تتيح قائمة بالقوائم. يتيح الحقلان معًا إنشاء هذا التعبير:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

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

string

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

string

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

على غرار required_one_of_attributes، يستخدم required_one_of_attribute_sets رسالة تتيح قائمة قوائم، ما يسمح بالتعبيرات التالية مثلاً:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

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

VehicleState

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

bool

يجب إرجاع المركبات التي تتضمّن رحلات حالية فقط.

string

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

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

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

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

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

Viewport

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

Vehicle

المركبات التي تتطابق مع المعايير الواردة في الطلب يتم تحديد الحد الأقصى لعدد المركبات التي يتم عرضها من خلال حقل page_size في الطلب.

string

رمز مميّز لاسترداد الصفحة التالية من المركبات، أو فارغ إذا لم تعد هناك مركبات تستوفي معايير الطلب

int64

مطلوب. إجمالي عدد المركبات التي تتطابق مع معايير الطلب في جميع الصفحات

string

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

string

مطلوب. رمز البلد المؤلّف من حرفَين للبلد الذي تحدث فيه الرحلة. يتم تحديد السعر وفقًا لرمز البلد.

BillingPlatformIdentifier

المنصة التي تم إصدار الطلب عليها.

string

المعرّفات المرتبطة مباشرةً بالرحلة التي يتم الإبلاغ عنها وعادةً ما تكون هذه المعرّفات (مثل معرّفات الجلسات) لعمليات الحجز المُسبَق التي تم إجراؤها قبل توفّر معرّف الرحلة. الحد الأقصى لعدد related_ids هو 50.

SolutionType

تمثّل هذه السمة نوع حلّ "منصّة Google للتسويق" (على سبيل المثال، ON_DEMAND_RIDESHARING_AND_DELIVERIES) المستخدَم للرحلة التي تمّ الإبلاغ عنها.

string

تمثّل هذه السمة رمز اللغة BCP-47، مثل en-US أو sr-Latn. لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. إذا لم يتم تحديد أي لغة، قد يكون الرد بأي لغة، مع تفضيل اللغة الإنجليزية في حالة وجود مثل هذا الاسم. مثال على قيمة الحقل: en-US

string

مطلوب. رمز CLDR للمنطقة التي صدر فيها الطلب مثال على قيمة الحقل: US.

string

يشير إلى إصدار حزمة تطوير البرامج (SDK) للاتصال، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، مثال: 1.1.2.

string

يشير إلى إصدار نظام التشغيل الذي يتم تشغيل حزمة تطوير البرامج (SDK) للاتصال عليه. أمثلة على قيم الحقل: 4.4.1 و12.1

string

طراز الجهاز الذي يتم تشغيل حزمة تطوير البرامج (SDK) للاتصال عليه أمثلة على قيم الحقول: iPhone12,1 وSM-G920F

SdkType

نوع حزمة SDK التي ترسل الطلب

string

إصدار حزمة MapSDK التي تعتمد عليها حزمة SDK المُستخدَمة للاتصال، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، مثال: 5.2.1.

string

يشير إلى إصدار NavSDK الذي تعتمد عليه حزمة تطوير البرامج (SDK) للاتصال، إذا كان ذلك منطبقًا تنسيق الإصدار هو "major.minor.patch"، مثال: 2.1.0.

Platform

النظام الأساسي لحزمة تطوير البرامج (SDK) للاتصال

string

الشركة المصنّعة لجهاز Android من حزمة تطوير البرامج (SDK) للاتصال، ولا تنطبق إلا على حِزم تطوير البرامج (SDK) لنظام التشغيل Android. مثال على قيمة الحقل: Samsung

int32

مستوى واجهة برمجة تطبيقات Android لحزمة SDK التي تُجري الطلب، لا ينطبق إلا على حِزم SDK لنظام التشغيل Android. مثال على قيمة الحقل: 23

string

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

RequestHeader

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

string

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

string

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

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

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

int32

وإذا لم يتم ضبط السياسة، سيقرر الخادم عدد النتائج التي سيتم عرضها.

string

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

Duration

في حال تحديد وقت محدّد، يمكنك إرجاع الرحلات التي لم يتم تعديلها بعد الوقت (current - minimum_staleness).

Trip

تعرض هذه السمة قائمة الرحلات للمركبة المطلوبة.

string

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

RequestHeader

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

string

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

TerminalLocation

مطلوب. نقطة الاستلام التي تريد البحث بالقرب منها

TerminalLocation

الموقع الجغرافي المقصود لتسليم الطلب للعميل يكون الحقل مطلوبًا إذا كان trip_types يحتوي على TripType.SHARED.

int32

مطلوب. تحدد نصف قطر بحث المركبة حول نقطة الاستلام. وسيتم عرض المركبات الواقعة ضمن نصف قطر البحث فقط. يجب أن تتراوح القيمة بين 400 و10,000 متر (بما في ذلك).

int32

مطلوب. تُستخدَم لتحديد الحد الأقصى لعدد المركبات التي سيتم عرضها. يجب أن تتراوح القيمة بين 1 و50 (ضمنًا).

int32

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

TripType

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

Duration

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

VehicleType

مطلوب. يقصر البحث على المركبات من أحد الأنواع المحدّدة. يجب تحديد نوع مركبة واحد على الأقل. لا يُسمح بأنواع المركبات التي تحمل الفئة UNKNOWN.

VehicleAttribute

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

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

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

يحصر البحث بالمركبات التي تتضمّن السمات المحدّدة فقط. هذا الحقل هو عملية ربط/و. يُسمح بحد أقصى 50 سمة مطلوبة. يتطابق ذلك مع الحد الأقصى لعدد السمات المسموح بها في المركبة.

VehicleAttributeList

يحصر البحث في المركبات التي تتضمّن سمة واحدة على الأقل من السمات المحدّدة في كل VehicleAttributeList. ضمن كل قائمة، يجب أن تتطابق المركبة مع سمة واحدة على الأقل. هذا الحقل هو عملية نفي شامل/أو في كل VehicleAttributeList وعملية ربط/و في مجموعة VehicleAttributeList.

VehicleAttributeList

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

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

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

يحصر البحث في المركبات التي تتضمّن جميع السمات في VehicleAttributeList فقط. ويجب أن تتطابق المركبة مع جميع السمات في كل قائمة. هذا الحقل هو عملية ربط/و في كل عملية VehicleAttributeList وعملية فصل/أو عملية شاملة على مستوى مجموعة VehicleAttributeList.

VehicleMatchOrder

مطلوب. لتحديد معيار الترتيب المطلوب للنتائج.

bool

يشير ذلك إلى ما إذا كانت المركبات التي لديها رحلة نشطة واحدة مؤهّلة لهذا البحث. لا يتم استخدام هذا الحقل إلا عند عدم تحديد current_trips_present. في حال عدم تحديد الحقل "current_trips_present" وكان هذا الحقل هو false، يتم استبعاد المركبات التي تشمل رحلات محدّدة من نتائج البحث. في حال عدم تحديد قيمة السمة current_trips_present وكان هذا الحقل هو true، يمكن أن تتضمّن نتائج البحث مركبات تتضمّن رحلة واحدة نشطة بالحالة ENROUTE_TO_DROPOFF. عند تحديد current_trips_present، لا يمكن ضبط هذا الحقل على "صحيح".

تكون القيمة التلقائية false.

string

تشير هذه السمة إلى الرحلة المرتبطة بحدث SearchVehicleRequest هذا.

CurrentTripsPresent

يشير ذلك إلى ما إذا كانت المركبات التي تتضمن رحلات نشطة مؤهَّلة لعملية البحث هذه. يجب ضبط هذه السمة على قيمة أخرى غير CURRENT_TRIPS_PRESENT_UNSPECIFIED إذا كانت trip_type تتضمّن SHARED.

string

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

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

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

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

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

VehicleMatch

قائمة المركبات التي تستوفي معايير SearchVehiclesRequest، مرتّبة وفقًا للحقل SearchVehiclesRequest.order_by

int32

فهرس بداية هذا الفاصل الزمني في المسار في ملف JSON، عندما يكون الفهرس 0، سيظهر الحقل فارغًا.

int32

فهرس نهاية هذا الفاصل الزمني في المسار في ملف JSON، عندما يكون الفهرس 0، سيظهر الحقل فارغًا.

Speed

سرعة حركة المرور في هذا الفاصل الزمني

LatLng

مطلوب. تشير إلى الموقع الفعلي.

Timestamp

يشير هذا الحقل إلى وقت التوقف.

Timestamp

الإدخال فقط تمّ الإيقاف. استخدِم حقل الطابع الزمني.

LatLng

مطلوب. يشير إلى الموقع الجغرافي لنقطة مسار رحلة.

TerminalPointId

تم إيقاف هذا الحقل نهائيًا: حدِّد الحقل point بدلاً من ذلك.

string

تم إيقاف هذا الحقل نهائيًا: حدِّد الحقل point بدلاً من ذلك.

string

تمّ الإيقاف.

WaypointType

متوقّفة نهائيًا: سيتضمّن النطاق Vehicle.waypoint هذه البيانات.

string

تمّ الإيقاف.

string

تمّ الإيقاف.

string

تمّ الإيقاف.

VisualTrafficReportPolylineRendering

عرض خط متعدد الخطوط لسرعة حركة المرور في جميع المناطق على طول مسار واحد من رحلة أحد العملاء

string

النتائج فقط. بالتنسيق "providers/{provider}/trips/{trip}"

string

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

TripStatus

الحالة الحالية للرحلة

TripType

نوع الرحلة.

TerminalLocation

تشير إلى الموقع الجغرافي الذي يشير فيه العميل إلى أنّه سيتم استلام الطلب.

StopLocation

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

StopLocation

الإدخال فقط الوقت الفعلي والموقع الجغرافي لوصول السائق إلى نقطة الاستلام هذا الحقل مخصّص لمقدّم الخدمة ليقدّم ملاحظات حول معلومات الوصول الفعلية إلى نقطة الاستلام.

Timestamp

النتائج فقط. سواء الوقت المقدر في المستقبل الذي سيتم فيه نقل الركاب أو الوقت الفعلي الذي تم التقاطهم فيه.

TerminalLocation

محطّات متوسطة للتوقّف من أجل طلب الرحلات (بالإضافة إلى الاستلام والتوصيل) في البداية، لن تكون هذه الميزة متوفّرة للرحلات المشتركة.

Timestamp

يشير إلى آخر مرة تم فيها تعديل intermediate_destinations. من المفترض أن يخزّن الخادم هذه القيمة ويمرّرها في UpdateTripRequest عند تعديل intermediate_destination_index لضمان عدم تغيير intermediate_destinations.

int32

عندما تكون قيمة الحقل "TripStatus" هي ENROUTE_TO_INTERMEDIATE_DESTINATION، رقم بين [0..N-1] يشير إلى الوجهة المتوسطة التي ستتقاطعها المركبة بعد ذلك. عندما تكون قيمة الحقل "TripStatus" ARRIVED_AT_INTERMEDIATE_DESTINATION، رقم بين [0..N-1] يشير إلى الوجهة المتوسطة التي تصل إليها المركبة. يضبط الموفِّر هذه القيمة. في حال عدم توفّر intermediate_destinations، يتم تجاهل هذا الحقل.

StopLocation

الإدخال فقط الوقت الفعلي والموقع الجغرافي لوصول السائق إلى وجهة متوسطة. هذا الحقل مخصّص لموفّر الخدمة لتقديم ملاحظات حول معلومات الوصول الفعلية إلى الوجهات المتوسطة.

StopLocation

الإدخال فقط. الوقت والموقع الجغرافي الفعليان اللذان تم استلام العميل فيهما من وجهة وسيطة هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات حول معلومات الاستلام الفعلية في الوجهات الوسيطة.

TerminalLocation

الموقع الجغرافي الذي يشير إليه العميل بأنه سيتم إنزاله فيه

StopLocation

الإدخال فقط الوقت والموقع الجغرافي الفعليان اللذان تمّت فيها إعادة العميل إلى مكان إقامته. هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات حول معلومات إعادة العميل الفعلية.

Timestamp

النتائج فقط. إما الوقت المقدَّر في المستقبل الذي سيتم فيه إنزال الركّاب في الوجهة النهائية، أو الوقت الفعلي الذي تم فيه إنزالهم.

TripWaypoint

النتائج فقط. المسار الكامل من الموقع الجغرافي الحالي إلى نقطة الاستلام، شاملاً يمكن أن يتضمّن هذا المسار نقاط طريق من رحلات أخرى.

TripWaypoint

يتيح هذا الحقل ترتيب نقاط التوقف يدويًا للرحلة. يحتوي هذا الملف على جميع نقاط التوقف المتبقية للمركبة المحدّدة، بالإضافة إلى نقاط التوقف لتحميل الركاب وإيقافهم في هذه الرحلة. إذا لم يتمّ إسناد الرحلة إلى مركبة، سيتجاهل محرّك الأسطول هذا الحقل. لأسباب تتعلق بالخصوصية، لا تتم تعبئة هذا الحقل إلا من خلال الخادم في مكالمات UpdateTrip وCreateTrip، وليس في مكالمات GetTrip.

LatLng

النتائج فقط. المسار المتوقع لهذه الرحلة إلى أول إدخال في linked_waypoints. يُرجى العِلم أنّ نقطة الطريق الأولى قد تنتمي إلى رحلة مختلفة.

string

النتائج فقط. مسار مشفر إلى نقطة الطريق التالية.

ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. لا تتوفّر إمكانية فك الترميز بعد.

Timestamp

النتائج فقط. يشير إلى آخر مرة تم فيها تعديل المسار.

ملاحظة: هذا الحقل مخصّص فقط لاستخدام حِزم تطوير البرامج (SDK) الخاصة بالسائقين والمستهلكين.

ConsumableTrafficPolyline

النتائج فقط. تشير إلى حالة حركة المرور على طول current_route_segment عند توفّرها.

ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك.

Timestamp

النتائج فقط. يشير إلى آخر مرة تم فيها تعديل current_route_segment_traffic.

ملاحظة: هذا الحقل مخصّص فقط لاستخدام حِزم تطوير البرامج (SDK) الخاصة بالسائقين والمستهلكين.

TripWaypoint

النتائج فقط. نقطة الطريق التي تنتهي عندها current_route_segment

Int32Value

النتائج فقط. مسافة القيادة المتبقية في حقل current_route_segment. تكون القيمة غير محدّدة إذا لم يتم إسناد الرحلة إلى مركبة أو إذا اكتملت الرحلة أو تم إلغاؤها.

Timestamp

النتائج فقط. وقت الوصول المقدَّر إلى نقطة الطريق التالية (الإدخال الأول في حقل remaining_waypoints). لا يتم تحديد القيمة إذا لم تكن الرحلة مخصّصة لمركبة أو إذا كانت الرحلة غير نشطة (مكتملة أو ملغاة).

Duration

النتائج فقط. المدة التي تبدأ من وقت إرجاع بيانات الرحلة إلى الوقت في Trip.eta_to_first_waypoint. تكون القيمة غير محدّدة إذا لم يتم إسناد الرحلة إلى مركبة أو إذا كانت الرحلة غير نشطة (مكتمَلة أو مُلغاة).

Timestamp

النتائج فقط. تشير إلى آخر مرة تم فيها تغيير remaining_waypoints (تمت إضافة نقطة وسيطة أو إزالتها أو تغييرها).

Timestamp

النتائج فقط. يشير إلى آخر مرة تم فيها تعديل remaining_waypoints.path_to_waypoint وremaining_waypoints.traffic_to_waypoint. يجب أن يخزّن تطبيق العميل هذه القيمة مؤقتًا ويمررها في GetTripRequest لضمان عدم عرض المسارات والزيارات إلى remaining_waypoints إلا في حال تعديلها.

int32

غير قابل للتغيير يشير إلى عدد الركاب في هذه الرحلة ولا يشمل السائق. يجب أن تتوفّر سعة في المركبة ليتم إرجاعها في استجابة SearchVehicles.

VehicleLocation

النتائج فقط. يشير إلى آخر موقع تم الإبلاغ عنه للمركبة على طول المسار.

bool

النتائج فقط. يشير هذا الحقل إلى ما إذا كان من الممكن محاذاة last_location للمركبة في التوجيه current_route_segment. خطأ إذا لم يكن last_location أو current_route_segment متوفّرًا. ويتم احتسابها من خلال Fleet Engine. سيتم تجاهل أي تعديل من العملاء.

TripView

المجموعة الفرعية من حقول "الرحلة" التي تتم تعبئتها وكيفية تفسيرها.

TerminalLocation

موقع هذه النقطة.

string

الرحلة المرتبطة بنقطة الطريق هذه

WaypointType

الدور الذي تلعبه نقطة المرور هذه في هذه الرحلة، مثل نقطة الاستلام أو نقطة التسليم

LatLng

يشير ذلك المصطلح إلى المسار من نقطة الطريق السابقة إلى نقطة الطريق الحالية. غير محدّد للنقطة الطريق الأولى في القائمة. تتم تعبئة هذا الحقل عند طلبه فقط.

string

المسار المشفر من النقطة الوسيطة السابقة إلى النقطة الوسيطة الحالية.

ملاحظة: هذا الحقل مخصّص فقط لاستخدام حِزم تطوير البرامج (SDK) الخاصة بالسائقين والمستهلكين. لا تتوفّر إمكانية فك الترميز بعد.

ConsumableTrafficPolyline

أحوال حركة المرور على طول المسار إلى هذه النقطة يُرجى ملاحظة أنّ حركة المرور لا تتوفّر إلا لعملاء حلول الرحلات والتسليمات في "منصة خرائط Google".

Int32Value

المسافة بين المسار ونقطة الالتفاف السابقة ونقطة الالتفاف الحالية غير محدّد للنقطة الطريق الأولى في القائمة.

Timestamp

الوقت المقدَّر للوصول إلى هذه النقطة. غير محدّد لنقطة الطريق الأولى في قائمة.

Duration

مدة الرحلة من نقطة الطريق السابقة إلى هذه النقطة. غير محدّد لنقطة الطريق الأولى في قائمة.

RequestHeader

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

string

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

Trip

مطلوب. الرحلة المرتبطة بالتحديث.

يحافظ محرّك Fleet على الحقول التالية. يُرجى عدم تعديلها باستخدام Trip.update.

• current_route_segment
• current_route_segment_end_point
• current_route_segment_traffic
• current_route_segment_traffic_version
• current_route_segment_version
• dropoff_time
• eta_to_next_waypoint
• intermediate_destinations_version
• last_location
• name
• number_of_passengers
• pickup_time
• remaining_distance_meters
• remaining_time_to_first_waypoint
• remaining_waypoints
• remaining_waypoints_version
• route

عند تعديل Trip.vehicle_id لرحلة مشتركة، يجب تقديم قائمة Trip.vehicle_waypoints لتحديد ترتيب نقاط الطريق المتبقية، وإلّا فلن يتم تحديد الترتيب.

عند تحديد Trip.vehicle_waypoints، يجب أن تحتوي القائمة على جميع نقاط الطريق المتبقية لرحلات المركبة، بدون نقاط طريق إضافية. يجب ترتيب نقاط التوقف هذه بحيث تكون نقطة الاستلام قبل الوجهات الوسيطة في رحلة معيّنة، وتكون جميع الوجهات الوسيطة قبل نقطة الاستلام. يجب ألا تتداخل نقاط الطريق لرحلة EXCLUSIVE مع أي رحلات أخرى. ويتم استخدام الحقول trip_id وwaypoint_type وlocation، ويتم تجاهل جميع حقول TripWaypoint الأخرى في vehicle_waypoints.

لتجنّب حدوث تعارض في الرحلات التي تتضمّن وجهات متعددة، يجب تقديم Trip.intermediate_destinations_version عند تعديل حالة الرحلة إلى ENROUTE_TO_INTERMEDIATE_DESTINATION. يجب أن يكون Trip.intermediate_destinations_version الذي تم تمريره متوافقًا مع إصدار Fleet Engine. وإذا لم يكن الأمر كذلك، لن تنجح عملية إثبات الملكية.

FieldMask

مطلوب. قناع الحقل الذي يشير إلى الحقول التي يجب تعديلها في "الرحلة" يجب أن يحتوي update_mask على حقل واحد على الأقل.

RequestHeader

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

string

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

VehicleAttribute

مطلوب. سمات المركبة المطلوب تعديلها ولا يتم تعديل أو إزالة السمات غير المذكورة.

VehicleAttribute

مطلوب. القائمة الكاملة لسمات المركبات، بما في ذلك السمات الجديدة والمعدّلة والتي لم يتم تغييرها

RequestHeader

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

string

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

Vehicle

مطلوب. قيم عنصر Vehicle المطلوب تطبيقها عند تحديث Vehicle، قد لا يتم تعديل الحقول التالية لأنّها تتم إدارتها من قِبل الخادم.

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

في حال تعديل الحقل attributes، يتم استبدال جميع سمات المركبة بالسمات المقدَّمة في الطلب. إذا أردت تعديل بعض السمات فقط، اطّلِع على طريقة UpdateVehicleAttributes.

وبالمثل، يمكن تعديل الحقل waypoints، ولكن يجب أن يحتوي على جميع نقاط التوقف الحالية في المركبة، وليس أي نقاط توقف أخرى.

FieldMask

مطلوب. قناع حقل يشير إلى حقول Vehicle المطلوب تعديلها. يجب تقديم اسم حقل واحد على الأقل.

string

النتائج فقط. الاسم الفريد لهذه المركبة التنسيق هو providers/{provider}/vehicles/{vehicle}.

VehicleState

حالة المركبة.

TripType

أنواع الرحلات المتوافقة مع هذه المركبة

string

النتائج فقط. قائمة برحلات "trip_id" للرحلات المخصّصة حاليًا لهذه المركبة

VehicleLocation

آخر موقع جغرافي تم الإبلاغ عنه للمركبة

int32

تمثّل هذه السمة إجمالي عدد الركاب الذين يمكن أن تحملهم هذه المركبة. ولا يتم احتساب السائق في هذه القيمة. يجب أن تكون هذه القيمة أكبر من أو تساوي واحدًا.

VehicleAttribute

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

VehicleType

مطلوب. نوع هذه المركبة. يمكن استخدامها لفلترة المركبات في SearchVehicles نتائج. يؤثر أيضًا على الوقت المقدر للوصول وحساب المسار.

LicensePlate

معلومات لوحة ترخيص المركبة

TerminalLocation

متوقّفة نهائيًا: استخدِم Vehicle.waypoints بدلاً منها.

string

الخطوط المتعددة التي تحدد المسار الذي ينوي تطبيق السائق اتباعه إلى نقطة الطريق التالية. يتم أيضًا عرض هذه القائمة في Trip.current_route_segment لجميع الرحلات النشطة التي تم إسنادها إلى المركبة.

ملاحظة: هذا الحقل مخصَّص فقط لاستخدام Driver SDK. لا تتوفّر إمكانية فك الترميز بعد.

TrafficPolylineData

الإدخال فقط. يستخدم Fleet Engine هذه المعلومات لتحسين مشاركة الرحلة. ملاحظة: هذا الحقل مخصّص لاستخدام حزمة تطوير البرامج (SDK) الخاصة بالسائق فقط.

Timestamp

النتائج فقط. الوقت الذي تم فيه ضبط current_route_segment ويمكن للعميل تخزينه وإرساله في طلبات GetVehicle المستقبلية لمنع عرض المسارات التي لم تتغيّر.

TripWaypoint

تمثّل هذه السمة النقطة المسارية التي ينتهي عندها current_route_segment. يمكن توفير ذلك من قِبل السائقين في مكالمات UpdateVehicle إما كنقطة طريق كاملة للرحلة أو نقطة وسيطة LatLng أو آخر LatLng من current_route_segment. سيبذل محرّك الأسطول قصارى جهده لإجراء عملية الاستقراء إلى نقطة مرجعية فعلية إذا لم يتم تحديدها بالكامل. يتم تجاهل هذا الحقل في طلبات UpdateVehicle ما لم يتم تحديد current_route_segment أيضًا.

Int32Value

مسافة القيادة المتبقية لـ current_route_segment. يتم عرض هذه القيمة أيضًا بعملة Trip.remaining_distance_meters لجميع الرحلات النشطة التي تم إسنادها إلى المركبة. تكون القيمة غير محدّدة إذا كان حقل current_route_segment فارغًا.

Timestamp

الوقت المقدّر للوصول إلى الإدخال الأول في الحقل waypoints. تكون القيمة غير محدّدة إذا كان حقل waypoints فارغًا أو كان حقل Vehicle.current_route_segment فارغًا.

عند تعديل مركبة، تكون الأولوية للسمة remaining_time_seconds على eta_to_first_waypoint في الطلب نفسه.

Int32Value

الإدخال فقط مدة القيادة المتبقية للمسار current_route_segment تكون القيمة غير محدّدة إذا كان حقل waypoints فارغًا أو كان حقل Vehicle.current_route_segment فارغًا. يجب أن تتطابق هذه القيمة مع eta_to_first_waypoint - current_time إذا كانت جميع الأطراف تستخدم الساعة نفسها.

عند تعديل مركبة، تكون الأولوية للسمة remaining_time_seconds على eta_to_first_waypoint في الطلب نفسه.

TripWaypoint

نقاط التوقف المتبقية التي تم تعيينها لهذه المركبة

Timestamp

النتائج فقط. آخر مرة تم فيها تعديل الحقل waypoints على العملاء تخزين هذه القيمة مؤقتًا ونقلها في GetVehicleRequest لضمان عدم عرض الحقل waypoints إلا إذا تم تعديله.

bool

تشير إلى ما إذا كان السائق يقبل الرحلات المتتالية. إذا كانت true، قد تشمل SearchVehicles المركبة حتى إذا كانت مخصصة حاليًا لرحلة. القيمة التلقائية هي false.

NavigationStatus

حالة التنقّل في المركبة

DeviceSettings

الإدخال فقط. معلومات حول الإعدادات في الجهاز الجوّال الذي يستخدمه السائق.

Category

فئة نوع المركبة

string

مفتاح السمة لا يجوز أن تحتوي المفاتيح على علامة النقطتين (:).

string

قيمة السمة.

string

قيمة السمة المكتوبة بالسلسلة

ملاحظة: هذا مماثل للحقل value الذي سيتم إيقافه نهائيًا في النهاية. بالنسبة إلى طرق الإنشاء أو التعديل، يمكن استخدام أي من الحقلَين، ولكن يُنصح بشدة باستخدام string_value. في حال ضبط كلّ من string_value وvalue، يجب أن يكونا متطابقَين وإلا سيظهر خطأ. تتم تعبئة كلا الحقلين في الردود.

bool

قيمة السمة المكتوبة بطريقة منطقية

double

قيمة سمة من نوعين

VehicleAttribute

قائمة بالسمات في هذه المجموعة

LatLng

الموقع الجغرافي للمركبة عند إرسالها إلى Fleet Engine، يكون الموقع الجغرافي للمركبة هو موقع جغرافي وفقًا لنظام تحديد المواقع العالمي (GPS). عند تلقّيه في ردّ، يمكن أن يكون الموقع الجغرافي للمركبة هو موقع نظام تحديد المواقع العالمي (GPS) أو موقع جغرافي إضافي أو موقع جغرافي آخر مقدَّر. يتم تحديد المصدر في location_sensor.

DoubleValue

متوقّفة نهائيًا: استخدِم latlng_accuracy بدلاً منها.

DoubleValue

دقة location بالأمتار كنصف قطري.

Int32Value

اتجاه حركة المركبة بالدرجات يمثّل الرقم 0 الاتجاه الشمالي. النطاق الصالح هو [0,360).

DoubleValue

متوقّفة نهائيًا: استخدِم heading_accuracy بدلاً منها.

DoubleValue

دقة heading درجة

DoubleValue

الارتفاع بالمتر فوق WGS84

DoubleValue

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام altitude_accuracy بدلاً منها.

DoubleValue

دقة altitude بالمتر

Int32Value

سرعة المركبة بالكيلومترات في الساعة متوقّفة نهائيًا: استخدِم speed بدلاً منها.

DoubleValue

سرعة المركبة بالمتر/الثانية

DoubleValue

دقة speed بمتر/ثانية.

Timestamp

الوقت الذي أبلغَت فيه أداة الاستشعار عن location وفقًا لساعة أداة الاستشعار

Timestamp

النتائج فقط. الوقت الذي تلقّى فيه الخادم معلومات الموقع الجغرافي.

LocationSensor

موفِّر بيانات الموقع الجغرافي (على سبيل المثال، GPS).

BoolValue

ما إذا كان location قد تمّ ربطه بطريق

BoolValue

الإدخال فقط. يشير إلى ما إذا كانت أداة استشعار نظام تحديد المواقع العالمي (GPS) مُفعَّلة على الجهاز الجوّال.

Int32Value

الإدخال فقط الوقت (بالثواني) منذ إرسال هذا الموقع الجغرافي لأول مرة إلى الخادم سيكون هذا الرقم صفرًا في التعديل الأول. إذا كان الوقت غير معروف (على سبيل المثال، عند إعادة تشغيل التطبيق)، تتم إعادة ضبط هذه القيمة على القيمة صفر.

Int32Value

الإدخال فقط. متوقّف: يتم الآن استخدام إشارات أخرى لتحديد ما إذا كان الموقع قديمًا أم لا.

LatLng

الموقع الجغرافي للمركبة الأولي (لا تتم معالجته بواسطة قاذف الطريق)

Timestamp

الطابع الزمني المرتبط بالموقع الجغرافي الأوّلي

LocationSensor

مصدر الموقع الجغرافي الأوّلي وتكون القيمة التلقائية هي GPS.

DoubleValue

دقة raw_location كنطاق جغرافي، بالمتر

LatLng

الموقع التكميلي الذي يوفره التطبيق المدمج

Timestamp

الطابع الزمني المرتبط بالموقع الجغرافي التكميلي

LocationSensor

مصدر الموقع الجغرافي الإضافي الإعداد التلقائي هو CUSTOMER_SUPPLIED_LOCATION.

DoubleValue

دقة supplemental_location كنصف قطر، بالمتر

bool

متوقّفة نهائيًا: استخدِم is_road_snapped بدلاً منها.

Vehicle

مطلوب. مركبة تتطابق مع الطلب

Timestamp

وقت الوصول المقدَّر للمركبة بالقيادة إلى نقطة الاستلام المحدّدة في الطلب. تشير القيمة الفارغة إلى تعذُّر احتساب وقت الوصول المقدَّر للمركبة. إذا كانت قيمة SearchVehiclesRequest.include_back_to_back هي true وكانت هذه المركبة تقدّم رحلة نشطة، تشمل السمة vehicle_pickup_eta الوقت المطلوب لإكمال الرحلة النشطة الحالية.

Int32Value

المسافة من الموقع الجغرافي الحالي للمركبة إلى نقطة الاستلام المحدّدة في الطلب، بما في ذلك أي نقاط متوسطة للاستلام أو التسليم للرحلات الحالية تتألف هذه المسافة من المسافة المحسوبة للقيادة (المسار) بالإضافة إلى المسافة المستقيمة بين نقطة نهاية التنقّل ونقطة الاستلام المطلوبة. (تكون المسافة بين نقطة نهاية التنقّل ونقطة الاستلام المطلوبة عادةً صغيرة.) تشير القيمة الفارغة إلى وجود خطأ في حساب المسافة.

Int32Value

مطلوب. المسافة المستقيمة بين المركبة ونقطة الاستلام المحدّدة في الطلب

Timestamp

الوقت المقدَّر لقيادة المركبة بالكامل عند الوصول إلى نقطة التسليم المحدّدة في الطلب يتضمّن وقت الوصول المقدَّر التوقف في أي نقاط طريق قبل dropoff_point المحدَّدة في الطلب. لن تتم تعبئة القيمة إلا عند تحديد نقطة تسليم في الطلب. تشير القيمة الفارغة إلى خطأ في احتساب وقت الوصول المقدَّر.

Int32Value

المسافة القيادة للمركبة (بالأمتار) من نقطة الاستلام إلى نقطة التسليم المحدّدة في الطلب المسافة هي بين النقطتَين فقط ولا تشمل الموقع الجغرافي للمركبة أو أي نقاط أخرى يجب زيارتها قبل وصول المركبة إلى نقطة الاستلام أو نقطة التسليم. لن تتم تعبئة القيمة إلا عند تحديد dropoff_point في الطلب. تشير القيمة الفارغة إلى تعذُّر احتساب المسافة من نقطة الاستلام إلى نقطة التسليم المحدّدة في الطلب.

TripType

مطلوب. نوع رحلة الطلب الذي تم استخدامه لاحتساب الوقت المقدّر للوصول إلى نقطة الاستلام

Waypoint

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

VehicleMatchType

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

VehicleMatchOrder

تمثّل هذه السمة الطلب الذي تم طلبه لترتيب المركبات المتطابقة.

VehicleMatchOrder

الطلب الفعلي الذي تم استخدامه لهذه المركبة. سيتطابق هذا عادةً مع الحقل order_by من الطلب، ولكن في حالات معيّنة، مثل حدوث خطأ داخلي في الخادم، قد يتم استخدام طريقة مختلفة (مثل PICKUP_POINT_STRAIGHT_DISTANCE).

RoadStretch

اختياريّ. أجزاء الطريق التي يجب عرضها على طول الخط المتعدّد نضمن لك أنّ المقاطع لن تتداخل مع بعضها، ولن تمتد بالضرورة على طول المسار بالكامل.

في حال عدم توفّر جزء من الطريق لتطبيق النمط عليه، على العميل تطبيق النمط التلقائي على المسار.

Style

مطلوب. النمط المطلوب تطبيقه.

int32

مطلوب. يجب تطبيق النمط بين [offset_meters, offset_meters + length_meters).

int32

مطلوب. طول المسار الذي سيتم تطبيق النمط عليه.

LatLng

الموقع الجغرافي لنقطة الطريق هذه.

Timestamp

الوقت المقدَّر لوصول المركبة إلى هذه النقطة.