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 being deprecated and replaced by new properties and methods. You are receiving this email because you have projects using these properties in the fields parameter in Place Details and/or Find Place requests.
You have until November 20, 2020, to perform the changes in your code as described below.
What do I need to know?
Currently, the Maps JavaScript API’s Places Library exposes two properties in its PlaceResult objects:
- utc_offset, which is returned by Place Details requests and
- opening_hours.open_now, which is returned by Place Details, Find Place, Nearby Search, Text Search requests.
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 the properties in the fields parameter and stop returning them in response to such requests. Instead, developers 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.
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.
Comments
0 comments
Article is closed for comments.