reviewsהשקת Places UI Kit: ספריית רכיבים מוכנה לשימוש בעלות נמוכה, שמאפשרת לכם להוסיף לכל מפה שתבחרו את ממשק המשתמש המוכר של 'מקומות' במפות Google. כדאי לנסות אותו ולשלוח לנו משוב כדי לעזור לנו לעצב את העתיד של GMP.
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
השדות 'מקומות' opening_hours.open_now ו-utc_offset הוצאו משימוש החל מ-20 בנובמבר 2019, ויושבתו ב-20 בפברואר 2021. השדות האלה הוצאו משימוש רק בספריית המקומות, Maps JavaScript API. במדריך הזה מוסבר איך לעדכן את הקוד כדי להפסיק להשתמש בשדות האלה.
שדה opening_hours.open_now
בקטע הזה מוסבר איך לעדכן את הפונקציונליות הזו לכל סוג של בקשה ל-Places.
בבקשות לפרטי מקום, במקום לבקש את opening_hours.open_now בפרמטר הבקשה fields, צריך לכלול את opening_hours ואת utc_offset_minutes בפרמטר הבקשה fields, ואז לקרוא ל-method opening_hours.isOpen() באובייקט google.maps.places.PlaceResult שמוחזר כדי לבדוק אם המקום פתוח. בדוגמה הבאה מוצגת בקשה לקבלת פרטי מקום שקובעת אם מקום מסוים פתוח:
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.}});
בבקשות לחיפוש בקרבת מקום ולחיפוש טקסטואלי, אפשר להשתמש בפרמטר הבקשה openNow כדי לסנן את התוצאות כך שיכללו רק מקומות שפתוחים כרגע.
openNow:false מחזיר את כל המקומות.
openNow:true מחזירה רק מקומות שפתוחים כרגע.
כדי לקבל רשימה של כל המקומות ולציין את הסטטוס openNow, קודם שולחים בקשה באמצעות openNow:false כדי לקבל את כל המקומות, ואז שולחים בקשה באמצעות openNow:true כדי לקבל רק את המקומות הפתוחים. לאחר מכן, ממזגים את התשובות.
שדה utc_offset
בבקשות לפרטי מקום, השדה utc_offset מוחלף בשדה utc_offset_minutes. פשוט מחליפים את המופעים של utc_offset ב-utc_offset_minutes בפרמטר הבקשה fields, וכשקוראים את המידע הזה מ-PlaceResult.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 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`."]]