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

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

השדה opening_hours.open_now

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

בקשות ל'פרטי המקום'

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

בבקשות לפרטים על מקומות, במקום לבקש את opening_hours.open_now בפרמטר הבקשה fields, צריך לכלול את opening_hours ואת utc_offset_minutes בפרמטר הבקשה fields, ולאחר מכן להפעיל את השיטה 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.