Migracja pola Miejsce (open_now, utc_offset)

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

opening_hours.open_now pole

W tej sekcji pokazujemy, jak zaktualizować tę funkcję w przypadku każdego typu żądania Places.

Żądania dotyczące informacji o miejscu

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

W przypadku żądań szczegółów miejsca zamiast wysyłać żądanie opening_hours.open_now w parametrze żądania fields, uwzględnij opening_hours i utc_offset_minutes w parametrze żądania fields, a następnie wywołaj metodę opening_hours.isOpen() na zwróconym obiekcie google.maps.places.PlaceResult, aby sprawdzić, czy miejsce jest otwarte. Poniższy przykład pokazuje żądanie szczegółów miejsca, które określa, czy 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.
    }
});

Żądania Find Place

W przypadku próśb o znalezienie miejsca nie ma zamiennika pola opening_hours.open_now. Zalecamy wysłanie żądania szczegółów miejsca, aby uzyskać informacje o opening_hours.

Żądania wyszukiwania w pobliżu i wyszukiwania tekstowego

W przypadku zapytań Nearby Search i Text Search możesz użyć parametru żądania openNow, który filtruje wyniki, aby uwzględniać tylko otwarte obecnie miejsca.

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

Aby wyświetlić wszystkie miejsca ORAZ wskazać stan openNow, najpierw wyślij żądanie za pomocą openNow:false, aby uzyskać wszystkie miejsca, a potem wyślij żądanie za pomocą openNow:true, aby uzyskać tylko otwarte miejsca. Następnie połącz odpowiedzi.

utc_offset pole

W przypadku żądań dotyczących szczegółów miejsca pole utc_offset jest zastępowane polem utc_offset_minutes. W parametrze żądania fields po prostu zastąp wystąpienia znaku utc_offset znakiem utc_offset_minutes, a podczas odczytywania tych informacji z PlaceResult.