Geocoding 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
Geocoding 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 Overview documentation for information on how to get started
using the Geocoding API.
August 13, 2025
SearchDestinations endpoint added to the Geocoding API v4 in experimental.
Announcing the Experimental release of the
SearchDestinations
endpoint of the Geocoding API v4. For more information, see
Search for destinations.
With this release, the following experimental features are no longer supported
in the Geocoding API v3:
- Entrances
- Navigation points
- Building outlines
- Grounds
For continued use of these features, we recommend developers to use the
SearchDestinations endpoint instead. For more information, see
Migrate from v3 features to the SearchDestinations endpoint.
May 13, 2025
Enhancements to the building outlines and entrances Experimental release
The Experimental release of Building outlines and entrances adds the following enhancements:
- Increases entrance coverage by returning all entrances on the same building as the geocoding result. In the previous release it only returned entrances that were for the geocoding result itself.
- A new response field,
entrance_tags[]
, is associated with each entrance to distinguish between entrances that are for the geocoding result and other entrances that are on the building. An entrance that has a value of PREFERRED
in entrance_tags[]
indicates that the entrance likely provides physical access to the geocoding result.
Grounds Experimental release available
Announcing the Experimental release of grounds. The new grounds
field in a Geocoding response contains a single grounds definition that, when populated, gives contextual information about the immediate territory that the geocoding result is on.
April 30, 2025
Geocoding API v4 is now in Preview.
Geocoding API v4 is implemented on the service infrastructure on Google Cloud which brings with it a more secure and trusted platform with enhanced security options like OAuth.
For more information and examples, see Geocoding API v4 overview.
April 17, 2025
Road name added to navigation points; Migration to new parameter and location fields required
The new road_name
response field contains the name of the road the navigation point is offset from. To return the road_name
response field, and to continue receiving navigation points, you must include the following query parameter in the request:
extra_computations=NAVIGATION_POINTS
Migration Notice: Existing applications must be updated to include the NAVIGATION_POINTS
parameter. Additionally, migrate to using location.lat
and location.lng
response fields instead of location.latitude
and location.longitude
. Future requests without this parameter will not return navigation points, and the older location fields will be removed. For more information, see Navigation points.
Navigation points and road names are Experimental (pre-GA) features.
March 25, 2025
Address descriptors released for General Availability (GA) in India
Address descriptors include additional information that help describe a location using landmarks and areas. For more information, see Address descriptors request and response.
This feature is available in all regions and is in GA for India and in the pre-GA Experimental launch stage for all other regions. The use of address descriptors in India incurs no additional cost and usage is covered by the existing Geocoding (India) Essentials SKU. For more information, see coverage details.
December 11, 2024
Experimental navigation points added. Navigation points are a list of points that are useful for navigating to a place. For more information, see navigation points.
October 18, 2024
Address descriptors added
New Preview address descriptors added. Address descriptors include additional information that help describe a location using landmarks and areas. For more information, see Address descriptors request and response.
This feature is available in all regions. For more information, see coverage details.
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\u003eThis page provides updates on new releases, features, bug fixes, and performance improvements for the Geocoding API.\u003c/p\u003e\n"],["\u003cp\u003eNavigation points were added as an experimental feature to aid in place navigation.\u003c/p\u003e\n"],["\u003cp\u003eAddress descriptors were introduced to provide more descriptive location information using landmarks and areas.\u003c/p\u003e\n"],["\u003cp\u003eUsers can subscribe to an XML feed to stay updated on the latest Geocoding API release notes.\u003c/p\u003e\n"]]],["The Geocoding API release notes detail updates, including new features, bug fixes, and performance improvements. Recent updates include the addition of experimental navigation points, which are points useful for navigating to a place, and preview address descriptors. Address descriptors provide extra details about a location using landmarks and areas and are available in all regions. Users can subscribe to these release notes or filter them in the Google API Console.\n"],null,["[Subscribe](/static/feeds/geocoding-api-release-notes.xml)\nto these release notes.\n[](/static/feeds/geocoding-api-release-notes.xml)\nThis page is updated with each new release of the Geocoding 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 [Overview](/maps/documentation/geocoding/release-notes/overview) documentation for information on how to get started\nusing the Geocoding API.\n\nAugust 13, 2025 \n**SearchDestinations endpoint added to the Geocoding API v4 in experimental.**\n\nAnnouncing the [Experimental](/maps/launch-stages#experimental) release of the\n[SearchDestinations](/maps/documentation/geocoding/reference/rest/v4alpha/geocode.destinations/searchDestinations)\nendpoint of the Geocoding API v4. For more information, see\n[Search for destinations](/maps/documentation/geocoding/search-for-destinations).\n\nWith this release, the following experimental features are no longer supported\nin the Geocoding API v3:\n\n- Entrances\n- Navigation points\n- Building outlines\n- Grounds\n\nFor continued use of these features, we recommend developers to use the\nSearchDestinations endpoint instead. For more information, see\n[Migrate from v3 features to the SearchDestinations endpoint](/maps/documentation/geocoding/destinations-migrate).\n\nMay 13, 2025 \n**Enhancements to the building outlines and entrances Experimental release**\n\nThe [Experimental](https://developers.google.com/maps/launch-stages#experimental) release of [Building outlines and entrances](https://developers.google.com/maps/documentation/geocoding/building-attributes) adds the following enhancements:\n\n- Increases entrance coverage by returning all entrances on the same building as the geocoding result. In the previous release it only returned entrances that were for the geocoding result itself.\n- A new response field, `entrance_tags[]`, is associated with each entrance to distinguish between entrances that are for the geocoding result and other entrances that are on the building. An entrance that has a value of `PREFERRED` in `entrance_tags[]` indicates that the entrance likely provides physical access to the geocoding result. \n**Grounds Experimental release available**\n\nAnnouncing the [Experimental](https://developers.google.com/maps/launch-stages#experimental) release of [grounds](https://developers.google.com/maps/documentation/geocoding/grounds). The new `grounds` field in a Geocoding response contains a single grounds definition that, when populated, gives contextual information about the immediate territory that the geocoding result is on.\n\nApril 30, 2025 \n**Geocoding API v4 is now in [Preview](https://developers.google.com/maps/launch-stages#preview).**\n\nGeocoding API v4 is implemented on the service infrastructure on Google Cloud which brings with it a more secure and trusted platform with enhanced security options like OAuth.\n\nFor more information and examples, see [Geocoding API v4 overview](https://developers.google.com/maps/documentation/geocoding/geocoding-v4-overview).\n\nApril 17, 2025 \n**Road name added to navigation points; Migration to new parameter and location fields required**\n\nThe new `road_name` response field contains the name of the road the navigation point is offset from. To return the `road_name` response field, and to continue receiving navigation points, you must include the following query parameter in the request:\n\n`extra_computations=NAVIGATION_POINTS`\n\n**Migration Notice:** Existing applications must be updated to include the `NAVIGATION_POINTS` parameter. Additionally, migrate to using `location.lat` and `location.lng` response fields instead of `location.latitude` and `location.longitude`. Future requests without this parameter will not return navigation points, and the older location fields will be removed. For more information, see [Navigation points](https://developers.google.com/maps/documentation/geocoding/navigation-points).\n\nNavigation points and road names are [Experimental](https://developers.google.com/maps/launch-stages#experimental) (pre-GA) features.\n\nMarch 25, 2025 \n**Address descriptors released for General Availability (GA) in India**\n\nAddress descriptors include additional information that help describe a location using landmarks and areas. For more information, see [Address descriptors request and response](https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors).\n\nThis feature is available in all regions and is in GA for India and in the pre-GA Experimental launch stage for all other regions. The use of address descriptors in India incurs no additional cost and usage is covered by the existing [Geocoding (India) Essentials SKU](https://developers.google.com/maps/billing-and-pricing/pricing-india#places-pricing). For more information, see [coverage details](https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage).\n\nDecember 11, 2024 \nExperimental navigation points added. Navigation points are a list of points that are useful for navigating to a place. For more information, see [navigation points](https://developers.google.com/maps/documentation/geocoding/requests-geocoding#navigation-points).\n\nOctober 18, 2024 \n**Address descriptors added**\n\nNew Preview address descriptors added. Address descriptors include additional information that help describe a location using landmarks and areas. For more information, see [Address descriptors request and response](https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors).\n\nThis feature is available in all regions. For more information, see [coverage details](https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage)."]]