New Changes to the Google Maps Platform
We are writing to remind you that on November 20, 2019, the
PlaceResult objects returned in response to Place Details, Find Places, Nearby Search and Text Search requests.
You have until November 20, 2020, to perform the changes in your code as described below.
What do I need to know?
PlaceResult object the properties:
utc_offset,which is returned on Place Details requests and
opening_hours.open_now,which is returned on Place Details, Find Place, Nearby Search and Text Search requests.
These properties have been replaced as follows:
isOpen()method in Place Details requests only.
Additionally, for Find Place, Nearby Search and Text Search requests, we provide alternative solutions for determining whether a place is open.
utc_offset and the nested field
opening_hours.open_now in the
fields parameter and stop returning them in response to such requests. Instead, you will receive the ‘Unsupported field name’ error when using these properties in the
fields parameter and the value ‘undefined’ when reading these properties from the
PlaceResult object in the response.
If you are not already doing so, using the
fields parameter in Place Details requests will save you money in case you don’t need all the fields for returned places. If you do not specify at least one field with a request, or if you omit the fields parameter from a request, all possible fields will be returned, and you will be billed accordingly, for all data SKUs.
What do I need to do?
Before November 20, 2020, follow the Place Field Migration guide to make the necessary property and method substitutions and to see the alternative options for obtaining
opening_hours data to prevent user experience degradation. We have also recently published a video explaining how to get current open status through Place Details using the
isOpen method and
As always, you can contact our Google Maps Platform Support Team with any questions.
Thank you for choosing Google Maps Platform.