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