Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Các trường Places opening_hours.open_now và utc_offset sẽ ngừng hoạt động kể từ ngày 20 tháng 11 năm 2019 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 cho bạn biết cách cập nhật mã để ngừng sử dụng các trường này.
opening_hours.open_now trường
Phần này cho biết 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.
Đối với yêu cầu Chi tiết về địa điểm, 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 minh hoạ một yêu cầu Chi tiết về địa điểm để xác định xem một địa điểm có đang mở cửa hay không:
newgoogle.maps.places.PlacesService(attrContainer).getDetails({placeId:'...',fields:['opening_hours','utc_offset_minutes'],},function(place,status){if(status!=='OK')return;// something went wrongconstisOpenAtTime=place.opening_hours.isOpen(newDate('December 17, 2020 03:24:00'));if(isOpenAtTime){// We know it's open.}constisOpenNow=place.opening_hours.isOpen();if(isOpenNow){// We know it's open.}});
Đối với các yêu cầu Tìm kiếm lân cận và Tìm kiếm bằng văn bản, bạn có thể sử dụng tham số yêu cầu openNow. Tham số này 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 các địa điểm đang mở cửa. Sau đó, hãy hợp nhất các câu trả lời.
utc_offset trường
Trong các yêu cầu về Thông tin chi tiết về địa điểm, trường utc_offset sẽ đượ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.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[[["\u003cp\u003eThe Places fields \u003ccode\u003eopening_hours.open_now\u003c/code\u003e and \u003ccode\u003eutc_offset\u003c/code\u003e are deprecated and will be turned off on February 20, 2021 in the Places Library, Maps JavaScript API.\u003c/p\u003e\n"],["\u003cp\u003eFor Place Details requests, use the \u003ccode\u003eopening_hours.isOpen()\u003c/code\u003e method and include \u003ccode\u003eopening_hours\u003c/code\u003e and \u003ccode\u003eutc_offset_minutes\u003c/code\u003e in the \u003ccode\u003efields\u003c/code\u003e request parameter instead of \u003ccode\u003eopening_hours.open_now\u003c/code\u003e and \u003ccode\u003eutc_offset\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFor Find Place requests, it is recommended to make a Place Details request to get \u003ccode\u003eopening_hours\u003c/code\u003e information.\u003c/p\u003e\n"],["\u003cp\u003eFor Nearby Search and Text Search requests, use the \u003ccode\u003eopenNow\u003c/code\u003e request parameter to filter results based on open/closed status.\u003c/p\u003e\n"],["\u003cp\u003eReplace \u003ccode\u003eutc_offset\u003c/code\u003e with \u003ccode\u003eutc_offset_minutes\u003c/code\u003e in Place Details requests for the UTC offset information.\u003c/p\u003e\n"]]],[],null,["# Place Field Migration (open_now, utc_offset)\n\n\u003cbr /\u003e\n\nThe Places fields `opening_hours.open_now` and `utc_offset` are deprecated as\nof November 20, 2019, and will be turned off on\nFebruary 20, 2021. These fields are deprecated ONLY in the\nPlaces Library, Maps JavaScript API. This guide shows you how to update your code to\nstop using these fields.\n\n`opening_hours.open_now` field\n------------------------------\n\nThis section shows how to update this functionality for each type of Places\nrequest.\n\n### Place Details requests\n\nThe `opening_hours.open_now` field is replaced by the\n[`opening_hours.isOpen()`](/maps/documentation/javascript/reference/places-service#PlaceOpeningHours)\nmethod. \n\nFor [Place Details requests](/maps/documentation/javascript/places#place_details_requests),\ninstead of requesting `opening_hours.open_now` in the `fields` request\nparameter, include `opening_hours` and `utc_offset_minutes` in the `fields`\nrequest parameter, then call the `opening_hours.isOpen()` method on the returned\n`google.maps.places.PlaceResult` object to check whether the place is open. The\nfollowing example shows a Place Details request that determines whether a place\nis open: \n\n new google.maps.places.PlacesService(attrContainer).getDetails({\n placeId: '...',\n fields: ['opening_hours','utc_offset_minutes'],\n }, function (place, status) {\n if (status !== 'OK') return; // something went wrong\n const isOpenAtTime = place.opening_hours.isOpen(new Date('December 17, 2020 03:24:00'));\n if (isOpenAtTime) {\n // We know it's open.\n }\n\n const isOpenNow = place.opening_hours.isOpen();\n if (isOpenNow) {\n // We know it's open.\n }\n });\n\n### Find Place requests\n\nFor [Find Place requests](/maps/documentation/javascript/places#find_place_requests),\nthere is no replacement for the `opening_hours.open_now` field. We recommend\nmaking a [Place Details request](/maps/documentation/javascript/places#place_details_requests)\nto get `opening_hours` information.\n\n### Nearby Search \\& Text Search requests\n\nFor Nearby Search and Text Search requests, you can use the [`openNow`](/maps/documentation/javascript/reference/places-service#PlaceSearchRequest)\nrequest parameter, which has the effect of filtering results to include only\nplaces that are currently open.\n\n- `openNow:false` returns all places.\n- `openNow:true` returns only places that are currently open.\n\nTo list all places AND indicate `openNow` status, first make a request using\n`openNow:false` to get all places, then make a request using `openNow:true` to\nget open places only. Then, merge the responses.\n\n`utc_offset` field\n------------------\n\nIn Place Details requests, the `utc_offset` field is replaced by the\n`utc_offset_minutes` field. Simply replace occurrences of `utc_offset` with\n`utc_offset_minutes` in the `fields` request parameter, and when reading this\ninformation from `PlaceResult`."]]
