Новые изменения в Платформе Google Maps

Мы пишем, чтобы напомнить вам, что 20 ноября 2019 года свойства PlaceResult.opening_hours.open_now и PlaceResult.utc_offset в библиотеке Places API JavaScript Карт устарели и заменены новыми свойствами и методами. Вы получаете это письмо, поскольку ваши проекты могут считывать эти свойства из объектов PlaceResult, возвращаемых в ответ на запросы «Сведения о месте», «Поиск мест», «Поиск рядом» и «Поиск текста».

Вы должны до 20 ноября 2020 года внести изменения в ваш код, как описано ниже.

Что мне нужно знать?

В настоящее время JavaScript Библиотека JavaScript для Places предоставляет объекту PlaceResult свойства:

  • utc_offset, который возвращается на запрос информации о месте и
  • opening_hours.open_now, который возвращается в запросах «Сведения о месте», «Поиск места», «Поиск рядом» и «Поиск текста»

20 ноября 2019 года мы устарели в этих свойствах, чтобы обеспечить согласованность между клиентами API Places на разных платформах (API JavaScript Карт, Places SDK для Android, Places SDK для iOS).

Эти свойства были заменены следующим образом:

  • utc_offset, by utc_offset_minutes
  • opening_hours.open_now, методом isOpen () только в запросах Place Details.

Кроме того, для запросов «Поиск места», «Поиск рядом» и «Текстовый поиск» мы предлагаем альтернативные решения для определения того, открыто ли место.

В результате, начиная с 20 ноября 2020 года, библиотека «Места» и JavaScript API Карт перестают принимать utc_offset и вложенное поле opening_hours.open_now в параметре fields и перестаньте возвращать их в ответ на такие запросы. Вместо этого вы получите ошибку «Неподдерживаемое имя поля» при использовании этих свойств в параметре fields и значение «undefined» при чтении этих свойств из объекта PlaceResult в ответе.

Если вы этого еще не сделали, использование параметра fields в запросах Place Details сэкономит ваши деньги, если вам не нужны все поля для возвращаемых мест. Если вы не укажете хотя бы одно поле в запросе или опустите параметр fields в запросе, будут возвращены все возможные поля и будет выставлен соответствующий счет для всех SKU данных.

Что мне нужно сделать?

До 20 ноября 2020 года следуйте руководству «Переместить поле», чтобы выполнить необходимые замены свойств и методов, а также просмотреть альтернативные варианты получения данных opening_hours, чтобы предотвратить ухудшение пользовательского опыта. Мы также недавно опубликовали видео, в котором объясняется, как получить текущий открытый статус с помощью сведений о месте с помощью метода isOpen и поля utc_offset_minutes.

Как всегда, вы можете связаться с нашей службой поддержки Google Maps Platform с любыми вопросами.

Спасибо за выбор платформы Google Maps.

Наш адрес