Migracja pola miejsca (open_now, utc_offset)

Pola Miejsca opening_hours.open_nowutc_offset zostały wycofane 20 listopada 2019 r. i zostaną wyłączone 20 lutego 2021 r. Te pola są wycofane TYLKO w bibliotece Miejsca w 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 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śby o znalezienie miejsca pole opening_hours.open_now nie może zostać zastąpione. Aby uzyskać informacje opening_hours, zalecamy wysłanie zapytania o szczegóły miejsca.

Prośby o wyszukiwanie w pobliżu i wyszukiwanie tekstowe

W przypadku zapytań o wyszukiwanie w pobliżu i wyszukiwanie tekstowe możesz użyć parametru zapytania openNow, który służy do filtrowania wyników tak, aby zawierały tylko miejsca, które są obecnie otwarte.

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

Aby wyświetlić listę wszystkich miejsc i wskazać stan openNow, najpierw wyślij żądanie za pomocą parametru openNow:false, aby uzyskać listę wszystkich miejsc, a następnie wyślij żądanie za pomocą parametru openNow:true, aby uzyskać listę tylko otwartych miejsc. Następnie scal odpowiedzi.

Pole utc_offset

W prośbach o szczegóły miejsca pole utc_offset jest zastępowane polem utc_offset_minutes. Wystarczy zastąpić wystąpienia parametru utc_offset parametrem utc_offset_minutes w parametrze żądania fields i podczas odczytu tych informacji z parametru PlaceResult.