選択したルートを取得する

ルートを作成したら、Roads Selection API の GET エンドポイントを使用して、ルートの情報を取得し、検証ステータスをモニタリングできます。

このページでは、プロジェクトで選択したすべてのルートを一覧表示する方法と、選択した特定のルートの詳細を取得する方法について説明します。

選択した特定のルートを取得する

選択した特定のルートに関する情報を取得するには、取得するルートの selectedRouteId を含めて、get エンドポイントに GET リクエストを送信します。

  "https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID"

次のコードサンプルは、選択した単一のルートに関する情報を取得するための get エンドポイントへの GET リクエストの構造を示しています。

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID"

次のコードサンプルは、選択された単一のルートの情報を含む get エンドポイント レスポンスの構造を示しています。

{
  "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID",
  "dynamicRoute": {
    "origin": {
      "latitude": ORIGIN_LATITUDE,
      "longitude": ORIGIN_LONGITUDE
    },
    "destination": {
      "latitude": DESTINATION_LATITUDE,
      "longitude": DESTINATION_LONGITUDE
    },
    "intermediates": [
      {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      },
      {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      },
      {
        "latitude": LATITUDE,
        "longitude": LONGITUDE
      }
    ]
  },
  "createTime": "CREATE_TIME",
  "state": "STATE"

}

選択したルートを一覧表示する

プロジェクトに関連付けられているすべての選択されたルートを一覧表示するには、list エンドポイントに GET リクエストを送信します。

https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes

次のコードサンプルは、list エンドポイントに対する GET リクエストの構造を示しています。このリクエストは、Google Cloud プロジェクトに関連付けられている選択されたすべてのルートの情報を取得します。

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes"

次のコードサンプルは、Google Cloud プロジェクトに関連付けられている選択されたすべてのルートの情報を含む list エンドポイント レスポンスの構造を示しています。

{
  "selectedRoutes": [
    {
      "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID",
      "dynamicRoute": {
        "origin": {
          "latitude": ORIGIN_LATITUDE,
          "longitude": ORIGIN_LONGITUDE
        },
        "destination": {
          "latitude": DESTINATION_LATITUDE,
          "longitude": DESTINATION_LONGITUDE
        }
      },
      "createTime": "CREATE_TIME",
      "state": "STATE"
    },
    {
      "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID",
      "dynamicRoute": {
        "origin": {
          "latitude": ORIGIN_LATITUDE,
          "longitude": ORIGIN_LONGITUDE
        },
        "destination": {
          "latitude": DESTINATION_LATITUDE,
          "longitude": DESTINATION_LONGITUDE
        },
        "intermediates": [
          {
            "latitude": LATITUDE,
            "longitude": LONGITUDE
          },
          {
            "latitude": LATITUDE,
            "longitude": LONGITUDE
          },
          {
            "latitude": LATITUDE,
            "longitude": LONGITUDE
          }
        ]
      },
      "createTime": "CREATE_TIME",
      "state": "STATE"
    },
  ]
}