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)

تعرض قائمة مقسّمة إلى صفحات للمركبات المرتبطة بمقدّم خدمة الذي يطابق خيارات الطلب.
SearchFuzzedVehicles

rpc SearchFuzzedVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

مهملة: يمكنك استخدام SearchVehicles بدلاً منها.
SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

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

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

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

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

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

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

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

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

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

BatteryInfo

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

الحقول
battery_status

BatteryStatus

حالة البطارية، سواء كانت ممتلئة أو قيد الشحن وما إلى ذلك
power_source

PowerSource

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

float

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

BatteryStatus

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

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

BillingPlatformIdentifier

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

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

ConsumableTrafficPolyline

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

الحقول
speed_reading_interval[]

SpeedReadingInterval

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

string

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

CreateTripRequest

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

الحقول
header

RequestHeader

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

string

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

string

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

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

Trip

مطلوبة. هناك كيان للرحلة المطلوب إنشاؤه.

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

  • trip_type
  • pickup_point

تُستخدم الحقول التالية في حال توفيرها:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

يتم تجاهل جميع حقول "الرحلة" الأخرى. على سبيل المثال، تبدأ جميع الرحلات بالرمز trip_status من NEW حتى إذا اجتازت trip_status من CANCELED في طلب الإنشاء.

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

Vehicle

مطلوبة. تمثّل هذه السمة كيان المركبة المطلوب إنشاؤها. يجب ملء الحقول التالية عند إنشاء مركبة:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

عند إنشاء مركبة، يتم تجاهل الحقول التالية:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

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

DeviceSettings

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

الحقول
location_power_save_mode

LocationPowerSaveMode

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

bool

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

bool

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

BatteryInfo

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

GetTripRequest

رسالة طلب GetTrip.

الحقول
header

RequestHeader

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

string

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

TripView

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

Timestamp

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

Timestamp

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

PolylineFormatType

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

Timestamp

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

Timestamp

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

GetVehicleRequest

رسالة طلب GetVehicle.

الحقول
header

RequestHeader

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

string

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

Timestamp

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

Timestamp

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

LicensePlate

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

الحقول
country_code

string

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

string

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

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

ListVehiclesRequest

رسالة طلب ListVehicles.

الحقول
header

RequestHeader

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

string

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

int32

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

string

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

Int32Value

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

TripType

يساعد هذا الخيار على حصر الاستجابة للمركبات التي تتيح نوعًا واحدًا على الأقل من أنواع الرحلات المحدّدة.
maximum_staleness

Duration

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

Category

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

string

يمكن للمتصلين إنشاء عمليات منطقية معقدة باستخدام أي مجموعة من الحقول required_attributes وrequired_one_of_attributes وrequired_one_of_attribute_sets.

required_attributes هي قائمة، ويستخدم required_one_of_attributes رسالة تسمح بإنشاء قائمة من القوائم. يتيح الحقلان معًا إنشاء هذا التعبير:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

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

string

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

string

يوفّر required_one_of_attribute_sets وظائف إضافية.

على غرار required_one_of_attributes، يستخدم required_one_of_attribute_sets رسالة تسمح بعرض قائمة من القوائم، مع السماح بالتعبيرات مثل هذه:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

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

VehicleState

تعمل هذه السياسة على حصر الاستجابة للمركبات التي تحمل حالة المركبة هذه.
on_trip_only

bool

إرجاع المركبات التي تتضمّن الرحلات الحالية فقط
filter

string

اختياريّ. استعلام فلتر ليتم تطبيقه عند إدراج المركبات. راجِع http://aip.dev/160 للحصول على أمثلة على بنية الفلتر.

تم تصميم هذا الحقل ليحل محل الحقول required_attributes وrequired_one_of_attributes وrequired_one_of_attributes_sets. إذا تم تحديد قيمة غير فارغة هنا، يجب أن تكون الحقول التالية فارغة: required_attributes وrequired_one_of_attributes وrequired_one_of_attributes_sets.

ويعمل هذا الفلتر كعبارة AND مع قيود أخرى، مثل vehicle_state أو on_trip_only.

يُرجى العِلم أنّ طلبات البحث الوحيدة المتاحة هي في سمات المركبات (مثل attributes.<key> = <value> أو attributes.<key1> = <value1> AND attributes.<key2> = <value2>). الحدّ الأقصى لعدد القيود المسموح به في طلب البحث عن فلتر هو 50.

يتم أيضًا تخزين جميع السمات كسلاسل، وبالتالي فإنّ المقارنات الوحيدة المتوافقة مع السمات هي مقارنات السلاسل. للمقارنة مع القيم الرقمية أو المنطقية، يجب اقتباس القيم صراحةً ليتم التعامل معها كسلاسل (على سبيل المثال، attributes.<key> = "10" أو attributes.<key> = "true").
viewport

Viewport

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

ListVehiclesResponse

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

الحقول
vehicles[]

Vehicle

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

string

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

int64

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

LocationPowerSaveMode

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

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

LocationSensor

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

عمليات التعداد
UNKNOWN_SENSOR أداة الاستشعار غير محدّدة أو غير معروفة.
GPS نظام تحديد المواقع العالمي (GPS) أو نظام تحديد المواقع العالمي المساعد.
NETWORK المساعدة في تحديد المواقع العالمي (GPS) أو معرّف برج الاتصالات أو نقطة وصول WiFi
PASSIVE رقم تعريف برج الهاتف أو نقطة وصول WiFi
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 التنقُّل في تطبيق "السائق" متاح في وضع "FREE_NAV".
ENROUTE_TO_DESTINATION تتوفّر ميزة التنقّل باتّجاهات مفصّلة وقد دخلت ميزة التنقّل في تطبيق "السائق" إلى وضع GUIDED_NAV.
OFF_ROUTE خرجت المركبة عن المسار المقترَح.
ARRIVED_AT_DESTINATION وتقع المركبة في نطاق 50 مترًا تقريبًا من الوجهة.

PolylineFormatType

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

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

PowerSource

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

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

ReportBillableTripRequest

رسالة طلب 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

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

SolutionType

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

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

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) للاتصال هي "المستهلك".
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
...)

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

VehicleAttributeList

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

VehicleAttributeList

يوفّر required_one_of_attribute_sets وظائف إضافية.

على غرار required_one_of_attributes، يستخدم required_one_of_attribute_sets رسالة تسمح بعرض قائمة من القوائم، مع السماح بالتعبيرات مثل هذه:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

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

VehicleMatchOrder

مطلوبة. تحدّد هذه السمة معيار الترتيب المطلوب للنتائج.
include_back_to_back

bool

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

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

string

يشير هذا العمود إلى الرحلة المرتبطة بجهاز "SearchVehicleRequest" هذا.
current_trips_present

CurrentTripsPresent

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

string

اختياريّ. استعلام فلتر ليتم تطبيقه عند البحث عن المركبات. راجِع http://aip.dev/160 للحصول على أمثلة على بنية الفلتر.

تم تصميم هذا الحقل ليحل محل الحقول required_attributes وrequired_one_of_attributes وrequired_one_of_attributes_sets. إذا تم تحديد قيمة غير فارغة هنا، يجب أن تكون الحقول التالية فارغة: required_attributes وrequired_one_of_attributes وrequired_one_of_attributes_sets.

ويعمل هذا الفلتر كعبارة AND مع قيود أخرى، مثل minimum_capacity أو vehicle_types.

يُرجى العِلم أنّ طلبات البحث الوحيدة المتاحة هي في سمات المركبات (مثل attributes.<key> = <value> أو attributes.<key1> = <value1> AND attributes.<key2> = <value2>). الحدّ الأقصى لعدد القيود المسموح به في طلب البحث عن فلتر هو 50.

يتم أيضًا تخزين جميع السمات كسلاسل، وبالتالي فإنّ المقارنات الوحيدة المتوافقة مع السمات هي مقارنات السلاسل. للمقارنة مع القيم الرقمية أو المنطقية، يجب اقتباس القيم صراحةً ليتم التعامل معها كسلاسل (على سبيل المثال، attributes.<key> = "10" أو attributes.<key> = "true").

CurrentTripsPresent

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

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

VehicleMatchOrder

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

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

SearchVehiclesResponse

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

الحقول
matches[]

VehicleMatch

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

SpeedReadingInterval

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

الحقول
start_polyline_point_index

int32

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

int32

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

Speed

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

السرعة

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

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

StopLocation

الموقع الفعلي الذي حدث فيه التوقف (الاستلام/الهبوط).

الحقول
point

LatLng

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

Timestamp

تشير هذه السمة إلى وقت حدوث التوقّف.
stop_time
(deprecated)

Timestamp

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

TerminalLocation

تصف موقع نقطة الطريق.

الحقول
point

LatLng

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

TerminalPointId

رقم تعريف نقطة النهاية.
access_point_id
(deprecated)

string

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

string

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

WaypointType

مهملة: سيكون لدى Vehicle.waypoint هذه البيانات.

TerminalPointId

تحدد نقطة النهاية.

الحقول
value

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

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

string

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

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

Timestamp

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

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

ConsumableTrafficPolyline

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

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

Timestamp

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

ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال Driver SDK و"SDK للمستهلكين".
current_route_segment_end_point

TripWaypoint

النتائج فقط. نقطة الطريق التي ينتهي عندها current_route_segment.
remaining_distance_meters

Int32Value

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

Timestamp

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

Duration

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

Timestamp

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

Timestamp

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

int32

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

VehicleLocation

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

bool

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

TripView

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

TripStatus

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

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

TripType

نوع الرحلة.

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

TripView

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

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

TripWaypoint

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

الحقول
location

TerminalLocation

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

string

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

WaypointType

الدور الذي تلعبه هذه النقطة الوسيطة في هذه الرحلة، مثل استلام الطلب أو التسليم
path_to_waypoint[]

LatLng

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

string

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

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

  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_traffic
  • current_route_segment_traffic_version
  • current_route_segment_version
  • dropoff_time
  • eta_to_next_waypoint
  • intermediate_destinations_version
  • last_location
  • name
  • number_of_passengers
  • pickup_time
  • remaining_distance_meters
  • remaining_time_to_first_waypoint
  • remaining_waypoints
  • remaining_waypoints_version
  • route

عند تعديل Trip.vehicle_id لرحلة مشتركة، عليك تقديم قائمة Trip.vehicle_waypoints لتحديد ترتيب نقاط الطريق المتبقية، وإلا لن يتم تحديد الترتيب.

عند تحديد Trip.vehicle_waypoints، يجب أن تحتوي القائمة على جميع نقاط الطريق المتبقية لرحلات المركبة، بدون نقاط طريق إضافية. يجب طلب نقاط الطريق هذه بحيث تكون نقطة الاستلام قبل الوجهات الوسيطة لرحلة معينة، وتأتي جميع الوجهات الوسيطة قبل نقطة النزول. يجب ألا تتداخل نقاط المسار في رحلة EXCLUSIVE مع أي رحلات أخرى. يتم استخدام الحقول trip_id وwaypoint_type وlocation، ويتم تجاهل جميع حقول TripWaypoint الأخرى في vehicle_waypoints.

لتجنّب استيفاء شروط سباق للرحلات التي تسافر إلى وجهات متعدّدة، يجب توفير السمة Trip.intermediate_destinations_version عند تعديل حالة الرحلة إلى ENROUTE_TO_INTERMEDIATE_DESTINATION. يجب أن تكون قيمة Trip.intermediate_destinations_version التي تم تمريرها متوافقة مع إصدار Fleet Engine. وإذا لم تكن دقيقة، سيتعذّر إتمام الطلب.
update_mask

FieldMask

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

UpdateVehicleAttributesRequest

رسالة طلب UpdateVehicleAttributes.

الحقول
header

RequestHeader

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

string

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

VehicleAttribute

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

UpdateVehicleAttributesResponse

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

الحقول
attributes[]

VehicleAttribute

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

UpdateVehicleRequest

"رسالة طلب UpdateVehicle".

الحقول
header

RequestHeader

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

string

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

Vehicle

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

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

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

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

FieldMask

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

مركبة

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

الحقول
name

string

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

VehicleState

حالة المركبة
supported_trip_types[]

TripType

أنواع الرحلات التي تتيحها هذه المركبة
current_trips[]

string

النتائج فقط. قائمة برحلات trip_id للرحلات المحددة حاليًا لهذه المركبة.
last_location

VehicleLocation

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

int32

تمثّل هذه السمة إجمالي عدد ركاب هذه المركبة. لم يتم وضع السائق في هذه القيمة. يجب أن تكون هذه القيمة أكبر من واحد أو مساوية له.
attributes[]

VehicleAttribute

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

VehicleType

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

LicensePlate

معلومات لوحة ترخيص المركبة
route[]
(deprecated)

TerminalLocation

مهملة: يمكنك استخدام Vehicle.waypoints بدلاً منها.
current_route_segment

string

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

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

TrafficPolylineData

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

Timestamp

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

TripWaypoint

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

Int32Value

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

Timestamp

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

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

Int32Value

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

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

TripWaypoint

نقاط الطريق المتبقية المخصّصة لهذه المركبة
waypoints_version

Timestamp

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

bool

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

NavigationStatus

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

DeviceSettings

الإدخال فقط. معلومات حول الإعدادات في الجهاز الجوّال التي يستخدمها برنامج التشغيل.

VehicleType

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

الحقول
category

Category

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

الفئة

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

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

VehicleAttribute

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

الحقول
key

string

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

string

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

string

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

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

bool

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

double

قيمة سمة مكتوبة بنمط مزدوج.

VehicleAttributeList

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

الحقول
attributes[]

VehicleAttribute

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

VehicleLocation

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

الحقول
location

LatLng

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

DoubleValue

مهملة: يمكنك استخدام latlng_accuracy بدلاً منها.
latlng_accuracy

DoubleValue

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

Int32Value

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

DoubleValue

مهملة: يمكنك استخدام heading_accuracy بدلاً منها.
heading_accuracy

DoubleValue

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

DoubleValue

الارتفاع بالمتر فوق WGS84
vertical_accuracy
(deprecated)

DoubleValue

مهملة: يمكنك استخدام altitude_accuracy بدلاً منها.
altitude_accuracy

DoubleValue

تبلغ دقة altitude بالمتر.
speed_kmph
(deprecated)

Int32Value

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

DoubleValue

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

DoubleValue

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

Timestamp

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

Timestamp

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

LocationSensor

مقدِّم بيانات الموقع الجغرافي (مثل GPS)
is_road_snapped

BoolValue

ما إذا كان "location" يؤدي إلى طريق.
is_gps_sensor_enabled

BoolValue

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

Int32Value

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

Int32Value

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

LatLng

الموقع الجغرافي للمركبة غير المعدّلة (لا تتم معالجته من خلال أداة التقاط صور على الطريق)
raw_location_time

Timestamp

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

LocationSensor

مصدر الموقع الأولي. وتكون الإعدادات التلقائية GPS.
raw_location_accuracy

DoubleValue

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

LatLng

موقع جغرافي تكميلي يوفّره تطبيق الدمج.
supplemental_location_time

Timestamp

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

LocationSensor

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

DoubleValue

دقة supplemental_location كنطاق جغرافي بالمتر
road_snapped
(deprecated)

bool

مهملة: يمكنك استخدام is_road_snapped بدلاً منها.

VehicleMatch

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

الحقول
vehicle

Vehicle

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

Timestamp

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

Int32Value

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

Int32Value

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

Timestamp

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

Int32Value

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

TripType

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

Waypoint

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

VehicleMatchType

نوع مطابقة المركبة
requested_ordered_by

VehicleMatchOrder

الطلب المطلوب لترتيب تطابقات المركبات.
ordered_by

VehicleMatchOrder

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

VehicleMatchType

نوع مطابقة المركبة

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

VehicleState

تمثّل هذه السمة حالة Vehicle.

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

VisualTrafficReportPolylineRendering

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

الحقول
road_stretch[]

RoadStretch

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

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

RoadStretch

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

الحقول
style

Style

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

int32

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

int32

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

النمط

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

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

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

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

الحقول
lat_lng

LatLng

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

Timestamp

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

WaypointType

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

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