Roads Selection API Overview

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.

API endpoint Description Format
create

Registers your interest in continuous road data for a route defined by origin, destination, and optional intermediate waypoints.

JSON

batchCreate

Registers multiple routes for data collection by providing origin, destination, and intermediate waypoints for each route.

JSON

get

Retrieves details about a previously created route by supplying its selectedRouteId.

JSON

delete

Stops data collection for a specific route by supplying its selectedRouteId.

JSON

list

Retrieves a list of all the routes you have created.

JSON