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

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

Поле opening_hours.open_now

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

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

Поле 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.
    }
});

Найти запросы мест

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

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

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

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

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

поле utc_offset

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