نقل بيانات حقل "الموقع الجغرافي" (open_now وutc_offset)

تمّ إيقاف الحقلَين opening_hours.open_now وutc_offset في "بيانات الأماكن" نهائيًا اعتبارًا من 20 نوفمبر 2019، وسيتم إيقافهما في 20 فبراير 2021. تمّ إيقاف هذَين الحقلَين نهائيًا في Places Library وMaps JavaScript API فقط. يوضّح لك هذا الدليل كيفية تعديل الرمز البرمجي للتوقّف عن استخدام هذَين الحقلَين.

حقل 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.