העברת מקום למקום (open_now, utc_offset)

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

השדה opening_hours.open_now

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

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

השדה opening_hours.open_now מוחלף ב-method 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

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