Migracja pola miejsca (open_now, utc_offset)

Pola Miejsca opening_hours.open_now i utc_offset zostały wycofane 20 listopada 2019 r. i zostaną wyłączone 20 lutego 2021 r. Te pola są wycofane TYLKO z biblioteki Miejsc, Maps JavaScript API. Z tego przewodnika dowiesz się, jak zaktualizować kod, aby nie używać tych pól.

opening_hours.open_now pole

W tej sekcji dowiesz się, jak zaktualizować tę funkcję w przypadku każdego typu żądania dotyczącego Miejsc.

Prośby o szczegóły miejsca

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

W przypadku żądań szczegółów miejsca zamiast wysyłać parametr opening_hours.open_now w parametrze żądania fields, dodaj do parametru fields parametry opening_hoursutc_offset_minutes, a następnie wywołaj metodę opening_hours.isOpen() zwracanego obiektu google.maps.places.PlaceResult, aby sprawdzić, czy miejsce jest otwarte. Poniższy przykład pokazuje prośbę o szczegóły miejsca, która 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.
    }
});

Prośby o znajdowanie miejsca

W przypadku prośb o znajdowanie miejsc pole opening_hours.open_now nie zastępuje wartości. Zalecamy wysłanie żądania szczegółów miejsca w celu uzyskania informacji opening_hours.

Żądania wyszukiwania w pobliżu i wyszukiwania tekstowego

W przypadku żądań wyszukiwania w pobliżu i wyszukiwania tekstowego możesz użyć parametru żądania openNow. W rezultacie wyniki będą filtrowane tak, aby uwzględniały tylko aktualnie otwarte miejsca.

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

Aby wyświetlić listę wszystkich miejsc ORAZ określić stan openNow, najpierw wyślij żądanie za pomocą polecenia openNow:false, by wyświetlić wszystkie miejsca, a następnie użyj parametru openNow:true, by wyświetlić tylko otwarte miejsca. Następnie scal odpowiedzi.

utc_offset pole

W prośbach o szczegóły miejsca pole utc_offset jest zastępowane polem utc_offset_minutes. Wystarczy zastąpić wystąpienia utc_offset ciągiem utc_offset_minutes w parametrze żądania fields i odczytać te informacje z PlaceResult.