创建路线后,您可以使用 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"
}
列出所选路线
如需列出与您的项目关联的所有选定路线,请向 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"
},
{
"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"
},
]
}