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

Поля Places opening_hours.open_now и utc_offset устарели с 20 ноября 2019 года и будут отключены 20 февраля 2021 года. Эти поля устарели ТОЛЬКО в библиотеке Places, Maps 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 . Мы рекомендуем сделать запрос Place Details для получения информации 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 .