مهاجرت فیلد مکان (open_now، utc_offset)
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فیلدهای Places opening_hours.open_now و utc_offset از 20 نوامبر 2019 منسوخ شده‌اند و در 20 فوریه 2021 خاموش خواهند شد. این فیلدها فقط در کتابخانه مکان‌ها، Maps JavaScript API منسوخ شده‌اند. این راهنما به شما نشان می دهد که چگونه کد خود را به روز کنید تا استفاده از این فیلدها متوقف شود.
قسمت opening_hours.open_now
این بخش نحوه به روز رسانی این عملکرد را برای هر نوع درخواست Places نشان می دهد.
درخواست جزئیات مکان
فیلد opening_hours.open_now با متد opening_hours.isOpen() جایگزین شده است.
برای درخواست‌های Place Details ، به جای درخواست opening_hours.open_now در پارامتر درخواست fields ، opening_hours و utc_offset_minutes را در پارامتر درخواست fields قرار دهید، سپس متد opening_hours.isOpen() را در google.maps.places.PlaceResult برگشتی فراخوانی کنید تا بررسی کنید که آیا مکان باز است یا خیر. مثال زیر یک درخواست Place Details را نشان می‌دهد که تعیین می‌کند یک مکان باز است یا خیر:
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.
}
});
درخواست‌های مکان را پیدا کنید
برای درخواست‌های Find Place ، هیچ جایگزینی برای فیلد opening_hours.open_now وجود ندارد. توصیه می‌کنیم برای دریافت اطلاعات opening_hours ، درخواست جزئیات مکان کنید.
جستجوی نزدیک و درخواست‌های جستجوی متن
برای جستجوی Nearby و درخواست‌های جستجوی متن، می‌توانید از پارامتر درخواست openNow استفاده کنید، که اثر فیلتر کردن نتایج را دارد و فقط مکان‌هایی را که در حال حاضر باز هستند شامل می‌شود.
-
openNow:false همه مکان ها را برمی گرداند. -
openNow:true فقط مکان هایی را برمی گرداند که در حال حاضر باز هستند.
برای فهرست کردن همه مکان‌ها و نشان دادن وضعیت openNow ، ابتدا با استفاده از openNow:false یک درخواست برای دریافت همه مکان‌ها ارسال کنید، سپس با استفاده از openNow:true درخواست کنید تا فقط مکان‌های باز را دریافت کنید. سپس، پاسخ ها را ادغام کنید.
فیلد utc_offset
در درخواست‌های Place Details، فیلد utc_offset با فیلد utc_offset_minutes جایگزین می‌شود. به سادگی در پارامتر درخواست fields و هنگام خواندن این اطلاعات از PlaceResult ، موارد utc_offset با utc_offset_minutes جایگزین کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی."],[[["\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`."]]
