Routes Preferred API is currently available only to select customers.
Contact sales to learn more.
Routes Preferred API
Stay organized with collections
Save and categorize content based on your preferences.
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. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 UTC."],[[["\u003cp\u003eThe Routes Preferred API service, \u003ccode\u003eroutespreferred.googleapis.com\u003c/code\u003e, helps developers compute optimal routes and route matrices based on given waypoints and objectives.\u003c/p\u003e\n"],["\u003cp\u003eThe service offers two versions: \u003ccode\u003ev1alpha\u003c/code\u003e and \u003ccode\u003ev1\u003c/code\u003e, each supporting methods like \u003ccode\u003ecomputeCustomRoutes\u003c/code\u003e, \u003ccode\u003ecomputeRouteMatrix\u003c/code\u003e, and \u003ccode\u003ecomputeRoutes\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are recommended for interacting with the service, but developers can also use the provided discovery documents and service endpoint for custom integration.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecomputeCustomRoutes\u003c/code\u003e allows developers to define route objectives and receive tailored route recommendations, while \u003ccode\u003ecomputeRoutes\u003c/code\u003e provides primary and alternate routes for standard navigation.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecomputeRouteMatrix\u003c/code\u003e facilitates the calculation of route information for multiple origin-destination pairs, enabling efficient analysis of travel times and distances.\u003c/p\u003e\n"]]],["The `routespreferred.googleapis.com` service offers two REST resources, `v1alpha` and `v1`, accessible via the `https://routespreferred.googleapis.com` endpoint. Both versions support three `POST` methods: `computeCustomRoutes` to calculate the best route based on waypoints and objectives, `computeRouteMatrix` to retrieve route information for multiple origin-destination pairs, and `computeRoutes` to return primary and optional alternate routes between waypoints. The service provides discovery documents for each version.\n"],null,["# Routes Preferred API\n\n- [REST Resource: v1alpha](#v1alpha)\n- [REST Resource: v1](#v1)\n\nService: routespreferred.googleapis.com\n---------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) 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:\n\n- \u003chttps://routespreferred.googleapis.com/$discovery/rest?version=v1\u003e\n- \u003chttps://routespreferred.googleapis.com/$discovery/rest?version=v1alpha\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_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:\n\n- `https://routespreferred.googleapis.com`\n\nREST Resource: [v1alpha](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel)\n----------------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [computeCustomRoutes](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel/computeCustomRoutes) | `POST /v1alpha:computeCustomRoutes` Given a set of terminal and intermediate waypoints, and a route objective, computes the best route for the route objective. |\n| [computeRouteMatrix](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel/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. |\n| [computeRoutes](/maps/documentation/routes_preferred/reference/rest/v1alpha/TopLevel/computeRoutes) | `POST /v1alpha:computeRoutes` Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints. |\n\nREST Resource: [v1](/maps/documentation/routes_preferred/reference/rest/v1/TopLevel)\n------------------------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [computeCustomRoutes](/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeCustomRoutes) | `POST /v1:computeCustomRoutes` Given a set of terminal and intermediate waypoints, and a route objective, computes the best route for the route objective. |\n| [computeRouteMatrix](/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/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. |\n| [computeRoutes](/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRoutes) | `POST /v1:computeRoutes` Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints. |"]]
