نقل حقول المكان (open_now, utc_offset)

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