Obtenir des itinéraires sélectionnés

Après avoir créé une route, vous pouvez utiliser le point de terminaison GET de l'API Roads Selection pour obtenir des informations sur cette route et surveiller son état de validation.

Cette page explique comment lister toutes les routes sélectionnées dans votre projet et comment obtenir des informations sur une route sélectionnée spécifique.

Obtenir un itinéraire sélectionné spécifique

Pour obtenir des informations sur une route sélectionnée spécifique, envoyez une requête GET au point de terminaison get, y compris le selectedRouteId de la route que vous souhaitez récupérer.

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

L'exemple de code suivant montre la structure d'une requête GET envoyée au point de terminaison get pour obtenir des informations sur un seul itinéraire sélectionné.

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"

L'exemple de code suivant montre la structure d'une réponse du point de terminaison get avec les informations d'un seul itinéraire sélectionné.

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

Lister les routes sélectionnées

Pour lister toutes les routes sélectionnées associées à votre projet, envoyez une requête GET au point de terminaison list.

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

L'exemple de code suivant montre la structure d'une requête GET envoyée au point de terminaison list pour obtenir les informations de toutes les routes sélectionnées associées à un projet 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"

L'exemple de code suivant montre la structure d'une réponse de point de terminaison list avec les informations de toutes les routes sélectionnées associées à un projet 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
    }
  ]
}