Package maps.fleetengine.v1

الفهرس

TripService

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

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

تنشئ هذه الطريقة رحلة في Fleet Engine وتعرض الرحلة الجديدة.
DeleteTrip

rpc DeleteTrip(DeleteTripRequest) returns (Empty)

لحذف رحلة واحدة

تعرِض هذه الحالة FAILED_PRECONDITION إذا كانت الرحلة نشطة وتم تعيينها لمركبة.
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

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

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

تحذف هذه الطريقة مركبة من Fleet Engine.

تعرض هذه الحالة FAILED_PRECONDITION إذا كانت المركبة تتضمّن رحلات نشطة.
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 حرفًا.
  • يجب أن تكون البيانات موحّدة وفقًا لمعيار Unicode Normalization Form 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 في طلب الإنشاء.

لا تتوافق رحلات EXCLUSIVE مع intermediate_destinations.

عند ضبط 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 Normalization Form 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

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

DeleteTripRequest

رسالة طلب DeleteTrip

الحقول
header

RequestHeader

اختياريّ. عنوان طلب Fleet Engine العادي
name

string

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

DeleteVehicleRequest

رسالة طلب DeleteVehicle

الحقول
header

RequestHeader

اختياريّ. عنوان طلب Fleet Engine العادي
name

string

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

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
(deprecated)

Timestamp

تم إيقافها نهائيًا: يتم دائمًا استرداد Trip.remaining_waypoints. استخدِم remaining_waypoints_route_version للتحكّم في وقت استرداد بيانات Trip.remaining_waypoints.traffic_to_waypoint وTrip.remaining_waypoints.path_to_waypoint.
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_attributes. يتطابق هذا مع الحد الأقصى لعدد السمات المسموح بها في مركبة. يجب أن تكون كل سلسلة متكررة بالتنسيق "key:value".
required_one_of_attributes[]

string

يحصر الردّ بالمركبات التي تتضمّن سمة واحدة على الأقل من السمات المحدّدة في كل VehicleAttributeList. يجب أن تتطابق المركبة مع سمة واحدة على الأقل ضمن كل قائمة. هذا الحقل هو عملية فصل شاملة/OR في كل VehicleAttributeList وعملية اقتران/AND في مجموعة 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. يجب أن تتطابق المركبة مع جميع السمات الواردة في كل قائمة. هذا الحقل هو عملية اقتران/AND في كل VehicleAttributeList وعملية فصل شامل/OR في مجموعة 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 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) أو نظام 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 موقع جغرافي تحسبه Fleet Engine استنادًا إلى الإشارات المتاحة لها. النتائج فقط. سيتم رفض هذه القيمة إذا تم تلقّيها في طلب.
FUSED_LOCATION_PROVIDER ميزة "موفِّر الموقع المدمج" من Android
CORE_LOCATION مقدّم خدمة تحديد الموقع الجغرافي على أنظمة تشغيل Apple

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

عمليات التعداد
UNKNOWN_NAVIGATION_STATUS حالة التنقّل غير محدَّدة.
NO_GUIDANCE تطبيق Driver في وضع 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 مصدر الطاقة هو شاحن تيار متردد.
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 على حقول مشتركة بين جميع طلبات Fleet Engine RPC.

الحقول
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 التي يتم استدعاؤها، وينطبق ذلك فقط على حِزم Android SDK. مثال على قيمة الحقل: 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 و10000 متر (بما يشمل هذين الرقمَين).
count

int32

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

int32

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

TripType

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

Duration

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

VehicleType

مطلوب. يحصر البحث على المركبات التي تتضمّن أحد الأنواع المحدّدة. يجب تحديد نوع مركبة واحد على الأقل. لا يُسمح باستخدام VehicleTypes التي تنتمي إلى الفئة 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_attributes. يتطابق هذا مع الحد الأقصى لعدد السمات المسموح بها في مركبة.
required_one_of_attributes[]

VehicleAttributeList

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

تمثّل هذه السمة LatLng الدقيق لنقطة الطريق. يجب تحديد point أو place كإدخال. في حال تحديد كليهما، سيتم استخدام point للتوجيه وplace للبيانات الوصفية. إذا تم تحديد place فقط كإدخال، سيتم احتساب point من place وتضمينه في الناتج.
place

string

اسم مصدر المكان الذي يمثّل هذا الموقع الجغرافي. التنسيق هو places/{place_id}. يجب تحديد point أو place كإدخال. في حال تحديد كليهما، سيتم استخدام point للتوجيه وplace للبيانات الوصفية. لا يتم تضمين place في الناتج إلا إذا تم تضمينه في الإدخال، ما يعني أنّه لا يتم إجراء بحث عن place من LatLng.

هذه ميزة تجريبية.
point_location_source

PointSource

النتائج فقط. مصدر الحقل point
terminal_point_id
(deprecated)

TerminalPointId

تم إيقافها نهائيًا: استخدِم الحقل place بدلاً من ذلك.
access_point_id
(deprecated)

string

تم إيقافها نهائيًا: استخدِم الحقل place بدلاً من ذلك.
trip_id
(deprecated)

string

تمّ الإيقاف.
terminal_location_type
(deprecated)

WaypointType

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

PointSource

تشير هذه السمة إلى مصدر LatLng.

عمليات التعداد
POINT_SOURCE_UNSPECIFIED لم يتم تحديد مصدر النقطة.
POINT_SOURCE_DEVELOPER_PROVIDED تم تقديم LatLng بشكل صريح من قِبل المطوّر.
POINT_SOURCE_CALCULATED_FROM_PLACE تم احتساب LatLng من المكان المقدَّم.

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

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

string

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

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

Timestamp

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

ملاحظة: هذا الحقل مخصّص للاستخدام من قِبل Driver SDK وConsumer SDK فقط.
current_route_segment_traffic

ConsumableTrafficPolyline

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

ملاحظة: هذا الحقل مخصّص للاستخدام من قِبل Driver SDK وConsumer SDK فقط.
current_route_segment_traffic_version

Timestamp

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

ملاحظة: هذا الحقل مخصّص للاستخدام من قِبل Driver SDK وConsumer 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

مجموعة فرعية من حقول الرحلة التي يتم ملؤها وكيفية تفسيرها
attributes[]

TripAttribute

قائمة بسمات الرحلة المخصّصة. يجب أن تتضمّن كل سمة مفتاحًا فريدًا.

TripAttribute

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

الحقول
key

string

مفتاح السمة يجب ألا تحتوي المفاتيح على رمز النقطتين الرأسيتين (:).
حقل الدمج trip_attribute_value يمكن أن تكون قيمة السمة من النوع string أو bool أو double. يمكن أن تكون trip_attribute_value إحدى القيم التالية فقط:
string_value

string

قيمة السمة من النوع "سلسلة"
bool_value

bool

قيمة السمة من النوع المنطقي
number_value

double

قيمة السمة من النوع Double

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

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

ملاحظة: هذا الحقل مخصّص للاستخدام من قِبل Driver SDK وConsumer 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

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

VehicleLocation

الإدخال فقط المواقع الجغرافية التي كانت فيها هذه المركبة في السابق ولم يتم إبلاغ Fleet Engine بها بعد يتم استخدام هذا الحقل في UpdateVehicleRequest لتسجيل المواقع الجغرافية التي تعذّر إرسالها إلى الخادم سابقًا. يحدث ذلك عادةً عندما لا تكون المركبة متصلة بالإنترنت.
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 يمكن أن تكون قيمة السمة من النوع string أو bool أو double. يمكن أن تكون vehicle_attribute_value إحدى القيم التالية فقط:
string_value

string

قيمة السمة من النوع "سلسلة"

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

bool

قيمة السمة من النوع المنطقي
number_value

double

قيمة السمة من النوع 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 كنصف قطر، وذلك بالمتر.
flp_location

LatLng

الموقع الجغرافي من ميزة "موفِّر الموقع المدمج" من Android
flp_update_time

Timestamp

الطابع الزمني لتعديل flp_location
flp_latlng_accuracy_meters

DoubleValue

دقة flp_location بالأمتار كنصف قطر
flp_heading_degrees

Int32Value

الاتجاه الذي تتحرّك فيه المركبة بالدرجات، كما يحدّده "موفِّر الموقع المدمج" يمثّل الرقم 0 الشمال. النطاق الصالح هو [0,360).
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 نقاط على المسار لوجهات وسيطة في رحلة تتضمّن وجهات متعدّدة