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 フィールドが最後に更新された時刻。waypoints フィールドが更新された場合にのみ返されるように、クライアントはこの値をキャッシュに保存して GetVehicleRequest に渡す必要があります。

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)

顧客の乗車区間におけるすべての地域の交通速度を示すポリライン レンダリング。

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