Migracja pola miejsca (open_now, utc_offset)

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

Pole opening_hours.open_now

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

Prośby o szczegóły dotyczące miejsca

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

W przypadku żądań 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 zwracanym 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 próśb o miejsce

Prośby o znalezienie miejsca nie zastępują pola opening_hours.open_now. Zalecamy przesłanie prośby o informacje o miejscu, aby uzyskać informacje o tym miejscu (opening_hours).

Wyszukiwanie w pobliżu i wyszukiwanie tekstu

W przypadku żądań wyszukiwania w pobliżu i wyszukiwania tekstu możesz używać parametru żądania openNow, dzięki czemu wyniki filtrowania będą obejmować tylko aktualnie otwarte miejsca.

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

Aby wymienić wszystkie miejsca ORAZ wskazać stan „openNow”, najpierw wyślij prośbę o dostęp do wszystkich miejsc za pomocą metody openNow:false, a potem użyj funkcji openNow:true, aby wyświetlić tylko otwarte miejsca. Następnie scal odpowiedzi.

Pole utc_offset

W żądaniach dotyczących szczegółów miejsca pole utc_offset zostało zastąpione polem utc_offset_minutes. Wystarczy zastąpić wystąpienia utc_offset elementem utc_offset_minutes w parametrze żądania fields podczas odczytywania tych informacji z usługi PlaceResult.