取得所選路線

建立路徑後,您可以使用 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"

}

列出所選路線

如要列出與專案相關聯的所有選定路徑,請將 GET要求傳送至 list 端點。

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