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