توثيق meridian
أدلة لاستخدام لوحة التحكم والاشتراكات وسلوك واجهة برمجة التطبيقات.
البدء
meridian لوحة طقس لعدة أماكن في آنٍ واحد. ابحث عن مدينة، افتح صفحتها، ثبّتها في مواقعك، وتابع الحرارة والأحوال والتوقعات القصيرة. لا تحتاج حسابًا. مدنك المثبتة ومعظم التفضيلات تبقى على هذا الجهاز.
لوحة التحكم
من الأعلى إلى الأسفل: 1. البطل — نص ترحيب، بحث، وفحص سريع لطقس موقعك. 2. مواقعك — بطاقات طقس للأماكن المثبتة. 3. القريب والشائع — عمودان: بالقرب منك والبحث الشائع. 4. إعلان تحت مواقعك (عنصر نائب أو AdSense). 5. Journal — دوّار مقالات. أخفِ الإعلان وJournal باستخدام NEXT_PUBLIC_SHOW_HOME_STRETCH=0.
تفاصيل المدينة
نتائج البحث وبطاقات الصفحة الرئيسية تفتح صفحة لذلك المكان. لا تحتاج تثبيت مدينة لعرضها. التثبيت يضيفها فقط إلى مواقعك في الصفحة الرئيسية. بعض مدن العرض والأماكن المعروفة للموقع تفتح دائمًا؛ العناوين غير المعروفة تعرض حالة فارغة مفيدة أو 404.
الاشتراكات
يمكنك طلب أن يرسل لك meridian بريدًا — دون تسجيل دخول. اختر نشرة عن المنتج، ملخصًا أسبوعيًا لمدينة مثبتة، و/أو تنبيهات طقس عندما تطابق الأحوال ما يهمك. الكل اختياري؛ كل بريد يتضمن طريقة للإيقاف.
تحقيق الدخل والموافقة
meridian يعمل كموقع طقس مجاني. لا يوجد دفع Premium فعّال ولا خطة مدفوعة تزيل الإعلانات. الإعلانات تظهر فقط إذا سمحت بموافقة الإعلانات وضبط المشغّل Google AdSense.
أيقونات الطقس
صور الطقس على البطاقات والتوقعات هي أيقونات خط/تعبئة واضحة (Meteocons لـ Bas Milius، رخصة MIT). تعرض مشمسًا وغائمًا ومطرًا وثلجًا وضبابًا وما شابه بجانب الوصف المكتوب — النص يحمل المعنى إن فشل تحميل الصورة.
القريب والشائع
تحت مواقعك، الصفحة الرئيسية تعرض قائمتين قصيرتين من الأماكن. بالقرب منك — أماكن مقترحة قرب منزلك أو منطقتك بأحوال مباشرة. ليست سجلًا خاصًا بكل ما بحثت عنه. البحث الشائع — أماكن يُبحث عنها كثيرًا على هذا الموقع. هذا أيضًا على مستوى الموقع، وليس «سجلك الشخصي».
التوقعات والتخزين المؤقت
يمكن للزوار العاديين تخطيها. تشرح كيف يخزّن الموقع ويحدّث بيانات الطقس لمن يشغّلون أو يدمجون meridian. ببساطة: متصفحك يتذكر قراءة حديثة؛ الخادم يتذكر قراءات مشتركة حتى لا نستدعي مزود الطقس عند كل نقرة.
حدود واجهة برمجة التطبيقات
هذه الصفحة لمشغّلي الموقع. بيانات الطقس المُشاهدة مشتركة وصديقة للذاكرة المؤقتة حتى تُستهلك حدود OpenWeather المجانية (افتراضي 1000 استدعاء/يوم) بشكل أقل.
مرجع واجهة برمجة التطبيقات
هذه الصفحة للمطورين والمشغّلين الذين يدمجون APIs meridian — الزوار العاديون يمكنهم تخطيها. كل مسارات API هي معالجات Next.js App Router تحت src/app/api/. الطقس وgeocode يحتاجان OPENWEATHER_API_KEY. مسارات cron تحتاج Authorization: Bearer CRON_SECRET. مسارات الإدارة تحتاج cookie جلسة إدارة مصادق (meridian_admin_session) بعد /login، ما لم ينطبق ALLOW_DEV_ADMIN_BYPASS في التطوير.
النشر والبيئة
هذه الصفحة لمن ينشرون meridian. الزوار العاديون لا يحتاجون هذه الإعدادات. العرض التجريبي يعمل بـ OPENWEATHER_API_KEY فقط؛ الباقي stretch اختياري.