Hello Google Maps Platform Developers,
On November 20, 2019, the PlaceResult.opening_hours.open_now and PlaceResult.utc_offset properties in the Google Maps JavaScript API’s Places Library are deprecated and replaced by new properties and methods.
You have until November 20, 2020 to perform the changes in your code as described below.
We have notified owners of API projects which our records indicate are requesting these properties in Place Details and Find Place requests or might be reading them from PlaceResult object returned in the response from Place Details, Find Place, Nearby Search or Text Search requests.
Currently, the Maps JavaScript API’s Places Library exposes in its PlaceResult object the properties:
utc_offset, which is returned in Place Details response
opening_hours.open_now, which is returned in Place Details, Find Place, Nearby Search and Text Search responses
On November 20, 2019, we are deprecating these properties to bring consistency across Places API clients on different platforms (the Maps Javascript API, the Places SDK for Android, the Places SDK for iOS).
These properties have been replaced as follows:
utc_offset, by utc_offset_minutes
opening_hours.open_now, by the 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.
As a result, starting November 20, 2020, the Maps JavaScript API’s Places Library will stop accepting those properties in the fields parameter and stop returning them in the response for the corresponding requests. Instead, developers will receive the ‘Unsupported field name’ error when using them in the fields parameter and the value ‘undefined’ when reading these properties from the PlaceResult object in the response.
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.
Thank you for choosing Google Maps Platform.
Sincerely,
The Google Maps Platform Team