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