Routes API release notes
Stay organized with collections
Save and categorize content based on your preferences.
Subscribe
to these release notes.
This page is updated with each new release of the
Routes API. The changelog lists releases by date and includes
any new features, bug fixes and significant performance improvements.
You can also browse and filter all release notes for all products in the
Google API Console.
See the Getting Started documentation for information on how
to get started using the Routes API.
June 29, 2023
This release extends the General Availability (GA) release of the Routes API from March 2023. It includes the following features previously available only through the Directions API or Distance Matrix API.
See the Release Notes for information about this release and all other releases. If you are a new user, see Set Up your Google Cloud project to start the installation process.
You can now get a localized text representation of time, distance, duration, and transit fares using the inferred or specified language and measurement unit systems. For details, see Request localized values.
You can now get HTML-formatted navigation instructions. For details, see Extra Computations.
March 08, 2023
Routes API
Announcing the General Availability (GA) release of the Routes API. See the Release Notes for information about this release and for all other releases.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
Along with place IDs and latitude/longitude coordinates, you can now specify a location in the GA release by using address strings ("Chicago, IL" or "Darwin, NT, Australia") and Plus Codes. For more information and examples, see Specify location and route options.
The Compute Routes response now contains the geocodingResults array. For every location in the request (origin, destination, or intermediate waypoint) that was specified as an address string or as a Plus code, the API performs a place ID lookup. Each element of this array contains the place ID corresponding to a location along with additional metadata. Locations in the request specified as a place ID or as latitude/longitude coordinates are ignored.
You must now explicitly enable the following features in the GA by
adding the new array extraComputations field to the request:
In the Preview release, you used a field mask to configure the method to
return information in the response for these features. In the GA, you still specify the field mask but now you must also set the new array extraComputations field.
November 01, 2022
Added support for eco-friendly routing to the Routes API Preview. When you enable eco-friendly routing, the API returns an eco-friendly route showing the most fuel or energy efficient route based on your vehicle's engine type. For more information, see Configure eco-friendly routes.
September 28, 2022
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-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThe Routes API is generally available and provides optimized routes for various travel modes, including transit, with up to 25 waypoints.\u003c/p\u003e\n"],["\u003cp\u003eThis API allows developers to calculate routes using addresses, Plus Codes, place IDs, or coordinates, and retrieve localized text representations of route information.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify traffic models for route calculations (experimental feature) and obtain HTML-formatted navigation instructions.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers eco-friendly routing options, considering vehicle engine types to determine fuel-efficient routes.\u003c/p\u003e\n"],["\u003cp\u003eThe Routes API changelog details all releases and features, with setup instructions provided for new users.\u003c/p\u003e\n"]]],["The Routes API's General Availability (GA) release includes transit travel mode computations, optimization of up to 25 waypoints, and localized text for time, distance, and fares. Users can specify traffic models and access HTML-formatted navigation instructions. The GA release also supports location specification via address strings and Plus Codes, and it returns place ID lookup results. Eco-friendly routing, toll information, and traffic on a polyline are now enabled through the `extraComputations` array.\n"],null,["# Routes API release notes\n\n[Subscribe](/static/feeds/routes-api-release-notes.xml)\nto these release notes.\n[](/static/feeds/routes-api-release-notes.xml)\nThis page is updated with each new release of the Routes API. The changelog lists releases by date and includes any new features, bug fixes and significant performance improvements. You can also browse and filter all release notes for all products in the [Google API Console](https://console.cloud.google.com/release-notes). See the [Getting Started](/maps/documentation/routes/release-notes/cloud-setup) documentation for information on how\nto get started using the Routes API.\n\nJune 29, 2023\n-------------\n\nThis release extends the General Availability (GA) release of the Routes API from March 2023. It includes the following features previously available only through the Directions API or Distance Matrix API.\n\nSee the Release Notes for information about this release and all other releases. If you are a new user, see [Set Up your Google Cloud project](https://developers.google.com/maps/documentation/routes/cloud-setup) to start the installation process. \nYou can now compute routes for transit travel modes. For details, see [Compute a route on transit](https://developers.google.com/maps/documentation/routes/transit-route). \nYou can now calculate routes with up to 25 intermediate waypoints with and let Google optimize the order of those waypoints for your route. For details, see [Optimize the order of stops on your route](https://developers.google.com/maps/documentation/routes/opt-way). \nYou can now get a localized text representation of time, distance, duration, and transit fares using the inferred or specified language and measurement unit systems. For details, see [Request localized values](https://developers.google.com/maps/documentation/routes/localized-values). \nYou can now specify a traffic model to use when computing routes with traffic. This is an experimental feature. For details, see [Specify the traffic model type to use](https://developers.google.com/maps/documentation/routes/traffic-model). \nYou can now get HTML-formatted navigation instructions. For details, see [Extra Computations](https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#extracomputation).\n\nMarch 08, 2023\n--------------\n\n**Routes API**\n\nAnnouncing the General Availability (GA) release of the Routes API. See the [Release Notes](https://developers.google.com/maps/documentation/routes/release-notes) for information about this release and for all other releases.\n\nIf you are a new user, see [Set Up in the Google Cloud Console](https://developers.google.com/maps/documentation/routes/cloud-setup) to start the installation process. \nAlong with place IDs and latitude/longitude coordinates, you can now specify a location in the GA release by using address strings (\"Chicago, IL\" or \"Darwin, NT, Australia\") and Plus Codes. For more information and examples, see [Specify location and route options](https://developers.google.com/maps/documentation/routes/specify_location). \nThe [Compute Routes response](https://developers.google.com/maps/documentation/routes/understand-route-response) now contains the `geocodingResults` array. For every location in the request (origin, destination, or intermediate waypoint) that was specified as an **address string** or as a **Plus code**, the API performs a place ID lookup. Each element of this array contains the place ID corresponding to a location along with additional metadata. Locations in the request specified as a place ID or as latitude/longitude coordinates are ignored. \nYou must now explicitly enable the following features in the GA by\nadding the new array `extraComputations` field to the request:\n\n- [Toll information](https://developers.google.com/maps/documentation/routes/calculate_toll_fees)\n- [Fuel consumption](https://developers.google.com/maps/documentation/routes/eco-routes)\n- [Traffic on a polyline](https://developers.google.com/maps/documentation/routes/traffic_on_polylines)\n\nIn the Preview release, you used a [field mask](https://developers.google.com/maps/documentation/routes/choose_fields) to configure the method to\nreturn information in the response for these features. In the GA, you still specify the field mask but now you must also set the new array `extraComputations` field.\n\nNovember 01, 2022\n-----------------\n\nAdded support for eco-friendly routing to the Routes API Preview. When you enable eco-friendly routing, the API returns an eco-friendly route showing the most fuel or energy efficient route based on your vehicle's engine type. For more information, see [Configure eco-friendly routes](https://developers.google.com/maps/documentation/routes/eco-routes).\n\nSeptember 28, 2022\n------------------\n\nThe Preview release of the Routes API is now available. For information about this release, and for all previous releases, see the [Release Notes](https://developers.google.com/maps/documentation/routes/release-notes) or subscribe to the Release Notes [XML feed](https://developers.google.com/static/feeds/routes-api-release-notes.xml).\n\nTo start the installation process, see [Set Up in the Google Cloud Console](https://developers.google.com/maps/documentation/routes/cloud-setup)."]]
