سيتم إيقاف حقلَي "الأماكن" opening_hours.open_now
وutc_offset
اعتبارًا من 20 تشرين الثاني (نوفمبر) 2019، وسيتم إيقافهما في 20 شباط (فبراير) 2021. تم إيقاف هذه الحقول فقط في
"مكتبة الأماكن" و"واجهة برمجة التطبيقات JavaScript للخرائط". يوضح لك هذا الدليل كيفية تحديث الرمز لإيقاف استخدام هذه الحقول.
حقل واحد (opening_hours.open_now
)
يوضّح هذا القسم طريقة تعديل هذه الوظيفة لكل نوع من أنواع الطلبات في "الأماكن".
طلبات تفاصيل المكان
يتم استبدال الحقل 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
.