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

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

поле opening_hours.open_now

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

Запросы на подробную информацию о месте

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

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

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.
    }
});

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

Для запросов на поиск места нет замены для поля opening_hours.open_now . Мы рекомендуем отправлять запрос с подробными сведениями о месте , чтобы получить информацию opening_hours .

Поиск поблизости и текстовые запросы

Для запросов «Поиск поблизости» и «Текстовый поиск» можно использовать параметр запроса 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 .