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

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

حقل opening_hours.open_now

يوضّح هذا القسم كيفية تعديل هذه الوظيفة لكل نوع من طلبات Places.

طلبات تفاصيل المكان

يتم استبدال الحقل 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.
    }
});

طلبات Find Place

بالنسبة إلى طلبات البحث عن مكان، لا يوجد بديل للحقل 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.