REST Resource: selection.v1.projects.selectedRoutes

リソース: SelectedRoute

SelectedRoute は、お客様が契約したユースケースの情報を定期的に取得したい特定のルート（所要時間など）を表します。

JSON 表現 
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "state": enum (State),
  "routeAttributes": {
    string: string,
    ...
  },

  // Union field route_type can be only one of the following:
  "dynamicRoute": {
    object (DynamicRoute)
  }
  // End of list of possible types for union field route_type.
  "validationError": enum (ValidationError)
}
フィールド
name

string

ID。SelectedRoute のリソース名。

形式: projects/{project}/selectedRoutes/{selectedRoute}
displayName

string

省略可。ルートの表示名。これは、お客様が使用できる省略可能なフィールドです。一意である必要はありません。
createTime

string (Timestamp format)

出力専用。選択したルートが最初に作成された日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
state

enum (State)

出力専用。選択したルートの状態。
routeAttributes

map (key: string, value: string)

省略可。選択したルートのカスタム属性。追加すると、過去とリアルタイムのルート情報を取得するときにルートのフィルタリングやグループ化が可能になります。ルートごとに最大 10 個の属性がサポートされています。各キーと値は空でない文字列で、最大 100 文字まで使用できます。キーの先頭を「goog」にすることはできません。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
共用体フィールド route_type。現在サポートされているのは DynamicRoute のみです。route_type は次のいずれかになります。
dynamicRoute

object (DynamicRoute)

SelectedRoute は動的ルートです。
validationError

enum (ValidationError)

出力専用。状態が STATE_INVALID の場合に選択されたルートの検証エラー。

DynamicRoute

これは、経由地（出発地、目的地、中間地点）を含むルートを表します。実際のルートはすべての経由地を通過することが保証されていますが、交通状況の変化により随時変更される可能性があります。

JSON 表現 
{
  "origin": {
    object (LatLng)
  },
  "destination": {
    object (LatLng)
  },
  "intermediates": [
    {
      object (LatLng)
    }
  ]
}
フィールド
origin

object (LatLng)

必須。ルートの出発地。
destination

object (LatLng)

必須。ルートの終点。
intermediates[]

object (LatLng)

省略可。ルート上の途中経由地（終点を除く）のセット。これらは常に通過点です。最大 25 個の中間地点がサポートされています。適切に追加することで、実際のルートのばらつきを軽減できます。

LatLng

緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない場合、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。

JSON 表現 
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。
longitude

number

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

州

選択したルートの状態。

列挙型
STATE_UNSPECIFIED このルートの状態が設定されていません。
STATE_SCHEDULING ルートが作成され、スケジュール設定中です。
STATE_RUNNING ルートが作成され、アクティブなスケジュールが設定されている。
STATE_DELETING ルートが削除対象としてマークされています。
STATE_VALIDATING ルートの検証中です。
STATE_INVALID 検証条件のいずれかに基づいて、ルートが無効です。

ValidationError

選択したルートの検証エラー。

列挙型
VALIDATION_ERROR_UNSPECIFIED このルートの検証エラーが設定されていません。
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION ルートがプロジェクトの管轄外にある。
VALIDATION_ERROR_LOW_ROAD_USAGE 道路の利用頻度が低い（通行する人がほとんどいない）。

メソッド

batchCreate

 複数の SelectedRoute を作成し、各ルートのキャッシュ情報を定期的に取得するスケジュールを開始します。

create

 SelectedRoute を作成し、ルートのキャッシュ情報を定期的に取得するスケジュールを開始します。

delete

 指定されたプロジェクトの指定された SelectedRoute を削除します。

get

 名前で指定された SelectedRoute を取得します。

list

 指定されたプロジェクトのすべての SelectedRoute をページネーションで一覧表示します。