Перенос полей Place (open_now, utc_offset)

Поля opening_hours.open_now и utc_offset в Places устарели с 20 ноября 2019 г. и будут отключены 20 февраля 2021 г. Эти поля устарели ТОЛЬКО в библиотеке Places и JavaScript API Карт. В этом руководстве показано, как обновить код, чтобы прекратить использование этих полей.

поле opening_hours.open_now

В этом разделе показано, как обновить эту функциональность для каждого типа запроса Places.

Запросы сведений о месте

Поле opening_hours.open_now заменяется методом opening_hours.isOpen() .

Для запросов Place Details вместо запроса opening_hours.open_now в параметре запроса fields включите opening_hours и utc_offset_minutes в параметр запроса fields , а затем вызовите метод opening_hours.isOpen() для возвращаемого объекта google.maps.places.PlaceResult , чтобы проверить, открыто ли место. В следующем примере показан запрос Place Details, который определяет, открыто ли место:

new google.maps.places.PlacesService(attrContainer).getDetails({
  placeId: '...',
  fields: ['opening_hours','utc_offset_minutes'],
  }, function (place, status) {
    if (status !== 'OK') return; // something went wrong
    const isOpenAtTime = place.opening_hours.isOpen(new Date('December 17, 2020 03:24:00'));
    if (isOpenAtTime) {
        // We know it's open.
    }

    const isOpenNow = place.opening_hours.isOpen();
    if (isOpenNow) {
        // We know it's open.
    }
});

Запросы на поиск места

Для запросов Find Place поле opening_hours.open_now не имеет замены. Для получения информации opening_hours рекомендуем использовать запрос Place Details .

Запросы на поиск поблизости и текстовый поиск

Для запросов поиска поблизости и текстового поиска можно использовать параметр запроса openNow , который позволяет отфильтровать результаты, включив только те места, которые открыты в данный момент.

  • openNow:false возвращает все места.
  • openNow:true возвращает только места, которые открыты в данный момент.

Чтобы получить список всех мест и указать статус openNow , сначала отправьте запрос с параметром openNow:false для получения всех мест, а затем отправьте запрос с параметром openNow:true для получения только открытых мест. Затем объедините ответы.

поле utc_offset

В запросах Place Details поле utc_offset заменяется полем utc_offset_minutes . Просто замените вхождения utc_offset на utc_offset_minutes в параметре запроса fields и при чтении этой информации из PlaceResult .