الفهرس
TripService
(واجهة)VehicleService
(واجهة)BatteryInfo
(رسالة)BatteryStatus
(تعداد)BillingPlatformIdentifier
(تعداد)ConsumableTrafficPolyline
(رسالة)CreateTripRequest
(رسالة)CreateVehicleRequest
(رسالة)DeviceSettings
(رسالة)GetTripRequest
(رسالة)GetVehicleRequest
(رسالة)LicensePlate
(رسالة)ListVehiclesRequest
(رسالة)ListVehiclesResponse
(رسالة)LocationPowerSaveMode
(تعداد)LocationSensor
(تعداد)NavigationStatus
(تعداد)PolylineFormatType
(تعداد)PowerSource
(تعداد)ReportBillableTripRequest
(رسالة)ReportBillableTripRequest.SolutionType
(تعداد)RequestHeader
(رسالة)RequestHeader.Platform
(تعداد)RequestHeader.SdkType
(تعداد)SearchTripsRequest
(رسالة)SearchTripsResponse
(رسالة)SearchVehiclesRequest
(رسالة)SearchVehiclesRequest.CurrentTripsPresent
(تعداد)SearchVehiclesRequest.VehicleMatchOrder
(تعداد)SearchVehiclesResponse
(رسالة)SpeedReadingInterval
(رسالة)SpeedReadingInterval.Speed
(تعداد)StopLocation
(رسالة)TerminalLocation
(رسالة)TerminalPointId
(رسالة) (متوقّفة نهائيًا)TrafficPolylineData
(رسالة)Trip
(رسالة)TripStatus
(تعداد)TripType
(تعداد)TripView
(تعداد)TripWaypoint
(رسالة)UpdateTripRequest
(رسالة)UpdateVehicleAttributesRequest
(رسالة)UpdateVehicleAttributesResponse
(رسالة)UpdateVehicleRequest
(رسالة)Vehicle
(رسالة)Vehicle.VehicleType
(رسالة)Vehicle.VehicleType.Category
(تعداد)VehicleAttribute
(رسالة)VehicleAttributeList
(رسالة)VehicleLocation
(رسالة)VehicleMatch
(رسالة)VehicleMatch.VehicleMatchType
(تعداد)VehicleState
(تعداد)VisualTrafficReportPolylineRendering
(رسالة)VisualTrafficReportPolylineRendering.RoadStretch
(رسالة)VisualTrafficReportPolylineRendering.RoadStretch.Style
(تعداد)Waypoint
(رسالة)WaypointType
(تعداد)
TripService
خدمة إدارة الرحلات
CreateTrip |
---|
ينشئ رحلة في Fleet Engine ويعرض الرحلة الجديدة. |
GetTrip |
---|
الحصول على معلومات عن رحلة واحدة |
ReportBillableTrip |
---|
الإبلاغ عن استخدام الرحلة القابلة للفوترة |
SearchTrips |
---|
يمكنك الاطّلاع على جميع الرحلات لمركبة معيّنة. |
UpdateTrip |
---|
تعدّل بيانات الرحلة. |
VehicleService
خدمة إدارة المركبات:
CreateVehicle |
---|
ينشئ مثيلاً لمركبة جديدة مرتبطة بمقدّم خدمة مشاركة الرحلات أو خدمات التسليم عند الطلب. يجب أن يكون لكل يجب ملء حقول
يتم تجاهل حقول
وجميع الحقول الأخرى اختيارية وتُستخدَم في حال توفيرها. |
GetVehicle |
---|
لعرض مركبة من Fleet Engine. |
ListVehicles |
---|
تعرض قائمة مقسّمة للمركبات المرتبطة بمقدّم خدمة يطابق خيارات الطلب. |
SearchVehicles |
---|
تعرض قائمة بالمركبات التي تتطابق مع خيارات الطلب. |
UpdateVehicle |
---|
كتابة بيانات المركبة المعدّلة في Fleet Engine عند تحديث
يتعذّر أيضًا تحديث المركبة إذا تم تعديل الحقل |
UpdateVehicleAttributes |
---|
يتم تعديل سمات المركبة جزئيًا. سيتم تعديل السمات المذكورة في الطلب فقط، ولن يتم تغيير السمات الأخرى. ملاحظة: تختلف هذه القاعدة في |
BatteryInfo
معلومات حول بطارية الجهاز
الحقول | |
---|---|
battery_status |
حالة البطارية، سواء كانت ممتلئة أو مشحونة وغير ذلك |
power_source |
حالة مصدر طاقة البطارية |
battery_percentage |
نسبة شحن البطارية الحالية [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[] |
سرعة حركة المرور على طول المسار من نقطة الطريق السابقة إلى نقطة الطريق الحالية |
encoded_path_to_waypoint |
المسار الذي يسلكه السائق من نقطة الطريق السابقة إلى نقطة الطريق الحالية. يحتوي هذا المسار على معالم حتى يتمكّن العملاء من عرض علامات حركة المرور على طول المسار (اطّلع على |
CreateTripRequest
إنشاء رسالة طلب الرحلة
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
parent |
مطلوب. يجب أن يكون بالتنسيق |
trip_id |
مطلوب. معرّف الرحلة الفريد يخضع للقيود التالية:
|
trip |
مطلوب. كيان الرحلة المطلوب إنشائه. عند إنشاء رحلة، يجب ملء الحقول التالية:
تُستخدَم الحقول التالية في حال توفيرها:
ويتم تجاهل جميع حقول "الرحلة" الأخرى. على سبيل المثال، تبدأ كل الرحلات بـ يمكن استخدام رحلات عند ضبط عند تحديد ويتم استخدام الحقول |
CreateVehicleRequest
رسالة طلب CreateVehicle
.
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
parent |
مطلوب. يجب أن يكون بالتنسيق |
vehicle_id |
مطلوب. معرّف المركبة الفريد يخضع للقيود التالية:
|
vehicle |
مطلوب. كيان المركبة المطلوب إنشاؤه: يجب ملء الحقول التالية عند إنشاء مركبة:
عند إنشاء مركبة، يتم تجاهل الحقول التالية:
وجميع الحقول الأخرى اختيارية وتُستخدَم في حال توفيرها. |
DeviceSettings
معلومات حول الإعدادات المختلفة على الجهاز الجوّال.
الحقول | |
---|---|
location_power_save_mode |
كيفية ضبط ميزات الموقع الجغرافي على الجهاز عند تفعيل ميزة "توفير شحن البطارية" |
is_power_save_mode |
ما إذا كان الجهاز في وضع توفير الطاقة حاليًا. |
is_interactive |
ما إذا كان الجهاز في حالة تفاعلية. |
battery_info |
معلومات حول حالة البطارية |
GetTripRequest
رسالة طلب GetTrip.
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
name |
مطلوب. يجب أن يكون بالتنسيق |
view |
المجموعة الفرعية من حقول "الرحلة" التي يجب عرضها وتفسيرها. |
current_route_segment_version |
يشير إلى الحد الأدنى للطابع الزمني (حصريًا) الذي يتم استرداد بيانات |
remaining_waypoints_version |
تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي تم استرداد |
route_format_type |
تنسيق المسار الحالي المعروض، |
current_route_segment_traffic_version |
تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي تم استرداد قيمة |
remaining_waypoints_route_version |
تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي يتم استرداد بيانات |
GetVehicleRequest
رسالة طلب GetVehicle
.
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
name |
مطلوب. يجب أن يكون بالتنسيق |
current_route_segment_version |
تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي تم استرداد قيمة |
waypoints_version |
تشير هذه السمة إلى الحد الأدنى للطابع الزمني (حصريًا) الذي يتم استرداد بيانات |
LicensePlate
تعرض هذه السمة معلومات لوحة ترخيص المركبة. ولتجنّب تخزين معلومات تحديد الهوية الشخصية، يتم تخزين الحد الأدنى من المعلومات المتوفّرة عن لوحة تسجيل المركبة فقط كجزء من الكيان.
الحقول | |
---|---|
country_code |
مطلوب. رمز البلد/المنطقة في CLDR على سبيل المثال، |
last_character |
الرقم الأخير من لوحة ترخيص المركبة أو "-1" للإشارة إلى عدم توفّر قيمة رقمية في لوحة تسجيل المركبة
|
ListVehiclesRequest
رسالة طلب ListVehicles
.
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
parent |
مطلوب. يجب أن يكون بالتنسيق |
page_size |
تمثّل هذه السمة الحدّ الأقصى لعدد المركبات المطلوب إرجاعها. القيمة التلقائية: 100. |
page_token |
قيمة |
minimum_capacity |
تحدّد هذه السمة الحدّ الأدنى المطلوب لسعة المركبة. سيكون لكل المركبات التي تم إرجاعها |
trip_types[] |
يقصر الاستجابة على المركبات التي تتوافق مع نوع واحد على الأقل من أنواع الرحلات المحددة. |
maximum_staleness |
لتقييد الاستجابة للمركبات التي أرسلت تعديلات الموقع الجغرافي إلى Fleet Engine خلال المدة المحدّدة. ولا تُعتبر المركبات الثابتة التي لا تزال تنقل مواقعها قديمة. في حال توفُّرها، يجب أن تكون مدة موجبة صالحة. |
vehicle_type_categories[] |
مطلوب. تعمل هذه السياسة على تقييد الاستجابة للمركبات التي تندرج ضمن إحدى الفئات المحدّدة. لا يُسمح باستخدام |
required_attributes[] |
ويمكن للمتصلين إنشاء عمليات منطقية معقدة باستخدام أي مجموعة من الحقول
تحصر الاستجابة للمركبات ذات السمات المحدّدة. هذا الحقل هو عملية ربط/و. الحدّ الأقصى المسموح به لعدد السمات المطلوبة هو 50 سمة. يتطابق ذلك مع الحد الأقصى لعدد السمات المسموح بها في المركبة. يجب أن تكون كل سلسلة متكررة بالتنسيق "key:value". |
required_one_of_attributes[] |
تعمل هذه السياسة على تقييد الاستجابة للمركبات التي تتضمّن سمة واحدة على الأقل من السمات المحدّدة في كل |
required_one_of_attribute_sets[] |
يوفّر على غرار
الردّ على المركبات التي تتطابق مع جميع السمات في |
vehicle_state |
لتقييد الاستجابة للمركبات التي تحمل حالة المركبة هذه. |
on_trip_only |
إرجاع المركبات ذات الرحلات الحالية فقط |
filter |
اختياريّ. عبارة عن طلب بحث للفلترة يتم تطبيقه عند إدراج المركبات. راجِع http://aip.dev/160 للاطّلاع على أمثلة عن بنية الفلاتر. تم تصميم هذا الحقل ليحلّ محلّ الحقول يعمل هذا الفلتر كعبارة AND مع قيود أخرى، مثل يُرجى العلم أنّ طلبات البحث المتاحة فقط تتعلّق بسمات المركبات (على سبيل المثال، ويتم أيضًا تخزين جميع السمات كسلاسل، وبالتالي فإنّ المقارنات الوحيدة المسموح بها مع السمات هي مقارنات السلاسل. للمقارنة مع القيم الرقمية أو المنطقية، يجب اقتباس القيم بشكل صريح ليتم التعامل معها كسلاسل (على سبيل المثال، |
viewport |
اختياريّ. فلتر يحدّ من المركبات التي يتم عرضها على المركبات التي تم عرضها في آخر موقع جغرافي معروف كان ضمن المنطقة المستطيلة التي حدّدها إطار العرض |
ListVehiclesResponse
رسالة رد واحدة (ListVehicles
).
الحقول | |
---|---|
vehicles[] |
المركبات التي تتطابق مع المعايير الواردة في الطلب يحدّد الحقل |
next_page_token |
رمز مميّز لاسترداد الصفحة التالية من المركبات أو فارغًا إذا لم يكن هناك مركبات أخرى تستوفي معايير الطلب |
total_size |
مطلوب. إجمالي عدد المركبات التي تتطابق مع معايير الطلب في جميع الصفحات |
LocationPowerSaveMode
كيفية ضبط ميزات الموقع الجغرافي لتعمل على الجهاز الجوّال عند تفعيل ميزة "توفير شحن البطارية" في الأجهزة الميزة مفعّلة. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
عمليات التعداد | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
موضع حفظ PowerSaveMode (موقع جغرافي) غير محدّد |
LOCATION_MODE_NO_CHANGE |
يجب ألا يتأثر موفرو المواقع الجغرافية بميزة "توفير شحن البطارية" أو أن هذه الميزة غير مفعّلة. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
يجب إيقاف موفّر الموقع الجغرافي المستند إلى نظام تحديد المواقع العالمي (GPS) عند تفعيل ميزة "توفير شحن البطارية" وعندما يكون الجهاز غير تفاعلي. |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
يجب إيقاف جميع موفري المواقع الجغرافية عندما تكون ميزة "توفير شحن البطارية" مفعَّلة ويكون الجهاز غير تفاعلي. |
LOCATION_MODE_FOREGROUND_ONLY |
ستتم إتاحة جميع موفري المواقع الجغرافية، ولكن يجب تقديم إصلاحات الموقع الجغرافي فقط للتطبيقات التي تعمل في المقدّمة. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
لن يتم إيقاف خدمة الموقع الجغرافي، ولكن سيقلل "مدير الموقع الجغرافي" جميع الطلبات المُرسَلة إلى مقدّمي الخدمات عندما يكون الجهاز غير تفاعلي. |
LocationSensor
أداة الاستشعار أو المنهجية المستخدَمة لتحديد الموقع الجغرافي.
عمليات التعداد | |
---|---|
UNKNOWN_SENSOR |
أداة الاستشعار غير محدّدة أو غير معروفة. |
GPS |
نظام تحديد المواقع العالمي (GPS) أو نظام تحديد المواقع العالمي (GPS) المدعوم. |
NETWORK |
نظام GPS مدعوم أو معرف برج الاتصالات أو نقطة وصول Wi-Fi. |
PASSIVE |
معرّف برج الاتصالات أو نقطة وصول WiFi. |
ROAD_SNAPPED_LOCATION_PROVIDER |
موقع يحدده الجهاز الجوّال ليكون موقع الطريق الأكثر احتمالاً. |
CUSTOMER_SUPPLIED_LOCATION |
موقع جغرافي يوفّره العميل من مصدر مستقل. يتم عادةً استخدام هذه القيمة للموقع الجغرافي الذي يتم تقديمه من مصادر أخرى غير الجهاز الجوّال الذي يشغل حزمة SDK لبرنامج التشغيل. إذا تم وصف المصدر الأصلي بإحدى قيم التعداد الأخرى، استخدِم تلك القيمة. المواقع الجغرافية المميزة بعلامة CUSTOMER_SUPPLIED_LOCATION يتم تقديمها عادةً عبر last_location.supplemental_location_sensor للمركبة. |
FLEET_ENGINE_LOCATION |
موقع جغرافي احتسبه Fleet Engine استنادًا إلى الإشارات المتاحة له. النتائج فقط. سيتم رفض هذه القيمة في حال تلقّيها في طلب. |
FUSED_LOCATION_PROVIDER |
مزوّد الموقع الجغرافي المدمج في Android |
CORE_LOCATION |
مقدم الموقع على أنظمة التشغيل Apple. |
PolylineFormatType
نوع تنسيق الخطوط المتعددة.
عمليات التعداد | |
---|---|
UNKNOWN_FORMAT_TYPE |
التنسيق غير محدد أو غير معروف. |
LAT_LNG_LIST_TYPE |
هذه قائمة بـ google.type.LatLng . |
ENCODED_POLYLINE_TYPE |
يشير ذلك المصطلح إلى مخطط متعدد الخطوط تم ترميزه باستخدام خوارزمية ضغط الخطوط المتعددة. لا تتوفّر إمكانية فك الترميز بعد. |
PowerSource
نوع الشاحن المستخدَم لشحن البطارية
عمليات التعداد | |
---|---|
UNKNOWN_POWER_SOURCE |
مصدر الطاقة غير معروف. |
POWER_SOURCE_AC |
مصدر الطاقة هو شاحن AC. |
POWER_SOURCE_USB |
مصدر الطاقة هو منفذ USB. |
POWER_SOURCE_WIRELESS |
مصدر الطاقة لاسلكي. |
POWER_SOURCE_UNPLUGGED |
البطارية غير متصلة. |
ReportBillableTripRequest
رسالة طلب ReportableTrip
الحقول | |
---|---|
name |
مطلوب. يجب أن يكون بالتنسيق |
country_code |
مطلوب. رمز البلد المؤلّف من حرفَين للبلد الذي تحدث فيه الرحلة. يتم تحديد السعر وفقًا لرمز البلد. |
platform |
المنصّة التي تمّ إصدار الطلب عليها. |
related_ids[] |
المعرّفات المرتبطة مباشرةً بالرحلة التي يتم الإبلاغ عنها وتكون هذه البطاقات عادةً أرقام تعريف (مثل أرقام تعريف الجلسات) لعمليات الحجز المسبق التي تم إجراؤها قبل توفّر معرّف الرحلة. الحد الأقصى لعدد |
solution_type |
تمثّل هذه السمة نوع حلّ "منصّة Google للتسويق" (على سبيل المثال، |
SolutionType
أداة اختيار أنواع الحلول المختلفة لرحلة تم الإبلاغ عنها
عمليات التعداد | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
القيمة التلقائية. بالنسبة إلى التوافق مع الأنظمة القديمة، ستستخدم واجهة برمجة التطبيقات ON_DEMAND_RIDESHARING_AND_DELIVERIES تلقائيًا، وهو أول نوع من الحلول المتوافقة. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
الحل هو رحلة مشاركة الرحلات والتوصيل عند الطلب. |
RequestHeader
يحتوي حقل RequestHeader على حقول شائعة لجميع طلبات استدعاء إجراء عن بُعد من خلال Fleet Engine.
الحقول | |
---|---|
language_code |
تمثّل هذه السمة رمز اللغة BCP-47، مثل en-US أو sr-Latn. لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. إذا لم يتم تحديد أي لغة، فقد يكون الرد بأي لغة، مع تفضيل اللغة الإنجليزية في حالة وجود مثل هذا الاسم. مثال على قيمة الحقل: |
region_code |
مطلوب. رمز CLDR للمنطقة التي صدر فيها الطلب مثال على قيمة الحقل: |
sdk_version |
يشير إلى إصدار حزمة تطوير البرامج (SDK) للاتصال، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، مثال: |
os_version |
يشير إلى إصدار نظام التشغيل الذي يتم تشغيل حزمة تطوير البرامج (SDK) للاتصال عليه. أمثلة على قيم الحقل: |
device_model |
طراز الجهاز الذي يتم تشغيل حزمة تطوير البرامج (SDK) للاتصال عليه أمثلة على قيم الحقل: |
sdk_type |
نوع حزمة SDK التي ترسل الطلب |
maps_sdk_version |
تمثّل هذه السمة إصدار MapSDK الذي تعتمد عليه حزمة SDK للاتصال، إذا كان ذلك منطبقًا. تنسيق الإصدار هو "major.minor.patch"، مثال: |
nav_sdk_version |
يشير إلى إصدار NavSDK الذي تعتمد عليه حزمة تطوير البرامج (SDK) للاتصال، إذا كان ذلك منطبقًا تنسيق الإصدار هو "major.minor.patch"، مثال: |
platform |
النظام الأساسي لحزمة تطوير البرامج (SDK) للاتصال |
manufacturer |
الشركة المصنّعة لجهاز Android من حزمة تطوير البرامج (SDK) للاتصال، ولا تنطبق إلا على حِزم تطوير البرامج (SDK) لنظام التشغيل Android. مثال على قيمة الحقل: |
android_api_level |
مستوى واجهة برمجة تطبيقات Android لحزمة تطوير البرامج (SDK) للاتصال، ولا ينطبق إلا على حِزم تطوير البرامج (SDK) لنظام التشغيل Android. مثال على قيمة الحقل: |
trace_id |
رقم تعريف اختياري يمكن تقديمه لأغراض التسجيل من أجل تحديد الطلب. |
النظام الأساسي
النظام الأساسي لحزمة تطوير البرامج (SDK) للاتصال.
عمليات التعداد | |
---|---|
PLATFORM_UNSPECIFIED |
القيمة التلقائية. يتم استخدام هذه القيمة في حال إسقاط المنصة. |
ANDROID |
تم إرسال الطلب من Android. |
IOS |
تم إرسال الطلب من جهاز iOS. |
WEB |
تم إرسال الطلب من الويب. |
SdkType
الأنواع المحتملة لحِزم SDK.
عمليات التعداد | |
---|---|
SDK_TYPE_UNSPECIFIED |
القيمة التلقائية. ويتم استخدام هذه القيمة في حال إسقاط sdk_type . |
CONSUMER |
حزمة SDK للاتصال هي المستهلك. |
DRIVER |
حزمة SDK للاتصال هي برنامج التشغيل. |
JAVASCRIPT |
حزمة تطوير البرامج (SDK) للاتصال هي JavaScript. |
SearchTripsRequest
رسالة طلب SearchTrips
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
parent |
مطلوب. يجب أن يكون بالتنسيق |
vehicle_id |
المركبة المرتبطة بالرحلات في الطلب وفي حال عدم تحديد هذه السمة، لا تتضمّن الرحلات التي تم إرجاعها ما يلي:
|
active_trips_only |
أمّا في حال ضبطها على "صحيح"، فسيتضمن الرد الرحلات التي تؤثر في مسار السائق. |
page_size |
وإذا لم يتم ضبط السياسة، سيقرر الخادم عدد النتائج التي سيتم عرضها. |
page_token |
اضبط هذه القيمة على قيمة تم عرضها سابقًا في |
minimum_staleness |
في حال تحديد وقت محدّد، يمكنك إرجاع الرحلات التي لم يتم تعديلها بعد الوقت |
SearchTripsResponse
رسالة رد SearchTrips.
الحقول | |
---|---|
trips[] |
تعرض هذه السمة قائمة الرحلات للمركبة المطلوبة. |
next_page_token |
مرر هذا الرمز المميز في SearchTripsRequest إلى صفحة خلال نتائج القائمة. تعرض واجهة برمجة التطبيقات قائمة رحلات عند كل مكالمة، وعندما لا تظهر أي نتائج أخرى، تكون قائمة الرحلات فارغة. |
SearchVehiclesRequest
رسالة طلب SearchVehicles
.
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
parent |
مطلوب. يجب أن يكون بالتنسيق |
pickup_point |
مطلوب. نقطة الاستلام التي تريد البحث فيها: |
dropoff_point |
مكان التسليم الذي اختاره العميل يجب ملء هذا الحقل إذا كان |
pickup_radius_meters |
مطلوب. تحدد نصف قطر بحث المركبة حول نقطة الاستلام. وسيتم عرض المركبات الواقعة ضمن نصف قطر البحث فقط. يجب أن تتراوح القيمة بين 400 و10,000 متر (ضمنًا). |
count |
مطلوب. تحدّد هذه السمة الحدّ الأقصى لعدد المركبات المطلوب إرجاعها. يجب أن تتراوح القيمة بين 1 و50 (ضمنًا). |
minimum_capacity |
مطلوب. لتحديد عدد الركاب الذين يتم أخذهم في الاعتبار للقيام برحلة ما. يجب أن تكون القيمة أكبر من واحد أو مساوية له. لا يتم تضمين محرِّك البحث في قيمة السعة. |
trip_types[] |
مطلوب. تمثّل هذه السمة نوع الرحلة المقترَحة. يجب أن تتضمن نوعًا واحدًا فقط. لا يُسمح باستخدام |
maximum_staleness |
يقصر البحث على المركبات التي أرسلت تحديثات الموقع الجغرافي إلى Fleet Engine خلال المدة المحددة فقط. ولا تُعتبر المركبات الثابتة التي لا تزال تنقل مواقعها قديمة. إذا لم يتم ضبط هذا الحقل، يستخدم الخادم خمس دقائق كقيمة تلقائية. |
vehicle_types[] |
مطلوب. يقصر البحث على المركبات من أحد الأنواع المحدّدة. يجب تحديد نوع مركبة واحد على الأقل. لا يُسمح بأنواع المركبات من الفئة |
required_attributes[] |
ويمكن للمتصلين إنشاء عمليات منطقية معقدة باستخدام أي مجموعة من الحقول
يقصر البحث على المركبات ذات السمات المحددة فقط. هذا الحقل هو عملية ربط/و. الحدّ الأقصى المسموح به لعدد السمات المطلوبة هو 50 سمة. يتطابق ذلك مع الحد الأقصى لعدد السمات المسموح بها في المركبة. |
required_one_of_attributes[] |
يقصر البحث على المركبات التي تتضمن سمة واحدة على الأقل من السمات المحددة في كل |
required_one_of_attribute_sets[] |
يوفّر على غرار
يحصر البحث على المركبات التي تتضمن جميع السمات في |
order_by |
مطلوب. لتحديد معيار الترتيب المطلوب للنتائج. |
include_back_to_back |
يشير ذلك إلى ما إذا كانت المركبات التي تشمل رحلة نشطة واحدة مؤهّلة لعملية البحث هذه. لا يتم استخدام هذا الحقل إلا عند عدم تحديد تكون القيمة التلقائية |
trip_id |
تشير هذه السمة إلى الرحلة المرتبطة بحدث |
current_trips_present |
يشير ذلك إلى ما إذا كانت المركبات التي تتضمن رحلات نشطة مؤهَّلة لعملية البحث هذه. ويجب ضبط هذه القيمة على قيمة أخرى غير |
filter |
اختياريّ. طلب بحث فلتر يتم تطبيقه عند البحث عن مركبات راجِع http://aip.dev/160 للاطّلاع على أمثلة عن بنية الفلاتر. تم تصميم هذا الحقل ليحلّ محلّ الحقول يعمل هذا الفلتر كعبارة AND مع قيود أخرى، مثل يُرجى العلم أنّ طلبات البحث المتاحة فقط تتعلّق بسمات المركبات (على سبيل المثال، ويتم أيضًا تخزين جميع السمات كسلاسل، وبالتالي فإنّ المقارنات الوحيدة المسموح بها مع السمات هي مقارنات السلاسل. للمقارنة مع القيم الرقمية أو المنطقية، يجب اقتباس القيم بشكل صريح ليتم التعامل معها كسلاسل (على سبيل المثال، |
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[] |
قائمة المركبات التي تستوفي معايير |
SpeedReadingInterval
مؤشر كثافة حركة المرور على جزء متجاورة من المسار. بالنظر إلى مسار يحتوي على النقاط P_0 وP_1 و... أو P_N (فهرس يستند إلى صفر)، تحدد SpeedReadingInterval الفاصل الزمني وتصف عدد الزيارات باستخدام الفئات التالية.
الحقول | |
---|---|
start_polyline_point_index |
فهرس البدء لهذا الفاصل الزمني في المسار. في ملف JSON، عندما يكون الفهرس 0، سيظهر الحقل فارغًا. |
end_polyline_point_index |
فهرس النهاية لهذا الفاصل الزمني في المسار. في ملف JSON، عندما يكون الفهرس 0، سيظهر الحقل فارغًا. |
speed |
سرعة حركة المرور في هذا الفاصل الزمني. |
السرعة
يشير ذلك المصطلح إلى تصنيف سرعة الخطوط المتعددة استنادًا إلى بيانات حركة المرور.
عمليات التعداد | |
---|---|
SPEED_UNSPECIFIED |
القيمة التلقائية. هذه القيمة غير مستخدمة. |
NORMAL |
تم رصد سرعة عادية، ولم يتم رصد أي حركة بطيئة. |
SLOW |
تم رصد حركة بطيئة، ولكن لم يحدث ازدحام مروري. |
TRAFFIC_JAM |
تم رصد ازدحام مروري. |
StopLocation
الموقع الجغرافي الفعلي الذي وقعت فيه المحطة (الاستلام/التسليم).
الحقول | |
---|---|
point |
مطلوب. تشير إلى الموقع الفعلي. |
timestamp |
يشير إلى وقت حدوث التوقّف. |
stop_time |
الإدخال فقط. تمّ الإيقاف. استخدِم حقل الطابع الزمني. |
TerminalLocation
تصف موقع نقطة وسيطة.
الحقول | |
---|---|
point |
مطلوب. تشير إلى موقع نقطة طريق الرحلة. |
terminal_point_id |
مهمل: حدِّد الحقل |
access_point_id |
مهمل: حدِّد الحقل |
trip_id |
تمّ الإيقاف. |
terminal_location_type |
متوقّفة نهائيًا: سيتضمّن النطاق |
TerminalPointId
متوقّفة نهائيًا: لم تعُد TerminalPoints متاحة في Fleet Engine. يمكنك استخدام TerminalLocation.point
كبديل.
الحقول | |
---|---|
value |
تمّ الإيقاف. |
حقل الاتحاد Id . تمّ الإيقاف. يمكن أن يكون Id واحدًا فقط مما يلي: |
|
place_id |
تمّ الإيقاف. |
generated_id |
تمّ الإيقاف. |
TrafficPolylineData
أحوال حركة المرور على طول مسار المركبة المتوقّع
الحقول | |
---|---|
traffic_rendering |
عرض متعدّد الخطوط يوضّح مدى سرعة حركة المرور في جميع المناطق على طول جزء واحد من رحلة العميل |
الرحلة
البيانات الوصفية للرحلة
الحقول | |
---|---|
name |
النتائج فقط. بالتنسيق "providers/{provider}/trips/{trip}" |
vehicle_id |
رقم تعريف المركبة التي تجري هذه الرحلة |
trip_status |
الحالة الحالية للرحلة |
trip_type |
نوع الرحلة. |
pickup_point |
تشير إلى الموقع الجغرافي الذي يشير فيه العميل إلى أنّه سيتم توصيل الطلب منه. |
actual_pickup_point |
الإدخال فقط. الموقع الجغرافي الفعلي وقت ومكان استلام العميل. هذا الحقل مخصّص لمقدّم الخدمة لتقديم ملاحظات حول معلومات الاستلام الفعلية. |
actual_pickup_arrival_point |
الإدخال فقط. الوقت الفعلي والموقع الجغرافي لوصول السائق إلى نقطة الاستلام هذا الحقل مخصّص لمقدّم الخدمة ليقدّم ملاحظات حول معلومات الوصول الفعلية إلى نقطة الاستلام. |
pickup_time |
النتائج فقط. سواء الوقت المقدر في المستقبل الذي سيتم فيه نقل الركاب أو الوقت الفعلي الذي تم التقاطهم فيه. |
intermediate_destinations[] |
محطّات متوسطة للتوقّف من أجل طلب الرحلات (بالإضافة إلى الاستلام والتوصيل) في البداية، لن تكون هذه الميزة متوفّرة للرحلات المشتركة. |
intermediate_destinations_version |
يشير هذا الحقل إلى آخر مرة تم فيها تعديل |
intermediate_destination_index |
عندما تكون قيمة الحقل " |
actual_intermediate_destination_arrival_points[] |
الإدخال فقط. الوقت الفعلي والموقع الجغرافي لوصول السائق إلى وجهة متوسطة. هذا الحقل مخصّص لموفّر الخدمة لتقديم ملاحظات عن معلومات الوصول الفعلية إلى الوجهات المتوسطة. |
actual_intermediate_destinations[] |
الإدخال فقط. الوقت والمكان الفعليان الذي تم فيه نقل العميل من وجهة وسيطة. هذا الحقل مخصّص لموفّر الخدمة لتقديم ملاحظات حول معلومات الاستلام الفعلية في الوجهات المتوسطة. |
dropoff_point |
الموقع الجغرافي الذي يشير فيه العميل إلى أنّه سيتم تسليمه |
actual_dropoff_point |
الإدخال فقط. الوقت والمكان الفعليان الذي انزل فيه العميل إلى الفندق. هذا الحقل مخصّص لموفّر الخدمة لتقديم ملاحظات حول معلومات الانسحاب الفعلية. |
dropoff_time |
النتائج فقط. إما الوقت المستقبلي المقدر الذي سيتم فيه تسليم الركاب في الوجهة النهائية، أو الوقت الفعلي الذي تم فيه تسليمهم. |
remaining_waypoints[] |
النتائج فقط. تمثّل هذه السمة المسار الكامل من الموقع الجغرافي الحالي إلى نقطة التسليم. يمكن أن يتضمن هذا المسار نقاط الطريق من الرحلات الأخرى. |
vehicle_waypoints[] |
يتيح هذا الحقل الترتيب اليدوي لنقاط الطريق للرحلة. وتحتوي على جميع نقاط الطريق المتبقية للمركبة المحدّدة، بالإضافة إلى نقاط طريق الركوب والتسليم لهذه الرحلة. إذا لم يتم تخصيص الرحلة لمركبة، يتجاهل Fleet Engine هذا الحقل. لأسباب تتعلق بالخصوصية، لا تتم تعبئة هذا الحقل إلا من خلال الخادم في مكالمات |
route[] |
النتائج فقط. المسار المتوقع لهذه الرحلة إلى أول إدخال في linked_waypoints. يُرجى العِلم أنّ نقطة الطريق الأولى قد تنتمي إلى رحلة مختلفة. |
current_route_segment |
النتائج فقط. مسار مشفر إلى نقطة الطريق التالية. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. لا تتوفّر إمكانية فك الترميز بعد. |
current_route_segment_version |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل المسار. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. |
current_route_segment_traffic |
النتائج فقط. تشير هذه السمة إلى أحوال حركة المرور على طول ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. |
current_route_segment_traffic_version |
النتائج فقط. يشير هذا الحقل إلى آخر مرة تم فيها تعديل ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. |
current_route_segment_end_point |
النتائج فقط. تمثّل هذه السمة النقطة المسارية التي ينتهي عندها |
remaining_distance_meters |
النتائج فقط. مسافة القيادة المتبقية في حقل |
eta_to_first_waypoint |
النتائج فقط. الوقت المقدر للوصول إلى نقطة الطريق التالية (الإدخال الأول في الحقل |
remaining_time_to_first_waypoint |
النتائج فقط. المدة التي تبدأ من وقت إرجاع بيانات الرحلة إلى الوقت في |
remaining_waypoints_version |
النتائج فقط. تشير إلى آخر مرة تم فيها تغيير |
remaining_waypoints_route_version |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل |
number_of_passengers |
غير قابل للتغيير. يشير إلى عدد الركاب في هذه الرحلة ولا يشمل السائق. يجب أن تتوفّر في المركبة السعة المتاحة ليتم إرجاعها في استجابة |
last_location |
النتائج فقط. يشير إلى آخر موقع تم الإبلاغ عنه للمركبة على طول المسار. |
last_location_snappable |
النتائج فقط. يشير هذا الحقل إلى ما إذا كان من الممكن محاذاة |
view |
المجموعة الفرعية من حقول "الرحلة" التي تتم تعبئتها وكيفية تفسيرها. |
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 |
موقع هذه النقطة. |
trip_id |
الرحلة المرتبطة بهذه النقطة. |
waypoint_type |
الدور الذي تؤديه هذه النقطة في هذه الرحلة، مثل الركوب أو التسليم. |
path_to_waypoint[] |
يشير ذلك المصطلح إلى المسار من نقطة الطريق السابقة إلى نقطة الطريق الحالية. غير محدّد للنقطة الطريق الأولى في القائمة. تتم تعبئة هذا الحقل عند طلبه فقط. |
encoded_path_to_waypoint |
المسار المشفر من النقطة الوسيطة السابقة إلى النقطة الوسيطة الحالية. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لبرنامج التشغيل وحزمة تطوير البرامج (SDK) الخاصة بالمستهلك. لا تتوفّر إمكانية فك الترميز بعد. |
traffic_to_waypoint |
أحوال حركة المرور على طول المسار إلى هذه النقطة يُرجى ملاحظة أنّ حركة المرور لا تتوفّر إلا لعملاء حلول الرحلات والتسليمات في "منصة خرائط Google". |
distance_meters |
مسافة المسار من النقطة الوسيطة السابقة إلى النقطة الوسيطة الحالية. غير محدّد للنقطة الطريق الأولى في القائمة. |
eta |
الوقت المقدَّر للوصول إلى هذه النقطة. غير محدّد للنقطة الطريق الأولى في القائمة. |
duration |
مدة الرحلة من نقطة الطريق السابقة إلى هذه النقطة. غير محدّد للنقطة الطريق الأولى في القائمة. |
UpdateTripRequest
رسالة طلب UpdateTrip.
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
name |
مطلوب. يجب أن يكون بالتنسيق |
trip |
مطلوب. الرحلة المرتبطة بالتحديث. يتولى Fleet Engine الاحتفاظ بالحقول التالية. يُرجى عدم تعديلها باستخدام Trip.update.
عند تعديل عند تحديد لتجنّب شرط سباق للرحلات ذات الوجهات المتعددة، عليك توفير |
update_mask |
مطلوب. قناع الحقل الذي يشير إلى الحقول في الرحلة المطلوب تعديلها. يجب أن يحتوي |
UpdateVehicleAttributesRequest
رسالة طلب UpdateVehicleAttributes
.
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
name |
مطلوب. يجب أن يكون بالتنسيق |
attributes[] |
مطلوب. سمات المركبة المطلوب تعديلها. ولا يتم تعديل أو إزالة السمات غير المذكورة. |
UpdateVehicleAttributesResponse
رسالة رد واحدة (UpdateVehicleAttributes
).
الحقول | |
---|---|
attributes[] |
مطلوب. القائمة الكاملة لسمات المركبات، بما في ذلك السمات الجديدة والمعدّلة والتي لم يتم تغييرها |
UpdateVehicleRequest
رسالة طلب UpdateVehicle
الحقول | |
---|---|
header |
عنوان طلب Fleet Engine العادي. |
name |
مطلوب. يجب أن يكون بالتنسيق |
vehicle |
مطلوب. قيم الكيان
إذا تم تعديل الحقل وبالمثل، يمكن تعديل الحقل |
update_mask |
مطلوب. قناع حقل يشير إلى حقول |
مركبة
البيانات الوصفية للمركبة
الحقول | |
---|---|
name |
النتائج فقط. الاسم الفريد لهذه المركبة التنسيق هو |
vehicle_state |
حالة المركبة |
supported_trip_types[] |
أنواع الرحلات المتوافقة مع هذه المركبة |
current_trips[] |
النتائج فقط. قائمة برحلات " |
last_location |
آخر موقع جغرافي تم الإبلاغ عنه للمركبة |
maximum_capacity |
تمثّل هذه السمة إجمالي عدد الركاب الذين يمكن أن تحملهم هذه المركبة. ولا يتمّ اعتبار عامل التشغيل ضمن هذه القيمة. يجب أن تكون هذه القيمة أكبر من واحد أو مساوية له. |
attributes[] |
تمثّل هذه السمة قائمة سمات المركبات. يمكن أن تتضمّن المركبة 100 سمة كحدّ أقصى، ويجب أن تحتوي كل سمة على مفتاح فريد. |
vehicle_type |
مطلوب. تعرض هذه السمة نوع هذه المركبة. يمكن استخدامها لفلترة المركبات في |
license_plate |
معلومات لوحة ترخيص المركبة |
route[] |
متوقّفة نهائيًا: استخدِم |
current_route_segment |
الخطوط المتعددة التي تحدد المسار الذي ينوي تطبيق السائق اتباعه إلى نقطة الطريق التالية. ويتم أيضًا عرض هذه القائمة بعملة ملاحظة: هذا الحقل مخصَّص فقط لاستخدام Driver SDK. لا تتوفّر إمكانية فك الترميز بعد. |
current_route_segment_traffic |
الإدخال فقط. يستخدم Fleet Engine هذه المعلومات لتحسين مشاركة الرحلة. ملاحظة: هذا الحقل مخصَّص فقط لاستخدام Driver SDK. |
current_route_segment_version |
النتائج فقط. الوقت الذي تم فيه ضبط السمة |
current_route_segment_end_point |
تمثّل هذه السمة النقطة المسارية التي ينتهي عندها |
remaining_distance_meters |
مسافة القيادة المتبقية لـ |
eta_to_first_waypoint |
الوقت المقدّر للوصول إلى الإدخال الأول في الحقل عند تعديل مركبة، تكون الأولوية للسمة |
remaining_time_seconds |
الإدخال فقط. الوقت المتبقّي لقيادة السيارة " عند تعديل مركبة، تكون الأولوية للسمة |
waypoints[] |
تمثّل هذه السمة نقاط الطريق المتبقية لهذه المركبة. |
waypoints_version |
النتائج فقط. آخر مرة تم فيها تعديل الحقل |
back_to_back_enabled |
يشير هذا الحقل إلى ما إذا كان السائق يقبل الرحلات المتتالية. إذا كانت |
navigation_status |
حالة التنقّل في المركبة |
device_settings |
الإدخال فقط. معلومات حول الإعدادات في الجهاز الجوّال الذي يستخدمه السائق. |
VehicleType
تمثّل هذه السمة نوع المركبة.
الحقول | |
---|---|
category |
فئة نوع المركبة |
الفئة
فئات أنواع المركبات
عمليات التعداد | |
---|---|
UNKNOWN |
الخيار التلقائي، يُستخدَم لفئات المركبات غير المحدَّدة أو غير المعروفة. |
AUTO |
سيارة. |
TAXI |
تمثّل هذه السمة أي مركبة تُستخدم كسيارة أجرة (عادةً ما تكون مرخّصة أو خاضعة للرقابة). |
TRUCK |
بشكل عام، تكون المركبات ذات سعة تخزين كبيرة. |
TWO_WHEELER |
دراجة نارية أو دراجة نارية أو مركبة أخرى ذات عجلتين |
BICYCLE |
نقل يعمل بآلية بشرية |
PEDESTRIAN |
ناقل إنسان يسير على الأقدام أو يركض في العادة على طول ممرات المشاة |
VehicleAttribute
تصف سمة المركبة على أنّها زوج المفتاح/القيمة. "key:value" لا يمكن أن يتجاوز طول السلسلة 256 حرفًا.
الحقول | |
---|---|
key |
مفتاح السمة. لا يجوز أن تحتوي المفاتيح على علامة النقطتين (:). |
value |
قيمة السمة. |
حقل الاتحاد vehicle_attribute_value . قيمة السمة، يمكن أن تكون في سلسلة أو قيمة منطقية أو نوع مزدوج. يمكن أن يكون vehicle_attribute_value واحدًا فقط مما يلي: |
|
string_value |
قيمة السمة المكتوبة بالسلسلة ملاحظة: هذا مماثل للحقل |
bool_value |
قيمة السمة المكتوبة بطريقة منطقية |
number_value |
قيمة سمة من نوعين |
VehicleAttributeList
تمثّل هذه السمة نوع بيانات قائمة بقوائم لسمات المركبات.
الحقول | |
---|---|
attributes[] |
قائمة بالسمات في هذه المجموعة. |
VehicleLocation
الموقع الجغرافي للمركبة وسرعتها وعنوانها في وقت محدّد
الحقول | |
---|---|
location |
الموقع الجغرافي للمركبة عند إرسالها إلى Fleet Engine، يكون موقع المركبة هو موقع نظام تحديد المواقع العالمي (GPS). وعند تلقّيه كردّ، يمكن أن يكون الموقع الجغرافي للمركبة إمّا موقعًا جغرافيًا لنظام تحديد المواقع العالمي (GPS) أو موقعًا تكميليًا أو أي موقع جغرافي مقدَّر آخر. تم تحديد المصدر في |
horizontal_accuracy |
متوقّفة نهائيًا: استخدِم |
latlng_accuracy |
دقة |
heading |
اتجاه المركبة التي تتحرك بالدرجات 0 يمثل الشمال. النطاق الصالح هو [0,360). |
bearing_accuracy |
متوقّفة نهائيًا: استخدِم |
heading_accuracy |
درجة دقة |
altitude |
الارتفاع بالأمتار فوق WGS84 |
vertical_accuracy |
متوقّفة نهائيًا: استخدِم |
altitude_accuracy |
دقة |
speed_kmph |
سرعة المركبة بالكيلومتر في الساعة. متوقّفة نهائيًا: استخدِم |
speed |
سرعة المركبة بالمتر/الثانية |
speed_accuracy |
دقة |
update_time |
الوقت الذي أبلغَت فيه أداة الاستشعار عن |
server_time |
النتائج فقط. الوقت الذي تلقّى فيه الخادم معلومات الموقع الجغرافي. |
location_sensor |
موفِّر بيانات الموقع الجغرافي (على سبيل المثال، |
is_road_snapped |
ما إذا كان قد تم محاذاة |
is_gps_sensor_enabled |
الإدخال فقط. يشير إلى ما إذا كانت أداة استشعار نظام تحديد المواقع العالمي (GPS) مُفعَّلة على الجهاز الجوّال. |
time_since_update |
الإدخال فقط. الوقت (بالثواني) منذ إرسال هذا الموقع لأول مرة إلى الخادم. سيكون هذا صفرًا في أول تحديث. في حال لم يكن الوقت معروفًا (على سبيل المثال، عند إعادة تشغيل التطبيق)، تتم إعادة ضبط هذه القيمة على الصفر. |
num_stale_updates |
الإدخال فقط. متوقّف: يتم الآن استخدام إشارات أخرى لتحديد ما إذا كان الموقع قديمًا أم لا. |
raw_location |
الموقع الجغرافي للمركبة الأولي (لا تتم معالجته بواسطة قاذف الطريق) |
raw_location_time |
الطابع الزمني المرتبط بالموقع الجغرافي الأولي |
raw_location_sensor |
مصدر الموقع الجغرافي الأولي وتكون القيمة التلقائية هي |
raw_location_accuracy |
دقة |
supplemental_location |
الموقع التكميلي الذي يوفره التطبيق المدمج |
supplemental_location_time |
الطابع الزمني المرتبط بالموقع الجغرافي التكميلي |
supplemental_location_sensor |
مصدر الموقع التكميلي وتكون القيمة التلقائية هي |
supplemental_location_accuracy |
دقة |
road_snapped |
متوقّفة نهائيًا: استخدِم |
VehicleMatch
تحتوي على المركبة والتقديرات ذات الصلة لمركبة تطابق نقاط الرحلات النشطة للمركبة "SearchVehiclesRequest
".
الحقول | |
---|---|
vehicle |
مطلوب. مركبة تطابق الطلب |
vehicle_pickup_eta |
الوقت المقدَّر لقيادة المركبة في نقطة الاستلام المحدّدة في الطلب تشير القيمة الفارغة إلى تعذُّر احتساب الوقت المقدّر للوصول للمركبة. إذا كانت قيمة |
vehicle_pickup_distance_meters |
المسافة من الموقع الجغرافي الحالي للمركبة إلى نقطة الاستلام المحدّدة في الطلب، بما في ذلك أي نقاط متوسطة للاستلام أو التسليم للرحلات الحالية وتضم هذه المسافة مسافة القيادة (المسارات) المحسوبة، بالإضافة إلى مسافة الخط المستقيم بين نقطة نهاية التنقل ونقطة الاستلام المطلوبة. (عادةً ما تكون المسافة بين نقطة نهاية التنقل ونقطة الاستلام المطلوبة صغيرة). تشير القيمة الفارغة إلى وجود خطأ في حساب المسافة. |
vehicle_pickup_straight_line_distance_meters |
مطلوب. المسافة المستقيمة بين المركبة ونقطة الاستلام المحدّدة في الطلب. |
vehicle_dropoff_eta |
الوقت المقدَّر لقيادة المركبة بالكامل عند الوصول إلى نقطة التسليم المحدّدة في الطلب ويشمل الوقت المقدر للوصول التوقف عند أي نقاط طريق قبل |
vehicle_pickup_to_dropoff_distance_meters |
المسافة القيادة للمركبة (بالأمتار) من نقطة الاستلام إلى نقطة التسليم المحدّدة في الطلب تكون المسافة بين النقطتين فقط ولا تشمل الموقع الجغرافي للمركبة أو أي نقاط أخرى يجب زيارتها قبل أن تزور المركبة نقطة الركوب أو نقطة التسليم. لن تتم تعبئة القيمة إلا عند تحديد |
trip_type |
مطلوب. نوع رحلة الطلب الذي تم استخدامه لاحتساب الوقت المقدّر للوصول إلى نقطة الاستلام |
vehicle_trips_waypoints[] |
القائمة المرتبة لنقاط الطريق المستخدمة لحساب الوقت المقدر للوصول. تشمل القائمة الموقع الجغرافي للمركبة ونقاط الاستلام للرحلات النشطة الخاصة بالمركبة ونقاط الاستلام الواردة في الطلب. تشير القائمة الفارغة إلى تعذُّر احتساب الوقت المقدّر للوصول للمركبة. |
vehicle_match_type |
تمثّل هذه السمة نوع المركبة المطابقة. |
requested_ordered_by |
تمثّل هذه السمة الطلب الذي تم طلبه لترتيب المركبات المتطابقة. |
ordered_by |
الطلب الفعلي الذي تم استخدامه لهذه المركبة. عادةً ما يتطابق هذا مع ترتيب "order_by" من الطلب؛ ولكن في بعض الحالات مثل الخطأ الداخلي في الخادم، قد يتم استخدام طريقة مختلفة (مثل |
VehicleMatchType
تمثّل هذه السمة نوع التطابق بين المركبة.
عمليات التعداد | |
---|---|
UNKNOWN |
نوع مطابقة مركبة غير معروف |
EXCLUSIVE |
ما مِن رحلة مخصصة للمركبة حاليًا ويمكنها المتابعة إلى نقطة الاستلام. |
BACK_TO_BACK |
المركبة مخصّصة حاليًا لرحلة، ولكن يمكنها المتابعة إلى نقطة الركوب بعد إكمال الرحلة الجارية. وتراعي حسابات الوقت المقدّر للوصول والمسافة الرحلة الحالية. |
CARPOOL |
تتّسع المركبة للرحلة المشتركة. |
CARPOOL_BACK_TO_BACK |
ستُنهي المركبة رحلتها الحالية النشطة قبل المتابعة إلى نقطة الاستلام. وتراعي حسابات الوقت المقدّر للوصول والمسافة الرحلة الحالية. |
VehicleState
حالة Vehicle
.
عمليات التعداد | |
---|---|
UNKNOWN_VEHICLE_STATE |
الخيار التلقائي، يُستخدم في حالات المركبات غير المحدّدة أو غير المعروفة. |
OFFLINE |
لا تقبل المركبة رحلات جديدة. ملاحظة: قد تستمر المركبة في العمل في هذه الحالة أثناء إكمال رحلة مخصصة لها. |
ONLINE |
تقبل المركبة رحلات جديدة. |
VisualTrafficReportPolylineRendering
يصف كيف يجب على العملاء تلوين جزء واحد من الخطوط المتعددة على طول المسار.
الحقول | |
---|---|
road_stretch[] |
اختياريّ. امتدادات الطرق التي يجب عرضها على طول الخطوط المتعددة. يضمن عدم تداخل الامتدادات، ولا يعني بالضرورة امتداد المسار بالكامل. في حالة عدم وجود امتداد الطريق إلى النمط، يجب على العميل تطبيق الإعداد الافتراضي للمسار. |
RoadStretch
امتداد واحد للطريق يجب عرضه.
الحقول | |
---|---|
style |
مطلوب. النمط المراد تطبيقه. |
offset_meters |
مطلوب. يجب تطبيق النمط بين |
length_meters |
مطلوب. طول المسار حيث يتم تطبيق النمط. |
النمط
نمط حركة المرور، الذي يشير إلى سرعة حركة المرور.
عمليات التعداد | |
---|---|
STYLE_UNSPECIFIED |
لم يتم اختيار أي نمط. |
SLOWER_TRAFFIC |
حركة المرور بطيئة |
TRAFFIC_JAM |
هناك ازدحام مروري. |
النقطة الوسيطة
يصف هذا المقياس النقاط المتوسطة على طول مسار VehicleMatch
في SearchVehiclesResponse
. ويتم تمثيل هذا المفهوم على أنّه TripWaypoint
في جميع نقاط النهاية الأخرى.
الحقول | |
---|---|
lat_lng |
موقع هذه النقطة. |
eta |
الوقت المقدَّر لوصول المركبة إلى هذه النقطة. |
WaypointType
تمثّل هذه السمة نوع النقطة الوسيطة.
عمليات التعداد | |
---|---|
UNKNOWN_WAYPOINT_TYPE |
نوع نقطة طريق غير معروف أو غير محدّد. |
PICKUP_WAYPOINT_TYPE |
نقاط الطرق لتوصيل الركاب أو العناصر. |
DROP_OFF_WAYPOINT_TYPE |
نقاط الطرق لإنزال الركاب أو العناصر. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
نقاط الطرق للوجهات المتوسطة في رحلة متعددة الوجهات |