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

この車両が乗車できる乗客の総数。この値にはドライバーは含まれません。1 以上の値を指定してください。

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」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

object (TripWaypoint)

currentRouteSegment の終点となる地点。これは、ドライバーが vehicles.update 呼び出しで、完全なトリップのウェイポイント、ウェイポイントの LatLng、または currentRouteSegment の最後の LatLng として指定できます。地点が完全に指定されていない場合、Fleet Engine は可能な限り実際の地点に補間しようとします。currentRouteSegment も指定しない限り、このフィールドは vehicles.update 呼び出しで無視されます。

integer

currentRouteSegment の残りの走行距離。この値は、車両に割り当てられているすべてのアクティブなルートの Trip.remaining_distance_meters でも返されます。currentRouteSegment フィールドが空の場合、値が指定されていません。

string (Timestamp format)

waypoints フィールドの最初のエントリの到着予定時刻。waypoints フィールドまたは Vehicle.current_route_segment フィールドが空の場合、値は指定されません。

車両を更新するときは、同じリクエスト内で remainingTimeSeconds が etaToFirstWaypoint よりも優先されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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 フィールドと同じです。create メソッドまたは update メソッドではどちらのフィールドも使用できますが、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)

顧客の乗車区間 1 区間のすべての地域の交通量を示すポリライン レンダリング。

{
  "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]。