الفهرس
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) أو نظام تحديد المواقع العالمي المساعد. |
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. |
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 |
مطلوبة. يجب استخدام التنسيق |
country_code |
مطلوبة. رمز البلد المكوّن من حرفين للبلد الذي تجري فيه الرحلة. يتم تحديد السعر وفقًا لرمز البلد. |
platform |
النظام الأساسي الذي تم إصدار الطلب من خلاله. |
related_ids[] |
المعرّفات المرتبطة مباشرةً بالرحلة التي يتم الإبلاغ عنها وتكون هذه عادةً أرقام تعريف (مثل أرقام تعريف الجلسات) لعمليات الحجز المُسبَق التي تم إجراؤها قبل توفُّر رقم تعريف الرحلة. الحد الأقصى لعدد |
solution_type |
تمثّل هذه السمة نوع حلّ المنتج في "منصّة Google للتسويق" (على سبيل المثال، |
SolutionType
أداة اختيار لأنواع الحلول المختلفة لرحلة تم الإبلاغ عنها
عمليات التعداد | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
القيمة التلقائية. للتوافق مع الأنظمة القديمة، ستستخدم واجهة برمجة التطبيقات ON_DEMAND_RIDESHARING_AND_DELIVERIES تلقائيًا، وهو أول نوع من الحلول المتوافقة. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
ويتمثل الحل في رحلة تسليم ومشاركة الرحلات عند الطلب. |
RequestHeader
يحتوي عنوان الطلب على حقول مشتركة بين كل طلبات استدعاء إجراء عن بُعد (RPC) في 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) للاتصال هي Driver. |
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[] |
النتائج فقط. المسار المتوقَّع لهذه الرحلة إلى المدخل الأول في بقية نقاط_الطريق. تجدر الإشارة إلى أنّ نقطة المسار الأولى قد تنتمي إلى رحلة مختلفة. |
current_route_segment |
النتائج فقط. مسار مشفر إلى نقطة الطريق التالية. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال Driver SDK و"SDK للمستهلكين". لا تتوفّر إمكانية فك الترميز بعد. |
current_route_segment_version |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل المسار. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال Driver SDK و"SDK للمستهلكين". |
current_route_segment_traffic |
النتائج فقط. تشير إلى أحوال حركة المرور على طول ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال Driver SDK و"SDK للمستهلكين". |
current_route_segment_traffic_version |
النتائج فقط. يشير إلى آخر مرة تم فيها تعديل ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال Driver 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 |
المسار المشفر من نقطة الطريق السابقة إلى نقطة الطريق الحالية. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال Driver SDK و"SDK للمستهلكين". لا تتوفّر إمكانية فك الترميز بعد. |
traffic_to_waypoint |
أحوال حركة المرور على طول المسار إلى هذه النقطة. لاحظ أن حركة المرور لا تتوفر إلا لعملاء حلول الرحلات والتسليمات في "منصة خرائط Google". |
distance_meters |
مسافة المسار من نقطة الطريق السابقة إلى نقطة الطريق الحالية. غير معرَّفة لأول نقطة طريق في القائمة. |
eta |
الوقت المقدَّر للوصول إلى نقطة الطريق هذه. غير معرَّفة لأول نقطة طريق في القائمة. |
duration |
مدة الرحلة من نقطة الطريق السابقة إلى هذه النقطة. غير معرَّفة لأول نقطة طريق في القائمة. |
UpdateTripRequest
رسالة طلب تحديث الرحلة
الحقول | |
---|---|
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 |
الخطوط المتعددة التي تحدِّد المسار الذي يريد تطبيق السائق الانتقال إليه إلى نقطة الطريق التالية يتم عرض هذه القائمة أيضًا في ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لخدمة Drive. لا تتوفّر إمكانية فك الترميز بعد. |
current_route_segment_traffic |
الإدخال فقط. يستخدم Fleet Engine هذه المعلومات لتحسين مشاركة الرحلة. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لخدمة Drive. |
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 |
نقاط الطرق للوجهات المتوسطة في رحلة متعددة الوجهات. |