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

تم إيقاف حقلَي Places‏ 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.