Migracja pola miejsca (open_now, utc_offset)

Pola opening_hours.open_now i utc_offset w Miejscach Google 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 pokazujemy, jak zaktualizować tę funkcję w przypadku każdego typu żądania dotyczącego Miejsc.

Prośby o szczegóły miejsca

Pole opening_hours.open_now zostaje zastąpione metodą opening_hours.isOpen().

W przypadku żądań dotyczących informacji o miejscu zamiast żądania opening_hours.open_now w parametrze żądania fields dodaj opening_hours i utc_offset_minutes w parametrze żądania fields, a następnie wywołaj metodę opening_hours.isOpen() w zwróconym obiekcie google.maps.places.PlaceResult, aby sprawdzić, czy miejsce jest otwarte. Poniższy przykład pokazuje żą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 próśb o miejsce

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 połącz odpowiedzi.

utc_offset pole

W żądaniach dotyczących informacji o miejscu pole utc_offset jest zastępowane polem utc_offset_minutes. Wystarczy zastąpić wystąpienia utc_offset wartością utc_offset_minutes w parametrze żądania fields oraz odczytać te informacje z PlaceResult.