Delete selected routes

Cette page explique comment arrêter la collecte de données à l'aide de l'API Roads Selection :

  • Supprimer un itinéraire : arrêtez la collecte de données pour un seul itinéraire à l'aide du point de terminaison delete.
  • Supprimer des routes par lot : arrêtez la collecte de données pour plusieurs routes dans une seule requête à l'aide du point de terminaison batchDelete.

Supprimer une route

Envoyez une requête DELETE au point de terminaison delete pour supprimer une route sélectionnée de votre projet et arrêter la collecte de données.

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

La requête doit inclure le numéro de projet et l'name de l'SelectedRoute à supprimer.

L'exemple de code suivant montre la structure d'une requête DELETE envoyée au point de terminaison delete :

curl -X DELETE \
-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"

En cas de réussite, l'API renvoie un objet JSON vide.

Supprimer des routes par lot

Pour supprimer plusieurs routes dans une même requête, utilisez le point de terminaison batchDelete. Ce point de terminaison vous permet de supprimer jusqu'à 1 000 itinéraires en un seul appel. La suppression par lot est atomique : si une route de la requête par lot échoue ou est manquante, aucune route du lot n'est supprimée.

Envoyez une requête POST au point de terminaison batchDelete :

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

Le corps de la requête doit être un objet JSON contenant un tableau names. Chaque élément de chaîne de ce tableau est l'name d'un SelectedRoute à supprimer.

L'exemple de code suivant montre la structure d'une requête POST envoyée au point de terminaison batchDelete :

curl -X POST -d '
    {"names": [
      "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_1",
      "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_2"
    ]}' \
-H 'X-Goog-User-Project: PROJECT_NUMBER' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
"https://roads.googleapis.com/selection/v1/projects/"\
"PROJECT_NUMBER/selectedRoutes:batchDelete"

En cas de réussite, l'API renvoie un objet JSON vide. La collecte de données sur la route supprimée s'arrête immédiatement. La suppression définitive des ressources s'effectue en arrière-plan et peut prendre quelques minutes pour les lots de grande taille.

Utilisez l'opération get pour vérifier l'état de votre route. Si vous relancez une requête une fois la suppression définitive terminée, une erreur 404 Not Found est renvoyée, confirmant que la suppression de la ressource est terminée.