The Roads Selection API is a core component of the **Roads Management Insights** product.

Use the Roads Selection API to subscribe to routes for which you want to collect road
data. Once you subscribe to a given route, the API periodically retrieves and
publishes information for the route in a Big Query table or a Pub/Sub
subscription for analysis and monitoring.

## How the Roads Selection API works

The Roads Selection API accepts an HTTPS request containing latitude and longitude
coordinates that define the route you're interested in. This includes
coordinates for origin, intermediate waypoints, and destination.

You can also retrieve and update details from any of your registered routes, and
stop data collection from any route when needed. These operations can be
performed on individual routes or in batches.

### API Resources

The following table summarizes the primary resource and endpoints available
through the Roads Selection API and their purposes.

<br />

| API endpoint | Description | Format |
|---|---|---|
| **[`create`](https://developers.google.com/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/create.md.txt)** | Registers your interest in continuous road data for a route defined by origin, destination, and optional intermediate waypoints. | JSON |
| **[`batchCreate`](https://developers.google.com/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/batchCreate.md.txt)** | Registers multiple routes for data collection by providing origin, destination, and intermediate waypoints for each route. | JSON |
| **[`get`](https://developers.google.com/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/get.md.txt)** | Retrieves details about a previously created route by supplying its `selectedRouteId`. | JSON |
| **[`list`](https://developers.google.com/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/list.md.txt)** | Retrieves a list of all the routes you have created. | JSON |
| **[`patch`](https://developers.google.com/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/patch.md.txt)** | Updates details for a previously created route by supplying its `selectedRouteId`. | JSON |
| **[`batchUpdate`](https://developers.google.com/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/batchUpdate.md.txt)** | Updates details for multiple routes simultaneously. | JSON |
| **[`delete`](https://developers.google.com/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/delete.md.txt)** | Stops data collection for a specific route by supplying its `selectedRouteId`. | JSON |
| **[`batchDelete`](https://developers.google.com/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/batchDelete.md.txt)** | Stops data collection for multiple routes simultaneously. | JSON |

<br />