تم إيقاف حقلَي "الأماكن" 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
.