Method: providers.trips.search

特定の車両のすべてのルートを取得できます。

HTTP リクエスト

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/trips:search

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。providers/{provider} の形式で指定してください。プロバイダには、この呼び出しを行うサービス アカウントがメンバーになっている Google Cloud プロジェクトのプロジェクト ID（sample-cloud-project など）を指定する必要があります。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "header": {
    object (RequestHeader)
  },
  "vehicleId": string,
  "activeTripsOnly": boolean,
  "pageSize": integer,
  "pageToken": string,
  "minimumStaleness": string
}
フィールド
header

object (RequestHeader)

標準の Fleet Engine リクエスト ヘッダー。
vehicleId

string

リクエスト内のルートに関連付けられている車両。指定しない場合、返されるルートに以下は含まれません。

  • currentRouteSegment
  • remainingWaypoints
  • remainingDistanceMeters
  • etaToFirstWaypoint
activeTripsOnly

boolean

true に設定すると、ドライバーのルートに影響するルートがレスポンスに含まれます。
pageSize

integer

設定されていない場合、返される結果の数はサーバーが決定します。
pageToken

string

前の結果から続行するには、この値を SearchTripsResponse で以前に返された値に設定します。
minimumStaleness

string (Duration format)

指定すると、時刻 (current - minimumStaleness) 以降に更新されていないルートが返されます。

「s」で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

レスポンスの本文

shortcuts.search レスポンス メッセージ。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "trips": [
    {
      object (Trip)
    }
  ],
  "nextPageToken": string
}
フィールド
trips[]

object (Trip)

リクエストされた車両のルートのリスト。
nextPageToken

string

このトークンを SearchTripsRequest でリスト結果をページ分けして渡します。API は呼び出しごとにルートリストを返します。結果が残らない場合、ルートリストは空になります。