Migracja pola miejsca (open_now, utc_offset)

Pola opening_hours.open_now i utc_offset są wycofywane 20 listopada 2019 roku i zostaną wyłączone 20 lutego 2021 roku. Te pola zostały wycofane TYLKO w Bibliotece miejsc i interfejsie Maps JavaScript API. Z tego przewodnika dowiesz się, jak zaktualizować kod, by przestać używać tych pól.

Pole opening_hours.open_now

Z tej sekcji dowiesz się, jak zaktualizować tę funkcję w przypadku każdego typu żądań związanych z Miejscami.

Prośby o szczegóły miejsca

Pole opening_hours.open_now jest zastępowane metodą opening_hours.isOpen().

W przypadku żądań informacji o miejscu zamiast żądania opening_hours.open_now w parametrze żądania fields umieść opening_hours i utc_offset_minutes w parametrze żądania fields, a potem wywołaj metodę opening_hours.isOpen() w zwróconym obiekcie google.maps.places.PlaceResult, aby sprawdzić, czy miejsce jest otwarte. Poniższy przykład przedstawia żądanie informacji o miejscu, które określa, czy dane miejsce jest otwarte:

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

Znajdowanie żądań miejsc

W przypadku żądań Znajdź miejsce pole opening_hours.open_now nie ma zastępowania. Zalecamy wysłanie żądania szczegółów miejsca, aby uzyskać informacje o opening_hours.

Wyszukiwanie w pobliżu i zapytania tekstowe

W przypadku żądań w pobliżu dotyczących wyszukiwania i wyszukiwania tekstowego możesz użyć parametru żądania openNow. W rezultacie wyniki wyszukiwania będą uwzględniać tylko miejsca, które są obecnie otwarte.

• openNow:false zwraca wszystkie miejsca.
• openNow:true zwraca tylko te miejsca, które są obecnie otwarte.

Aby wyświetlić wszystkie miejsca ORAZ wskazują stan openNow, najpierw poproś o dostęp do wszystkich miejsc za pomocą openNow:false, a potem wyślij prośbę za pomocą openNow:true, by uzyskać tylko miejsca otwarte. Następnie scal odpowiedzi.

Pole utc_offset

W żądaniach szczegółów miejsca pole utc_offset jest zastępowane polem utc_offset_minutes. Wystarczy, że zastąpisz wystąpienia utc_offset wartością utc_offset_minutes w parametrze żądania fields oraz gdy przeczytasz te informacje z tagu PlaceResult.