- المرجع: مركبة
- VehicleState
- VehicleAttribute
- VehicleType
- Category (الفئة)
- LicensePlate
- TrafficPolylineData
- VisualTrafficReportPolylineRendering
- RoadStretch
- النمط
- NavigationStatus
- DeviceSettings
- LocationPowerSaveMode
- BatteryInfo
- BatteryStatus
- PowerSource
- الطُرق
المرجع: مركبة
البيانات الوصفية للمركبة
تمثيل JSON |
---|
{ "name": string, "vehicleState": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. تشير هذه السمة إلى الاسم الفريد لهذه المركبة. التنسيق هو |
vehicleState |
حالة المركبة |
supportedTripTypes[] |
أنواع الرحلات التي تتيحها هذه المركبة |
currentTrips[] |
النتائج فقط. قائمة برحلات |
lastLocation |
تاريخ آخر موقع جغرافي تم الإبلاغ عنه للمركبة |
maximumCapacity |
تمثّل هذه السمة إجمالي عدد ركاب هذه المركبة. لم يتم وضع السائق في هذه القيمة. يجب أن تكون هذه القيمة أكبر من واحد أو مساوية له. |
attributes[] |
قائمة سمات المركبات يمكن أن تحتوي المركبة على 100 سمة كحد أقصى، ويجب أن يكون لكل سمة مفتاح فريد. |
vehicleType |
مطلوبة. تعرض هذه السمة نوع هذه المركبة. يمكن استخدامها لفلترة المركبات في نتيجتَين ( |
licensePlate |
معلومات لوحة ترخيص المركبة |
route[] |
مهملة: يمكنك استخدام |
currentRouteSegment |
الخطوط المتعددة التي تحدِّد المسار الذي يريد تطبيق السائق الانتقال إليه إلى نقطة الطريق التالية يتم عرض هذه القائمة أيضًا في ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لخدمة Drive. لا تتوفّر إمكانية فك الترميز بعد. |
currentRouteSegmentTraffic |
الإدخال فقط. يستخدم Fleet Engine هذه المعلومات لتحسين مشاركة الرحلة. ملاحظة: هذا الحقل مخصّص فقط للاستخدام من خلال حزمة تطوير البرامج (SDK) لخدمة Drive. |
currentRouteSegmentVersion |
النتائج فقط. الوقت الذي تم فيه ضبط طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
currentRouteSegmentEndPoint |
نقطة الطريق التي ينتهي عندها |
remainingDistanceMeters |
مسافة القيادة المتبقية للمسافة |
etaToFirstWaypoint |
الوقت المقدر للوصول إلى الإدخال الأول في حقل عند تعديل مركبة، تكون الأولوية للقاعدة طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
remainingTimeSeconds |
الإدخال فقط. الوقت المتبقّي للقيادة في عند تعديل مركبة، تكون الأولوية للقاعدة |
waypoints[] |
نقاط الطريق المتبقية المخصّصة لهذه المركبة |
waypointsVersion |
النتائج فقط. آخر مرة تم فيها تعديل الحقل " طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
backToBackEnabled |
تشير هذه السمة إلى ما إذا كان السائق يقبل الرحلات المتتالية. إذا كانت السمة |
navigationStatus |
حالة التنقّل في المركبة |
deviceSettings |
الإدخال فقط. معلومات حول الإعدادات في الجهاز الجوّال التي يستخدمها برنامج التشغيل. |
VehicleState
تمثّل هذه السمة حالة Vehicle
.
عمليات التعداد | |
---|---|
UNKNOWN_VEHICLE_STATE |
الخيار التلقائي، ويتم استخدامه مع حالات المركبات غير المحدّدة أو غير المعروفة. |
OFFLINE |
لا تقبل المركبة الرحلات الجديدة. ملاحظة: يمكن أن تستمر المركبة في العمل في هذه الولاية أثناء إكمال رحلة مخصصة لها. |
ONLINE |
تقبل المركبة الرحلات الجديدة. |
VehicleAttribute
لوصف سمة مركبة بأنّها زوج المفتاح/القيمة لا يمكن أن يتجاوز طول السلسلة "key:value" 256 حرفًا.
تمثيل JSON |
---|
{ "key": string, "value": string, // Union field |
الحقول | |
---|---|
key |
مفتاح السمة. لا يجوز أن تحتوي المفاتيح على علامة النقطتين الرأسيتين (:). |
value |
تمثّل هذه السمة قيمة السمة. |
حقل الاتحاد vehicle_attribute_value يمكن أن تكون قيمة السمة في سلسلة أو قيمة منطقية أو نوع مزدوج. يمكن أن يكون الحقل "vehicle_attribute_value " واحدًا فقط مما يلي: |
|
stringValue |
قيمة السمة المكتوبة بسلسلة ملاحظة: يتطابق هذا تمامًا مع الحقل |
boolValue |
قيمة سمة مكتوبة من الناحية المنطقية |
numberValue |
قيمة سمة مكتوبة بنمط مزدوج. |
VehicleType
تمثّل هذه السمة نوع المركبة.
تمثيل JSON |
---|
{
"category": enum ( |
الحقول | |
---|---|
category |
فئة نوع المركبة |
الفئة
فئات أنواع المركبات
عمليات التعداد | |
---|---|
UNKNOWN |
الخيار التلقائي، ويتم استخدامه لفئات المركبات غير المحدّدة أو غير المعروفة. |
AUTO |
سيارة. |
TAXI |
أيّ مركبة تعمل كسيارة أجرة (عادةً ما تكون مرخَّصة أو خاضعة للرقابة). |
TRUCK |
بوجه عام، هي مركبة ذات سعة تخزين كبيرة. |
TWO_WHEELER |
دراجة نارية أو دراجة نارية أو أي مركبة أخرى ذات عجلتين |
BICYCLE |
وسائل النقل التي يشغّلها الإنسان |
PEDESTRIAN |
ناقل بشري، عادةً ما يمشي أو يركض، يتنقل على طول مسارات المشاة. |
LicensePlate
تعرض هذه السمة معلومات لوحة ترخيص المركبة. لتجنّب تخزين معلومات تحديد الهوية الشخصية، يتم تخزين الحد الأدنى من المعلومات حول لوحة الترخيص كجزء من الكيان.
تمثيل JSON |
---|
{ "countryCode": string, "lastCharacter": string } |
الحقول | |
---|---|
countryCode |
مطلوبة. رمز CLDR للبلد/المنطقة على سبيل المثال، |
lastCharacter |
الرقم الأخير من لوحة ترخيص المركبة أو "-1" للإشارة إلى عدم وجود أي قيمة رقمية في لوحة ترخيص المركبة.
|
TrafficPolylineData
أحوال حركة المرور على طول مسار المركبة المتوقع
تمثيل JSON |
---|
{
"trafficRendering": {
object ( |
الحقول | |
---|---|
trafficRendering |
عرض خطوط متعددة لسرعة حركة المرور لجميع المناطق على طول امتداد واحد من رحلة العميل. |
VisualTrafficReportPolylineRendering
يصف كيف يجب على العملاء تلوين جزء واحد من الخطوط المتعددة على طول المسار.
تمثيل JSON |
---|
{
"roadStretch": [
{
object ( |
الحقول | |
---|---|
roadStretch[] |
اختياريّ. امتدادات الطريق التي يجب عرضها على طول الخطوط المتعددة. ومن المؤكد أن خطوط الامتداد غير متداخلة، ولا تنطبق بالضرورة على المسار الكامل. في حالة عدم وجود امتداد للطريق، يجب على العميل تطبيق الإعداد الافتراضي للمسار. |
RoadStretch
امتداد طريق واحد يجب عرضه.
تمثيل JSON |
---|
{
"style": enum ( |
الحقول | |
---|---|
style |
مطلوبة. النمط المطلوب تطبيقه. |
offsetMeters |
مطلوبة. يجب تطبيق النمط بين |
lengthMeters |
مطلوبة. طول المسار حيث يتم تطبيق النمط. |
النمط
نمط حركة المرور الذي يشير إلى سرعة حركة المرور
عمليات التعداد | |
---|---|
STYLE_UNSPECIFIED |
لم يتم اختيار أي نمط. |
SLOWER_TRAFFIC |
حركة المرور بطيئة. |
TRAFFIC_JAM |
هناك ازدحام مروري. |
DeviceSettings
معلومات حول الإعدادات المختلفة على الجهاز الجوّال.
تمثيل JSON |
---|
{ "locationPowerSaveMode": enum ( |
الحقول | |
---|---|
locationPowerSaveMode |
آلية عمل ميزات الموقع الجغرافي على الجهاز عندما تكون ميزة "توفير شحن البطارية" مفعَّلة |
isPowerSaveMode |
ما إذا كان الجهاز في وضع توفير الطاقة حاليًا. |
isInteractive |
ما إذا كان الجهاز في حالة تفاعلية. |
batteryInfo |
معلومات حول حالة البطارية |
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 |
لن يتم إيقاف خدمة الموقع الجغرافي، إلا أنّ ميزة "إدارة الموقع الجغرافي" ستتحكّم في جميع الطلبات الموجّهة إلى مقدّمي الخدمات عندما يكون الجهاز غير تفاعلي. |
BatteryInfo
معلومات حول بطارية الجهاز
تمثيل JSON |
---|
{ "batteryStatus": enum ( |
الحقول | |
---|---|
batteryStatus |
حالة البطارية، سواء كانت ممتلئة أو قيد الشحن وما إلى ذلك |
powerSource |
حالة مصدر طاقة البطارية |
batteryPercentage |
نسبة شحن البطارية الحالية [0-100]. |
BatteryStatus
حالة البطارية، سواء كانت ممتلئة أو قيد الشحن وما إلى ذلك
عمليات التعداد | |
---|---|
UNKNOWN_BATTERY_STATUS |
حالة البطارية غير معروفة. |
BATTERY_STATUS_CHARGING |
يتم شحن البطارية. |
BATTERY_STATUS_DISCHARGING |
يتم تفريغ شحن البطارية. |
BATTERY_STATUS_FULL |
البطارية ممتلئة. |
BATTERY_STATUS_NOT_CHARGING |
البطارية لا تشحن. |
BATTERY_STATUS_POWER_LOW |
طاقة البطارية منخفضة. |
PowerSource
نوع الشاحن المُستخدَم لشحن البطارية.
عمليات التعداد | |
---|---|
UNKNOWN_POWER_SOURCE |
مصدر الطاقة غير معروف. |
POWER_SOURCE_AC |
مصدر الطاقة هو شاحن AC. |
POWER_SOURCE_USB |
مصدر الطاقة هو منفذ USB. |
POWER_SOURCE_WIRELESS |
مصدر الطاقة لاسلكي. |
POWER_SOURCE_UNPLUGGED |
البطارية غير متصلة. |
الطُرق |
|
---|---|
|
إنشاء نسخة افتراضية من مركبة جديدة مرتبطة بمقدّم خدمة مشاركة الرحلات أو خدمات التوصيل عند الطلب. |
|
لعرض مركبة من Fleet Engine |
|
تعرض قائمة مقسّمة إلى صفحات للمركبات المرتبطة بمقدّم خدمة الذي يطابق خيارات الطلب. |
|
تعرض قائمة بالمركبات التي تتطابق مع خيارات الطلب. |
|
كتابة بيانات المركبة المعدَّلة في Fleet Engine |
|
يتم تعديل سمات المركبة جزئيًا. |