Di chuyển trường Địa điểm (open_now, utc_offset)

Kể từ ngày 20 tháng 11 năm 2019, các trường Địa điểm opening_hours.open_now và utc_offset sẽ không được dùng nữa và sẽ bị tắt vào ngày 20 tháng 2 năm 2021. Các trường này CHỈ không được dùng nữa trong Thư viện địa điểm, Maps JavaScript API. Hướng dẫn này sẽ chỉ cho bạn cách cập nhật mã để ngừng sử dụng các trường này.

Trường opening_hours.open_now

Phần này trình bày cách cập nhật chức năng này cho từng loại yêu cầu về Địa điểm.

Yêu cầu về Place Details

Trường opening_hours.open_now được thay thế bằng phương thức opening_hours.isOpen().

Đối với các yêu cầu về Place Details, thay vì yêu cầu opening_hours.open_now trong tham số yêu cầu fields, hãy thêm opening_hours và utc_offset_minutes vào tham số yêu cầu fields, sau đó gọi phương thức opening_hours.isOpen() trên đối tượng google.maps.places.PlaceResult được trả về để kiểm tra xem địa điểm có mở cửa hay không. Ví dụ sau đây cho thấy một yêu cầu về Place Details giúp xác định xem một địa điểm có mở cửa hay không:

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.
    }
});

Yêu cầu Tìm địa điểm

Đối với các yêu cầu Tìm địa điểm, không có trường nào thay thế cho trường opening_hours.open_now. Bạn nên đưa ra yêu cầu về Place Details để nhận thông tin opening_hours.

Yêu cầu Nearby Search và Tìm kiếm bằng văn bản

Đối với các yêu cầu Nearby Search và Tìm kiếm văn bản, bạn có thể sử dụng openNow tham số yêu cầu, có tác dụng lọc kết quả để chỉ bao gồm những địa điểm hiện đang mở cửa.

• openNow:false trả về tất cả địa điểm.
• openNow:true chỉ trả về những địa điểm hiện đang mở cửa.

Để liệt kê tất cả địa điểm VÀ cho biết trạng thái openNow, trước tiên, hãy đưa ra yêu cầu bằng cách sử dụng openNow:false để nhận tất cả địa điểm, sau đó đưa ra yêu cầu bằng cách sử dụng openNow:true để chỉ nhận những địa điểm đang mở cửa. Sau đó, hãy hợp nhất các phản hồi.

Trường utc_offset

Trong các yêu cầu về Place Details, trường utc_offset được thay thế bằng trường utc_offset_minutes. Bạn chỉ cần thay thế các lần xuất hiện của utc_offset bằng utc_offset_minutes trong tham số yêu cầu fields và khi đọc thông tin này từ PlaceResult.