REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

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

enum (VehicleState)

حالة المركبة

enum (TripType)

أنواع الرحلات المتوافقة مع هذه المركبة

string

النتائج فقط. قائمة برحلات "tripId" للرحلات المخصّصة حاليًا لهذه المركبة

object (VehicleLocation)

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

integer

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

object (VehicleAttribute)

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

object (VehicleType)

مطلوب. نوع هذه المركبة. يمكن استخدامها لفلترة المركبات في vehicles.search نتائج. يؤثر أيضًا على الوقت المقدر للوصول وحساب المسار.

object (LicensePlate)

معلومات لوحة ترخيص المركبة

object (TerminalLocation)

متوقّفة نهائيًا: استخدِم Vehicle.waypoints بدلاً منها.

string

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

ملاحظة: هذا الحقل مخصَّص فقط لاستخدام Driver SDK. ميزة فك التشفير غير متاحة بعد.

object (TrafficPolylineData)

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

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه ضبط currentRouteSegment ويمكن للعميل تخزينه وإرساله في طلبات vehicles.get المستقبلية لمنع عرض المسارات التي لم تتغيّر.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

تمثّل هذه السمة النقطة المسارية التي ينتهي عندها currentRouteSegment. يمكن توفير ذلك من قِبل السائقين في مكالمات vehicles.update إما كنقطة طريق كاملة للرحلة أو نقطة وسيطة LatLng أو آخر LatLng من currentRouteSegment. وسيبذل Fleet Engine قصارى جهده للتضمين في نقطة طريق فعلية إذا لم يتم تحديدها بشكل كامل. يتم تجاهل هذا الحقل في طلبات vehicles.update ما لم يتم تحديد currentRouteSegment أيضًا.

integer

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

string (Timestamp format)

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

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

integer

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

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

object (TripWaypoint)

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

boolean

يشير هذا الحقل إلى ما إذا كان السائق يقبل الرحلات المتتالية. إذا كانت true، قد تشمل vehicles.search المركبة حتى إذا كانت مخصصة حاليًا لرحلة. القيمة التلقائية هي false.

enum (NavigationStatus)

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

object (DeviceSettings)

الإدخال فقط معلومات حول الإعدادات في الجهاز الجوّال الذي يستخدمه السائق.

{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}

string

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

string

قيمة السمة.

string

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

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

boolean

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

number

قيمة سمة ذات نوعَين

{
  "category": enum (Category)
}

enum (Category)

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

{
  "countryCode": string,
  "lastCharacter": string
}

string

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

string

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

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

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

عرض خط متعدد الخطوط لسرعة حركة المرور في جميع المناطق على طول مسار واحد من رحلة أحد العملاء

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

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

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

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

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

integer

مطلوب. يجب تطبيق النمط بين [offsetMeters, offsetMeters + lengthMeters).

integer

مطلوب. طول المسار الذي سيتم تطبيق النمط عليه.

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

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

boolean

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

boolean

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

object (BatteryInfo)

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

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

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

enum (PowerSource)

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

number

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