حالات الاستخدام

إضافة ساعات العمل المحلية إلى موقع سلسلة امتياز تجاري

كان لدى سلسلة امتياز تجاري بفروع موزعة على عدة مناطق زمنية مشكلة في موقعها لم يفكر أحد في إصلاحها: قسم "ساعات العمل" المركزي في صفحة كل فرع كان يعرض الجدول نفسه، الذي كتبه شخص في المقر الرئيسي مرة واحدة ونُسخ إلى كل متجر، بغض النظر عن المنطقة الزمنية التي يعمل فيها ذلك المتجر فعليًا. ففرع في الجهة الغربية من منطقة السلسلة يغلق عند الساعة 9 مساءً بحسب ساعته المحلية كان يبدو على الموقع كأنه يغلق قبل موعده الفعلي بثلاث ساعات، لأن الساعات كُتبت وفق توقيت المقر الرئيسي ولم تُعدَّل لكل فرع.

تطلب الإصلاح ربط منطقة زمنية حقيقية بكل فرع بدلًا من معاملة "ساعات العمل" كمحتوى مشترك واحد. فلكل عنوان فرع من فروع السلسلة، حدّدت الشركة الإحداثيات عبر /v1/forward ومرّرت تلك الإحداثيات إلى /v1/timezone، التي تعيد اسم المنطقة الزمنية وفق IANA لتلك النقطة بالضبط. وتخزين الاسم بدلًا من فارق ثابت يعني أن عرض الساعات بقي صحيحًا تلقائيًا عبر تغييرات التوقيت الصيفي، دون حاجة أي شخص في المقر الرئيسي إلى تذكر تحديث أي شيء مرتين في السنة.

مع حفظ المنطقة الزمنية الخاصة بكل فرع، أصبح الموقع قادرًا أخيرًا على فعل ما كان ينبغي أن يفعله منذ البداية: أن يُظهر للزائر ما إذا كان فرع معين مفتوحًا الآن، محسوبًا بشكل صحيح وفق ساعة ذلك الفرع نفسه، لا وفق ساعة الزائر ولا ساعة المقر الرئيسي. فالزائر الذي يتصفح من الطرف الآخر من البلاد صفحة فرع لمتجر على الساحل المقابل رأى عبارة دقيقة مثل "مفتوح الآن" أو "مغلق، يفتح الساعة 8 صباحًا" تعكس التوقيت المحلي الفعلي لذلك المتجر، وهي النسخة الوحيدة من تلك المعلومة المفيدة فعلًا لشخص على وشك القيادة إليه.

أضافت الشركة موقع الزائر نفسه فوق ذلك في أداة البحث عن الفروع تحديدًا. فقد حدّدت /v1/ip الإحداثيات التقريبية للعميل الزائر، وغُذّيت في ترتيب المسافات نفسه الذي تستخدمه أدوات البحث الأخرى، بحيث حصل العميل الباحث عن أقرب فرع مفتوح على نتائج تأخذ في الاعتبار المسافة وكون ذلك الفرع مفتوحًا فعلًا لحظة البحث معًا، بدلًا من قائمة مرتبة حسب المسافة تتضمن عدة متاجر مغلقة حاليًا مختلطة بالمفتوحة.

كان هذا إصلاحًا صغيرًا وغير مرئي في معظمه، بمعنى أن زائر الموقع لن يخطر بباله أبدًا أن ينسب الفضل في أي شيء إلى "التعامل الصحيح مع المناطق الزمنية"، بل سيلاحظ ببساطة، أو على الأرجح لن يلاحظ، أن الساعات المعروضة تطابق الواقع. وهذه عمومًا علامة الإصلاح الذي يستحق التنفيذ: لا أحد يمدحه، لكن كل من كان سيرتبك من النسخة القديمة لم يعد مرتبكًا ببساطة.

جرى الترميز الجغرافي مرة واحدة لكل فرع ضمن إعداد لمرة واحدة، وهي دفعة صغيرة نظرًا لعدد الفروع التي تديرها معظم سلاسل الامتياز، وضمن الحصة اليومية المجانية بفارق كبير. وأضافت استعلامات المنطقة الزمنية لميزة "مفتوح الآن" الموجهة للزوار حجمًا مستمرًا خفيفًا مرتبطًا بزيارات أداة البحث عن الفروع، وهو أيضًا ضمن الفئة المجانية بسهولة لسلسلة امتياز متوسطة الحجم، مع توفر الرصيد المسبق الدفع إذا تسببت حملة تسويقية وطنية في ارتفاع غير معتاد في عمليات البحث عن الفروع.

توثيق نقطتي النهاية موجود في /docs/forward-geocoding/ و/docs/timezone-lookup/.