Routes Preferred API

  • The Routes Preferred API service, routespreferred.googleapis.com, helps developers compute optimal routes and route matrices based on given waypoints and objectives.

  • The service offers two versions: v1alpha and v1, each supporting methods like computeCustomRoutes, computeRouteMatrix, and computeRoutes.

  • Client libraries are recommended for interacting with the service, but developers can also use the provided discovery documents and service endpoint for custom integration.

  • computeCustomRoutes allows developers to define route objectives and receive tailored route recommendations, while computeRoutes provides primary and alternate routes for standard navigation.

  • computeRouteMatrix facilitates the calculation of route information for multiple origin-destination pairs, enabling efficient analysis of travel times and distances.

Service: routespreferred.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://routespreferred.googleapis.com

REST Resource: v1alpha

Methods
computeCustomRoutes POST /v1alpha:computeCustomRoutes
Given a set of terminal and intermediate waypoints, and a route objective, computes the best route for the route objective.
computeRouteMatrix POST /v1alpha:computeRouteMatrix
Takes in a list of origins and destinations and returns a stream containing route information for each combination of origin and destination.
computeRoutes POST /v1alpha:computeRoutes
Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints.

REST Resource: v1

Methods
computeCustomRoutes POST /v1:computeCustomRoutes
Given a set of terminal and intermediate waypoints, and a route objective, computes the best route for the route objective.
computeRouteMatrix POST /v1:computeRouteMatrix
Takes in a list of origins and destinations and returns a stream containing route information for each combination of origin and destination.
computeRoutes POST /v1:computeRoutes
Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints.