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 C.
• لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.

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 حرفًا كحد أقصى.
• تمت التسوية وفقًا لنموذج تسوية Unicode C.
• لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.

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 سمة مطلوبة. يتطابق ذلك مع الحد الأقصى لعدد السمات المسموح بها في المركبة. يجب أن تكون كل سلسلة متكررة بالتنسيق "key:value".

string

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

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 ويجب أن تتطابق المركبة مع جميع السمات في كل قائمة. هذا الحقل هو عملية ربط/و في كل عملية VehicleAttributeList وعملية فصل/أو عملية شاملة على مستوى مجموعة VehicleAttributeList. يجب أن تكون كل سلسلة متكررة بالتنسيق "key1:value1|key2:value2|key3:value3".

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

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

LatLng

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

string

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

Int32Value

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

Timestamp

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

Duration

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

RequestHeader

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

string

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

Trip

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

يتولى Fleet Engine الاحتفاظ بالحقول التالية. يُرجى عدم تعديلها باستخدام 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 هذه المعلومات لتحسين مشاركة الرحلة. ملاحظة: هذا الحقل مخصَّص فقط لاستخدام Driver SDK.

Timestamp

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

TripWaypoint

تمثّل هذه السمة النقطة المسارية التي ينتهي عندها current_route_segment. يمكن توفير ذلك من قِبل السائقين في مكالمات UpdateVehicle إما كنقطة طريق كاملة للرحلة أو نقطة وسيطة LatLng أو آخر LatLng من current_route_segment. وسيبذل Fleet Engine قصارى جهده للدمج في نقطة طريق فعلية إذا لم يتم تحديدها بشكل كامل. يتم تجاهل هذا الحقل في استدعاءات 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

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