取得所選路線

建立路徑後，您可以使用 Roads Selection API GET 端點取得路徑資訊，並監控驗證狀態。

本頁面說明如何列出專案中所有選取的路徑，以及如何取得特定選取路徑的詳細資料。

取得特定選取的路線

如要取得特定所選路線的資訊，請將 GET 要求傳送至 get 端點，並在要求中加入要擷取的路線 selectedRouteId。

  "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",
  "dynamicRouting": TRUE_OR_FALSE
}

列出所選路徑

如要列出與專案相關聯的所有所選路徑，請向 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"

下列程式碼範例顯示 list 端點回應的結構，其中包含與 Google Cloud 專案相關聯的所有所選路徑資訊。

{
  "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",
      "dynamicRouting": TRUE_OR_FALSE
    },
    {
      "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",
      "dynamicRouting": TRUE_OR_FALSE
    }
  ]
}