نقل حقول المكان (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.