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

رسالة طلب CreateTrip

الحقول
header

RequestHeader

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

string

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

string

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

  • يجب أن تكون سلسلة Unicode صالحة.
  • يجب ألا يزيد طولها عن 64 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
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 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
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
...)

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

string

تقييد الاستجابة على المركبات التي تحتوي على سمة واحدة على الأقل من السمات المحدّدة في كل VehicleAttributeList ضمن كل قائمة، يجب أن تتطابق المركبة مع سمة واحدة على الأقل. هذا الحقل هو عملية نفي شمولي/أو شاملة في كل VehicleAttributeList وعملية ربط/و شاملة في مجموعة VehicleAttributeList. يجب أن تكون كل سلسلة متكرّرة بالتنسيق "المفتاح1:القيمة1|المفتاح2:القيمة2|المفتاح3:القيمة3".
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 ويجب أن تتطابق المركبة مع جميع السمات ضمن كل قائمة. هذا الحقل هو عملية ربط/AND في كل VehicleAttributeList وعملية نفي شامل/OR في مجموعة VehicleAttributeList. يجب أن تكون كل سلسلة متكرّرة بالتنسيق "المفتاح1:القيمة1|المفتاح2:القيمة2|المفتاح3:القيمة3".
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 Undefined LocationPowerSaveMode
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 لن يتم إيقاف الموقع الجغرافي، ولكن سيحدّ LocationManager من جميع الطلبات المرسَلة إلى مقدّمي الخدمات عندما يكون الجهاز غير تفاعلي.

LocationSensor

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

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

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

عمليات التعداد
UNKNOWN_NAVIGATION_STATUS حالة التنقّل غير محدّدة.
NO_GUIDANCE وضع التنقّل في تطبيق "سائق Google" هو FREE_NAV.
ENROUTE_TO_DESTINATION تتوفّر ميزة "الاتّجاهات المفصّلة"، ودخلت ميزة التنقّل في تطبيق "سائق Google" في وضع 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 مصدر الطاقة هو شاحن التيار المتناوب.
POWER_SOURCE_USB مصدر الطاقة هو منفذ USB.
POWER_SOURCE_WIRELESS مصدر الطاقة لاسلكي.
POWER_SOURCE_UNPLUGGED البطارية غير متصلة بمصدر الطاقة.

ReportBillableTripRequest

رسالة طلب ReportBillableTrip

الحقول
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

نوع حلّ منتج GMP (مثل ON_DEMAND_RIDESHARING_AND_DELIVERIES) المستخدَم في الرحلة التي تم الإبلاغ عنها.

SolutionType

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

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

RequestHeader

يحتوي RequestHeader على حقول شائعة لجميع طلبات RPC في 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) للمكالمات هي Consumer.
DRIVER حزمة تطوير البرامج (SDK) التي تُجري المكالمة هي Driver.
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
...)

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

تم إيقافها نهائيًا: لم تعُد نقاط النهاية متاحة في 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

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

LatLng

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

string

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

Int32Value

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

Timestamp

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

Duration

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

UpdateTripRequest

رسالة طلب تعديل الرحلة

الحقول
header

RequestHeader

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

string

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

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. وإذا لم يكن الأمر كذلك، لن تنجح عملية إثبات الملكية.
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

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

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

TrafficPolylineData

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

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

الحقول
key

string

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

string

قيمة السمة
حقل الربط vehicle_attribute_value يمكن أن تكون قيمة السمة من النوع string أو bool أو double. يمكن أن يكون 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.
ordered_by

VehicleMatchOrder

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

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 نقاط على المسار لوجهات وسيطة في رحلة متعددة الوجهات