העברת שדות של מקומות (open_now, ‏ utc_offset)

השדות 'מקומות' opening_hours.open_now ו-utc_offset הוצאו משימוש החל מ-20 בנובמבר 2019, ויושבתו ב-20 בפברואר 2021. השדות האלה הוצאו משימוש רק בספריית המקומות, Maps JavaScript API. במדריך הזה מוסבר איך לעדכן את הקוד כדי להפסיק להשתמש בשדות האלה.

שדה opening_hours.open_now

בקטע הזה מוסבר איך לעדכן את הפונקציונליות הזו לכל סוג של בקשה ל-Places.

בקשות Place Details

השדה opening_hours.open_now הוחלף בשיטה opening_hours.isOpen().

בבקשות לפרטי מקום, במקום לבקש את opening_hours.open_now בפרמטר הבקשה fields, צריך לכלול את opening_hours ואת utc_offset_minutes בפרמטר הבקשה fields, ואז להפעיל את ה-method‏ opening_hours.isOpen() באובייקט google.maps.places.PlaceResult שמוחזר כדי לבדוק אם המקום פתוח. בדוגמה הבאה מוצגת בקשה לקבלת פרטי מקום שקובעת אם מקום מסוים פתוח:

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

בקשות לחיפוש מקום

בבקשות לחיפוש מקום, אין תחליף לשדה opening_hours.open_now. מומלץ לשלוח בקשה לקבלת פרטים על מקום כדי לקבל מידע על opening_hours.

בקשות לחיפוש בקרבת מקום ולחיפוש טקסט

בבקשות לחיפוש בקרבת מקום ולחיפוש טקסטואלי, אפשר להשתמש בפרמטר הבקשה openNow כדי לסנן את התוצאות כך שיכללו רק מקומות שפתוחים כרגע.

• ‫openNow:false מחזיר את כל המקומות.
• ‫openNow:true מחזירה רק מקומות שפתוחים כרגע.

כדי לקבל רשימה של כל המקומות ולציין את הסטטוס openNow, קודם שולחים בקשה באמצעות openNow:false כדי לקבל את כל המקומות, ואז שולחים בקשה באמצעות openNow:true כדי לקבל רק את המקומות הפתוחים. לאחר מכן, ממזגים את התשובות.

שדה utc_offset

בבקשות לפרטי מקום, השדה utc_offset מוחלף בשדה utc_offset_minutes. פשוט מחליפים את המופעים של utc_offset ב-utc_offset_minutes בפרמטר הבקשה fields, וכשקוראים את המידע הזה מ-PlaceResult.