Package maps.fleetengine.v1

الفهرس

TripService

خدمة إدارة الرحلات

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

ينشئ رحلة في Fleet Engine ويعرض الرحلة الجديدة.

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

الحصول على معلومات عن رحلة واحدة

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

الإبلاغ عن استخدام الرحلة القابلة للفوترة

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

يمكنك الاطّلاع على جميع الرحلات لمركبة معيّنة.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

تعدّل بيانات الرحلة.

VehicleService

خدمة إدارة المركبات:

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

ينشئ مثيلاً لمركبة جديدة مرتبطة بمقدّم خدمة مشاركة الرحلات أو خدمات التسليم عند الطلب. يجب أن يكون لكل Vehicle معرّف مركبة فريد.

يجب ملء حقول Vehicle التالية عند إنشاء Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

يتم تجاهل حقول Vehicle التالية عند إنشاء Vehicle:

  • 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

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

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

لعرض مركبة من Fleet Engine.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

تعرض قائمة مقسّمة للمركبات المرتبطة بمقدّم خدمة يطابق خيارات الطلب.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

تعرض قائمة بالمركبات التي تتطابق مع خيارات الطلب.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

كتابة بيانات المركبة المعدّلة في Fleet Engine

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

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

يتعذّر أيضًا تحديث المركبة name.

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

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

يتم تعديل سمات المركبة جزئيًا. سيتم تعديل السمات المذكورة في الطلب فقط، ولن يتم تغيير السمات الأخرى. ملاحظة: تختلف هذه القاعدة في UpdateVehicle، إذ سيتم استبدال الحقل attributes بالكامل بالحقل في UpdateVehicleRequest، وستتم إزالة السمات غير المضمّنة في الطلب.

BatteryInfo

معلومات حول بطارية الجهاز

الحقول
battery_status

BatteryStatus

حالة البطارية، سواء كانت ممتلئة أو مشحونة وغير ذلك

power_source

PowerSource

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

battery_percentage

float

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

BatteryStatus

حالة البطارية، سواء كانت ممتلئة أو مشحونة وغير ذلك

عمليات التعداد
UNKNOWN_BATTERY_STATUS حالة البطارية غير معروفة.
BATTERY_STATUS_CHARGING يتم شحن البطارية.
BATTERY_STATUS_DISCHARGING يتم تفريغ شحن البطارية.
BATTERY_STATUS_FULL البطارية ممتلئة.
BATTERY_STATUS_NOT_CHARGING البطارية لا تشحن.
BATTERY_STATUS_POWER_LOW طاقة البطارية منخفضة.

BillingPlatformIdentifier

مجموعة من القيم التي تشير إلى المنصّة التي تم إصدار الطلب عليها.

عمليات التعداد
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED تلقائي: تُستخدَم مع أنظمة أساسية غير محدّدة.
SERVER المنصة هي خادم عميل.
WEB المنصة هي متصفح ويب.
ANDROID النظام الأساسي هو جهاز جوّال Android.
IOS إن النظام الأساسي هو جهاز جوّال يعمل بنظام التشغيل iOS.
OTHERS الأنظمة الأساسية الأخرى غير المُدرَجة في هذا التعداد

ConsumableTrafficPolyline

كثافة حركة المرور على طول مسار المركبة

الحقول
speed_reading_interval[]

SpeedReadingInterval

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

encoded_path_to_waypoint

string

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

CreateTripRequest

إنشاء رسالة طلب الرحلة

الحقول
header

RequestHeader

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

parent

string

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

trip_id

string

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

  • يجب أن تكون سلسلة Unicode صالحة.
  • لا يتجاوز عدد الأحرف 64 حرفًا كحد أقصى.
  • تمت التسوية وفقًا لنموذج تسوية Unicode C.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
trip

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.

CreateVehicleRequest

رسالة طلب CreateVehicle.

الحقول
header

RequestHeader

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

parent

string

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

vehicle_id

string

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

  • يجب أن تكون سلسلة Unicode صالحة.
  • لا يتجاوز عدد الأحرف 64 حرفًا كحد أقصى.
  • تمت التسوية وفقًا لنموذج تسوية Unicode C.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
vehicle

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

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

DeviceSettings

معلومات حول الإعدادات المختلفة على الجهاز الجوّال.

الحقول
location_power_save_mode

LocationPowerSaveMode

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

is_power_save_mode

bool

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

is_interactive

bool

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

battery_info

BatteryInfo

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

GetTripRequest

رسالة طلب GetTrip.

الحقول
header

RequestHeader

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

name

string

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

view

TripView

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

current_route_segment_version

Timestamp

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

remaining_waypoints_version

Timestamp

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

route_format_type

PolylineFormatType

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

current_route_segment_traffic_version

Timestamp

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

remaining_waypoints_route_version

Timestamp

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

GetVehicleRequest

رسالة طلب GetVehicle.

الحقول
header

RequestHeader

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

name

string

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

current_route_segment_version

Timestamp

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

waypoints_version

Timestamp

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

LicensePlate

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

الحقول
country_code

string

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

last_character

string

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

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

ListVehiclesRequest

رسالة طلب ListVehicles.

الحقول
header

RequestHeader

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

parent

string

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

page_size

int32

تمثّل هذه السمة الحدّ الأقصى لعدد المركبات المطلوب إرجاعها. القيمة التلقائية: 100.

page_token

string

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

minimum_capacity

Int32Value

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

trip_types[]

TripType

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

maximum_staleness

Duration

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

vehicle_type_categories[]

Category

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

required_attributes[]

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".

required_one_of_attributes[]

string

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

required_one_of_attribute_sets[]

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".

vehicle_state

VehicleState

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

on_trip_only

bool

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

filter

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

Viewport

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

ListVehiclesResponse

رسالة رد واحدة (ListVehicles).

الحقول
vehicles[]

Vehicle

المركبات التي تتطابق مع المعايير الواردة في الطلب يحدّد الحقل page_size في الطلب الحد الأقصى لعدد المركبات التي تم إرجاعها.

next_page_token

string

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

total_size

int64

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

LocationPowerSaveMode

كيفية ضبط ميزات الموقع الجغرافي لتعمل على الجهاز الجوّال عند تفعيل ميزة "توفير شحن البطارية" في الأجهزة الميزة مفعّلة. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

عمليات التعداد
UNKNOWN_LOCATION_POWER_SAVE_MODE موضع حفظ PowerSaveMode (موقع جغرافي) غير محدّد
LOCATION_MODE_NO_CHANGE يجب ألا يتأثر موفرو المواقع الجغرافية بميزة "توفير شحن البطارية" أو أن هذه الميزة غير مفعّلة.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF يجب إيقاف موفّر الموقع الجغرافي المستند إلى نظام تحديد المواقع العالمي (GPS) عند تفعيل ميزة "توفير شحن البطارية" وعندما يكون الجهاز غير تفاعلي.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF يجب إيقاف جميع موفري المواقع الجغرافية عندما تكون ميزة "توفير شحن البطارية" مفعَّلة ويكون الجهاز غير تفاعلي.
LOCATION_MODE_FOREGROUND_ONLY ستتم إتاحة جميع موفري المواقع الجغرافية، ولكن يجب تقديم إصلاحات الموقع الجغرافي فقط للتطبيقات التي تعمل في المقدّمة.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF لن يتم إيقاف خدمة الموقع الجغرافي، ولكن سيقلل "مدير الموقع الجغرافي" جميع الطلبات المُرسَلة إلى مقدّمي الخدمات عندما يكون الجهاز غير تفاعلي.

LocationSensor

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

عمليات التعداد
UNKNOWN_SENSOR أداة الاستشعار غير محدّدة أو غير معروفة.
GPS نظام تحديد المواقع العالمي (GPS) أو نظام تحديد المواقع العالمي (GPS) المدعوم.
NETWORK نظام GPS مدعوم أو معرف برج الاتصالات أو نقطة وصول Wi-Fi.
PASSIVE معرّف برج الاتصالات أو نقطة وصول WiFi.
ROAD_SNAPPED_LOCATION_PROVIDER موقع يحدده الجهاز الجوّال ليكون موقع الطريق الأكثر احتمالاً.
CUSTOMER_SUPPLIED_LOCATION موقع جغرافي يوفّره العميل من مصدر مستقل. يتم عادةً استخدام هذه القيمة للموقع الجغرافي الذي يتم تقديمه من مصادر أخرى غير الجهاز الجوّال الذي يشغل حزمة SDK لبرنامج التشغيل. إذا تم وصف المصدر الأصلي بإحدى قيم التعداد الأخرى، استخدِم تلك القيمة. المواقع الجغرافية المميزة بعلامة CUSTOMER_SUPPLIED_LOCATION يتم تقديمها عادةً عبر last_location.supplemental_location_sensor للمركبة.
FLEET_ENGINE_LOCATION موقع جغرافي احتسبه Fleet Engine استنادًا إلى الإشارات المتاحة له. النتائج فقط. سيتم رفض هذه القيمة في حال تلقّيها في طلب.
FUSED_LOCATION_PROVIDER مزوّد الموقع الجغرافي المدمج في Android
CORE_LOCATION مقدم الموقع على أنظمة التشغيل Apple.

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

عمليات التعداد
UNKNOWN_NAVIGATION_STATUS حالة التنقّل غير محدّدة.
NO_GUIDANCE التنقّل في تطبيق السائق في وضع FREE_NAV.
ENROUTE_TO_DESTINATION تتوفّر اتّجاهات مفصّلة، وقد دخل التنقّل في تطبيق "السائق" في وضع GUIDED_NAV.
OFF_ROUTE انحرفت المركبة عن المسار المقترح.
ARRIVED_AT_DESTINATION تبعد المركبة عن الوجهة بمسافة 50 مترًا تقريبًا.

PolylineFormatType

نوع تنسيق الخطوط المتعددة.

عمليات التعداد
UNKNOWN_FORMAT_TYPE التنسيق غير محدد أو غير معروف.
LAT_LNG_LIST_TYPE هذه قائمة بـ google.type.LatLng.
ENCODED_POLYLINE_TYPE يشير ذلك المصطلح إلى مخطط متعدد الخطوط تم ترميزه باستخدام خوارزمية ضغط الخطوط المتعددة. لا تتوفّر إمكانية فك الترميز بعد.

PowerSource

نوع الشاحن المستخدَم لشحن البطارية

عمليات التعداد
UNKNOWN_POWER_SOURCE مصدر الطاقة غير معروف.
POWER_SOURCE_AC مصدر الطاقة هو شاحن AC.
POWER_SOURCE_USB مصدر الطاقة هو منفذ USB.
POWER_SOURCE_WIRELESS مصدر الطاقة لاسلكي.
POWER_SOURCE_UNPLUGGED البطارية غير متصلة.

ReportBillableTripRequest

رسالة طلب ReportableTrip

الحقول
name

string

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

country_code

string

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

platform

BillingPlatformIdentifier

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

related_ids[]

string

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

solution_type

SolutionType

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

SolutionType

أداة اختيار أنواع الحلول المختلفة لرحلة تم الإبلاغ عنها

عمليات التعداد
SOLUTION_TYPE_UNSPECIFIED القيمة التلقائية. بالنسبة إلى التوافق مع الأنظمة القديمة، ستستخدم واجهة برمجة التطبيقات ON_DEMAND_RIDESHARING_AND_DELIVERIES تلقائيًا، وهو أول نوع من الحلول المتوافقة.
ON_DEMAND_RIDESHARING_AND_DELIVERIES الحل هو رحلة مشاركة الرحلات والتوصيل عند الطلب.

RequestHeader

يحتوي حقل RequestHeader على حقول شائعة لجميع طلبات استدعاء إجراء عن بُعد من خلال Fleet Engine.

الحقول
language_code

string

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

region_code

string

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

sdk_version

string

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

os_version

string

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

device_model

string

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

sdk_type

SdkType

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

maps_sdk_version

string

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

nav_sdk_version

string

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

platform

Platform

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

manufacturer

string

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

android_api_level

int32

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

trace_id

string

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

النظام الأساسي

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

عمليات التعداد
PLATFORM_UNSPECIFIED القيمة التلقائية. يتم استخدام هذه القيمة في حال إسقاط المنصة.
ANDROID تم إرسال الطلب من Android.
IOS تم إرسال الطلب من جهاز iOS.
WEB تم إرسال الطلب من الويب.

SdkType

الأنواع المحتملة لحِزم SDK.

عمليات التعداد
SDK_TYPE_UNSPECIFIED القيمة التلقائية. ويتم استخدام هذه القيمة في حال إسقاط sdk_type.
CONSUMER حزمة SDK للاتصال هي المستهلك.
DRIVER حزمة SDK للاتصال هي برنامج التشغيل.
JAVASCRIPT حزمة تطوير البرامج (SDK) للاتصال هي JavaScript.

SearchTripsRequest

رسالة طلب SearchTrips

الحقول
header

RequestHeader

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

parent

string

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

vehicle_id

string

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

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

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

page_size

int32

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

page_token

string

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

minimum_staleness

Duration

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

SearchTripsResponse

رسالة رد SearchTrips.

الحقول
trips[]

Trip

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

next_page_token

string

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

SearchVehiclesRequest

رسالة طلب SearchVehicles.

الحقول
header

RequestHeader

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

parent

string

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

pickup_point

TerminalLocation

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

dropoff_point

TerminalLocation

مكان التسليم الذي اختاره العميل يجب ملء هذا الحقل إذا كان trip_types يحتوي على TripType.SHARED.

pickup_radius_meters

int32

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

count

int32

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

minimum_capacity

int32

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

trip_types[]

TripType

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

maximum_staleness

Duration

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

vehicle_types[]

VehicleType

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

required_attributes[]

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

required_one_of_attributes[]

VehicleAttributeList

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

required_one_of_attribute_sets[]

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.

order_by

VehicleMatchOrder

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

include_back_to_back

bool

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

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

trip_id

string

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

current_trips_present

CurrentTripsPresent

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

filter

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").

CurrentTripsPresent

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

عمليات التعداد
CURRENT_TRIPS_PRESENT_UNSPECIFIED يخضع توفّر المركبات التي تشمل رحلات للحقل "include_back_to_back".
NONE يمكن أن تظهر المركبات التي لا تتضمّن رحلات في نتائج البحث. عند استخدام هذه القيمة، لا يمكن أن يكون include_back_to_back true.
ANY يتم تضمين المركبات التي تشمل 5 رحلات حالية و10 نقاط مسار كحد أقصى في نتائج البحث. عند استخدام هذه القيمة، لا يمكن أن يكون include_back_to_back true.

VehicleMatchOrder

تُستخدَم لتحديد ترتيب مطابقة المركبة في الردّ.

عمليات التعداد
UNKNOWN_VEHICLE_MATCH_ORDER الخيار التلقائي، يُستخدم لتطابق مركبة غير محدّدة أو غير معروفة مع الطلب.
PICKUP_POINT_ETA ترتيب تصاعدي حسب وقت قيادة المركبة إلى نقطة الاستلام
PICKUP_POINT_DISTANCE ترتيب تصاعدي حسب المسافة التي تقودها المركبة إلى نقطة الاستلام
DROPOFF_POINT_ETA ترتيب تصاعدي حسب مدة قيادة المركبة إلى نقطة التسليم. لا يمكن استخدام هذا الطلب إلا إذا تم تحديد نقطة التسليم في الطلب.
PICKUP_POINT_STRAIGHT_DISTANCE ترتيب تصاعدي حسب مسافة خط مستقيم من آخر موقع جغرافي للمركبة تم الإبلاغ عنه إلى نقطة الاستلام
COST ترتيب تصاعدي حسب تكلفة المطابقة التي تم ضبطها. تُعرف تكلفة المطابقة بأنها عملية حسابية مُرجحة بين مسافة الخط المستقيم والوقت المقدر للوصول. يتم تحديد القيم التقديرية بالقيم التلقائية ويمكن تعديلها لكل عميل. يُرجى التواصل مع فريق الدعم في Google إذا احتجت إلى تعديل هذه القيم التقديرية لمشروعك.

SearchVehiclesResponse

رسالة رد واحدة (SearchVehicles).

الحقول
matches[]

VehicleMatch

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

SpeedReadingInterval

مؤشر كثافة حركة المرور على جزء متجاورة من المسار. بالنظر إلى مسار يحتوي على النقاط P_0 وP_1 و... أو P_N (فهرس يستند إلى صفر)، تحدد SpeedReadingInterval الفاصل الزمني وتصف عدد الزيارات باستخدام الفئات التالية.

الحقول
start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

speed

Speed

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

السرعة

يشير ذلك المصطلح إلى تصنيف سرعة الخطوط المتعددة استنادًا إلى بيانات حركة المرور.

عمليات التعداد
SPEED_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدمة.
NORMAL تم رصد سرعة عادية، ولم يتم رصد أي حركة بطيئة.
SLOW تم رصد حركة بطيئة، ولكن لم يحدث ازدحام مروري.
TRAFFIC_JAM تم رصد ازدحام مروري.

StopLocation

الموقع الجغرافي الفعلي الذي وقعت فيه المحطة (الاستلام/التسليم).

الحقول
point

LatLng

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

timestamp

Timestamp

يشير إلى وقت حدوث التوقّف.

stop_time
(deprecated)

Timestamp

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

TerminalLocation

تصف موقع نقطة وسيطة.

الحقول
point

LatLng

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

terminal_point_id
(deprecated)

TerminalPointId

مهمل: حدِّد الحقل point بدلاً منه.

access_point_id
(deprecated)

string

مهمل: حدِّد الحقل point بدلاً منه.

trip_id
(deprecated)

string

تمّ الإيقاف.

terminal_location_type
(deprecated)

WaypointType

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

TerminalPointId

متوقّفة نهائيًا: لم تعُد TerminalPoints متاحة في Fleet Engine. يمكنك استخدام TerminalLocation.point كبديل.

الحقول
value
(deprecated)

string

تمّ الإيقاف.

حقل الاتحاد Id. تمّ الإيقاف. يمكن أن يكون Id واحدًا فقط مما يلي:
place_id
(deprecated)

string

تمّ الإيقاف.

generated_id
(deprecated)

string

تمّ الإيقاف.

TrafficPolylineData

أحوال حركة المرور على طول مسار المركبة المتوقّع

الحقول
traffic_rendering

VisualTrafficReportPolylineRendering

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

الرحلة

البيانات الوصفية للرحلة

الحقول
name

string

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

vehicle_id

string

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

trip_status

TripStatus

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

trip_type

TripType

نوع الرحلة.

pickup_point

TerminalLocation

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

actual_pickup_point

StopLocation

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

actual_pickup_arrival_point

StopLocation

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

pickup_time

Timestamp

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

intermediate_destinations[]

TerminalLocation

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

intermediate_destinations_version

Timestamp

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

intermediate_destination_index

int32

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

actual_intermediate_destination_arrival_points[]

StopLocation

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

actual_intermediate_destinations[]

StopLocation

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

dropoff_point

TerminalLocation

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

actual_dropoff_point

StopLocation

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

dropoff_time

Timestamp

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

remaining_waypoints[]

TripWaypoint

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

vehicle_waypoints[]

TripWaypoint

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

route[]

LatLng

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

current_route_segment

string

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

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

current_route_segment_version

Timestamp

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

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

current_route_segment_traffic

ConsumableTrafficPolyline

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

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

current_route_segment_traffic_version

Timestamp

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

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

current_route_segment_end_point

TripWaypoint

النتائج فقط. تمثّل هذه السمة النقطة المسارية التي ينتهي عندها current_route_segment.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

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

remaining_time_to_first_waypoint

Duration

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

remaining_waypoints_version

Timestamp

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

remaining_waypoints_route_version

Timestamp

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

number_of_passengers

int32

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

last_location

VehicleLocation

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

last_location_snappable

bool

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

view

TripView

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

TripStatus

حالة رحلة تشير إلى تقدمها.

عمليات التعداد
UNKNOWN_TRIP_STATUS تلقائي، يُستخدم لحالة الرحلة غير المحدّدة أو غير المعروفة.
NEW رحلة تم إنشاؤها حديثًا
ENROUTE_TO_PICKUP السائق في طريقه إلى نقطة الاستلام.
ARRIVED_AT_PICKUP لقد وصل السائق إلى نقطة الاستلام.
ARRIVED_AT_INTERMEDIATE_DESTINATION وصل السائق إلى وجهة متوسطة وينتظر الراكب.
ENROUTE_TO_INTERMEDIATE_DESTINATION السائق في طريقه إلى وجهة متوسطة (ليست نقطة الانزلاق).
ENROUTE_TO_DROPOFF التقط السائق الراكب وهو في طريقه إلى الوجهة التالية.
COMPLETE تم انسحاب الراكب واكتمال الرحلة.
CANCELED تم إلغاء الرحلة قبل الاستلام من قِبل السائق أو الراكب أو مقدّم خدمة مشاركة الرحلات.

TripType

نوع الرحلة.

عمليات التعداد
UNKNOWN_TRIP_TYPE الخيار التلقائي، يُستخدَم لأنواع الرحلات غير المحدّدة أو غير المعروفة.
SHARED قد تتشارك الرحلة مركبة مع رحلات أخرى.
EXCLUSIVE وهذه الرحلة حصرية بمركبة.

TripView

أداة اختيار مجموعات مختلفة من حقول "الرحلة" في ردّ "GetTrip" راجع AIP-157 لمعرفة السياق. من المرجح أن تتم إضافة مشاهدات إضافية.

عمليات التعداد
TRIP_VIEW_UNSPECIFIED القيمة التلقائية. بالنسبة إلى التوافق مع الأنظمة القديمة، سيتم ضبط واجهة برمجة التطبيقات تلقائيًا على طريقة عرض حزمة تطوير البرامج (SDK). لضمان الاستقرار والدعم، ننصح العملاء باختيار TripView بخلاف SDK.
SDK تتضمّن الحقول التي قد لا تكون قابلة للتفسير أو الدعم باستخدام المكتبات المتاحة للجميع.
JOURNEY_SHARING_V1S تتم تعبئة حقول الرحلة لحالة استخدام "مشاركة الرحلة". تم تصميم طريقة العرض هذه لاتصالات خادم إلى خادم.

TripWaypoint

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

الحقول
location

TerminalLocation

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

trip_id

string

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

waypoint_type

WaypointType

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

path_to_waypoint[]

LatLng

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

encoded_path_to_waypoint

string

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

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

traffic_to_waypoint

ConsumableTrafficPolyline

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

distance_meters

Int32Value

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

eta

Timestamp

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

duration

Duration

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

UpdateTripRequest

رسالة طلب UpdateTrip.

الحقول
header

RequestHeader

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

name

string

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

trip

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. وإذا لم يكن الأمر كذلك، سيتعذّر تنفيذ الطلب.

update_mask

FieldMask

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

UpdateVehicleAttributesRequest

رسالة طلب UpdateVehicleAttributes.

الحقول
header

RequestHeader

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

name

string

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

attributes[]

VehicleAttribute

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

UpdateVehicleAttributesResponse

رسالة رد واحدة (UpdateVehicleAttributes).

الحقول
attributes[]

VehicleAttribute

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

UpdateVehicleRequest

رسالة طلب UpdateVehicle

الحقول
header

RequestHeader

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

name

string

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

vehicle

Vehicle

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

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

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

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

update_mask

FieldMask

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

مركبة

البيانات الوصفية للمركبة

الحقول
name

string

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

vehicle_state

VehicleState

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

supported_trip_types[]

TripType

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

current_trips[]

string

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

last_location

VehicleLocation

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

maximum_capacity

int32

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

attributes[]

VehicleAttribute

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

vehicle_type

VehicleType

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

license_plate

LicensePlate

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

route[]
(deprecated)

TerminalLocation

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

current_route_segment

string

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

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

current_route_segment_traffic

TrafficPolylineData

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

current_route_segment_version

Timestamp

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

current_route_segment_end_point

TripWaypoint

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

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

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

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

remaining_time_seconds

Int32Value

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

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

waypoints[]

TripWaypoint

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

waypoints_version

Timestamp

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

back_to_back_enabled

bool

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

navigation_status

NavigationStatus

تعرض هذه السمة حالة التنقّل في المركبة.

device_settings

DeviceSettings

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

VehicleType

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

الحقول
category

Category

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

الفئة

فئات أنواع المركبات

عمليات التعداد
UNKNOWN الخيار التلقائي، يُستخدَم لفئات المركبات غير المحدَّدة أو غير المعروفة.
AUTO سيارة.
TAXI تمثّل هذه السمة أي مركبة تُستخدم كسيارة أجرة (عادةً ما تكون مرخّصة أو خاضعة للرقابة).
TRUCK بشكل عام، تكون المركبات ذات سعة تخزين كبيرة.
TWO_WHEELER دراجة نارية أو دراجة نارية أو مركبة أخرى ذات عجلتين
BICYCLE نقل يعمل بآلية بشرية
PEDESTRIAN ناقل إنسان يسير على الأقدام أو يركض في العادة على طول ممرات المشاة

VehicleAttribute

تصف سمة المركبة على أنّها زوج المفتاح/القيمة. "key:value" لا يمكن أن يتجاوز طول السلسلة 256 حرفًا.

الحقول
key

string

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

value

string

قيمة السمة.

حقل الاتحاد vehicle_attribute_value. قيمة السمة، يمكن أن تكون في سلسلة أو قيمة منطقية أو نوع مزدوج. يمكن أن يكون vehicle_attribute_value واحدًا فقط مما يلي:
string_value

string

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

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

bool_value

bool

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

number_value

double

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

VehicleAttributeList

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

الحقول
attributes[]

VehicleAttribute

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

VehicleLocation

الموقع الجغرافي للمركبة وسرعتها وعنوانها في وقت محدّد

الحقول
location

LatLng

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

horizontal_accuracy
(deprecated)

DoubleValue

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

latlng_accuracy

DoubleValue

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

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

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

heading_accuracy

DoubleValue

درجة دقة heading بالدرجات.

altitude

DoubleValue

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

vertical_accuracy
(deprecated)

DoubleValue

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

altitude_accuracy

DoubleValue

دقة altitude بالمتر

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

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

speed_accuracy

DoubleValue

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

update_time

Timestamp

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

server_time

Timestamp

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

location_sensor

LocationSensor

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

is_road_snapped

BoolValue

ما إذا كان قد تم محاذاة location إلى طريق أم لا.

is_gps_sensor_enabled

BoolValue

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

time_since_update

Int32Value

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

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

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

raw_location_time

Timestamp

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

raw_location_sensor

LocationSensor

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

raw_location_accuracy

DoubleValue

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

supplemental_location

LatLng

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

supplemental_location_time

Timestamp

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

supplemental_location_sensor

LocationSensor

مصدر الموقع التكميلي وتكون القيمة التلقائية هي CUSTOMER_SUPPLIED_LOCATION.

supplemental_location_accuracy

DoubleValue

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

road_snapped
(deprecated)

bool

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

VehicleMatch

تحتوي على المركبة والتقديرات ذات الصلة لمركبة تطابق نقاط الرحلات النشطة للمركبة "SearchVehiclesRequest".

الحقول
vehicle

Vehicle

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

vehicle_pickup_eta

Timestamp

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

vehicle_pickup_distance_meters

Int32Value

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

vehicle_pickup_straight_line_distance_meters

Int32Value

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

vehicle_dropoff_eta

Timestamp

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

vehicle_pickup_to_dropoff_distance_meters

Int32Value

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

trip_type

TripType

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

vehicle_trips_waypoints[]

Waypoint

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

vehicle_match_type

VehicleMatchType

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

requested_ordered_by

VehicleMatchOrder

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

ordered_by

VehicleMatchOrder

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

VehicleMatchType

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

عمليات التعداد
UNKNOWN نوع مطابقة مركبة غير معروف
EXCLUSIVE ما مِن رحلة مخصصة للمركبة حاليًا ويمكنها المتابعة إلى نقطة الاستلام.
BACK_TO_BACK المركبة مخصّصة حاليًا لرحلة، ولكن يمكنها المتابعة إلى نقطة الركوب بعد إكمال الرحلة الجارية. وتراعي حسابات الوقت المقدّر للوصول والمسافة الرحلة الحالية.
CARPOOL تتّسع المركبة للرحلة المشتركة.
CARPOOL_BACK_TO_BACK ستُنهي المركبة رحلتها الحالية النشطة قبل المتابعة إلى نقطة الاستلام. وتراعي حسابات الوقت المقدّر للوصول والمسافة الرحلة الحالية.

VehicleState

حالة Vehicle.

عمليات التعداد
UNKNOWN_VEHICLE_STATE الخيار التلقائي، يُستخدم في حالات المركبات غير المحدّدة أو غير المعروفة.
OFFLINE لا تقبل المركبة رحلات جديدة. ملاحظة: قد تستمر المركبة في العمل في هذه الحالة أثناء إكمال رحلة مخصصة لها.
ONLINE تقبل المركبة رحلات جديدة.

VisualTrafficReportPolylineRendering

يصف كيف يجب على العملاء تلوين جزء واحد من الخطوط المتعددة على طول المسار.

الحقول
road_stretch[]

RoadStretch

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

في حالة عدم وجود امتداد الطريق إلى النمط، يجب على العميل تطبيق الإعداد الافتراضي للمسار.

RoadStretch

امتداد واحد للطريق يجب عرضه.

الحقول
style

Style

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

offset_meters

int32

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

length_meters

int32

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

النمط

نمط حركة المرور، الذي يشير إلى سرعة حركة المرور.

عمليات التعداد
STYLE_UNSPECIFIED لم يتم اختيار أي نمط.
SLOWER_TRAFFIC حركة المرور بطيئة
TRAFFIC_JAM هناك ازدحام مروري.

النقطة الوسيطة

يصف هذا المقياس النقاط المتوسطة على طول مسار VehicleMatch في SearchVehiclesResponse. ويتم تمثيل هذا المفهوم على أنّه TripWaypoint في جميع نقاط النهاية الأخرى.

الحقول
lat_lng

LatLng

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

eta

Timestamp

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

WaypointType

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

عمليات التعداد
UNKNOWN_WAYPOINT_TYPE نوع نقطة طريق غير معروف أو غير محدّد.
PICKUP_WAYPOINT_TYPE نقاط الطرق لتوصيل الركاب أو العناصر.
DROP_OFF_WAYPOINT_TYPE نقاط الطرق لإنزال الركاب أو العناصر.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE نقاط الطرق للوجهات المتوسطة في رحلة متعددة الوجهات