تم إيقاف الحقلَين opening_hours.open_now وutc_offset في Places نهائيًا اعتبارًا من 20 تشرين الثاني (نوفمبر) 2019، وسيتم إيقافهما في 20 شباط (فبراير) 2021. تم إيقاف هذه الحقول نهائيًا في Places Library ضِمن 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.
}
});
طلبات Find Place
بالنسبة إلى طلبات البحث عن مكان، لا يوجد بديل للحقل 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.