Stay organized with collections
Save and categorize content based on your preferences.
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 are interested in. This includes
coordinates for origin, intermediate waypoints, and destination.
You can also retrieve details from any of your registered routes and stop data
collection from any route when needed.
API Resources
The following table summarizes the primary resource and endpoints available
through the Roads Selection API and their purposes.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[],[],null,["# Roads Selection API Overview\n\nThe Roads Selection API is a core component of the **Roads Management Insights** product.\n\nUse the Roads Selection API to subscribe to routes for which you want to collect road\ndata. Once you subscribe to a given route, the API periodically retrieves and\npublishes information for the route in a Big Query table or a Pub/Sub\nsubscription for analysis and monitoring.\n\nHow the Roads Selection API works\n---------------------------------\n\nThe Roads Selection API accepts an HTTPS request containing latitude and longitude\ncoordinates that define the route you are interested in. This includes\ncoordinates for origin, intermediate waypoints, and destination.\n\nYou can also retrieve details from any of your registered routes and stop data\ncollection from any route when needed.\n\n### API Resources\n\nThe following table summarizes the primary resource and endpoints available\nthrough the Roads Selection API and their purposes.\n\n\u003cbr /\u003e\n\n| API endpoint | Description | Format |\n|---------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------|--------|\n| **[`create`](/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/create)** | Registers your interest in continuous road data for a route defined by origin, destination, and optional intermediate waypoints. | JSON |\n| **[`batchCreate`](/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/batchCreate)** | Registers multiple routes for data collection by providing origin, destination, and intermediate waypoints for each route. | JSON |\n| **[`get`](/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/get)** | Retrieves details about a previously created route by supplying its `selectedRouteId`. | JSON |\n| **[`delete`](/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/delete)** | Stops data collection for a specific route by supplying its `selectedRouteId`. | JSON |\n| **[`list`](/maps/documentation/roads-management-insights/reference/rest/v1/selection.v1.projects.selectedRoutes/list)** | Retrieves a list of all the routes you have created. | JSON |\n\n\u003cbr /\u003e"]]