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