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 حرفًا.
• تم تسويتها وفقًا لنموذج تسويتها في يونيكود (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
...)

تقييد الاستجابة على المركبات التي تحتوي على السمات المحدّدة هذا الحقل هو عملية ربط/AND. يُسمح بحد أقصى 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

نوع حلّ منتج GMP (مثل 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
...)

يحصر البحث بالمركبات التي تتضمّن السمات المحدّدة فقط. هذا الحقل هو عملية ربط/AND. يُسمح بحد أقصى 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 فقط. يجب أن تتطابق المركبة مع جميع السمات ضمن كل قائمة. هذا الحقل هو عملية ربط/AND في كل VehicleAttributeList وعملية نفي شامل/OR في مجموعة 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

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

string

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

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

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

TrafficPolylineData

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

الطلب المطلوب لترتيب مطابقات المركبات. هذا الرمز مكافئ للرمز ordered_by.

VehicleMatchOrder

الطلب المطلوب لترتيب مطابقات المركبات. هذا الرمز مكافئ للرمز requested_ordered_by.

RoadStretch

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

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

Style

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

int32

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

int32

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

LatLng

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

Timestamp

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