API لخرائط الطقس

https://api.rainviewer.com/public/weather-maps.json

الهدف والوصف

يحتوي على بيانات رادار الطقس الماضية (لمدة ساعتين) وتوقعات حالة الطقس (لمدة 30 دقيقة) وبيانات الأقمار الصناعية السابقة بالأشعة تحت الحمراء (لمدة ساعتين). مناسب للعرض في التطبيقات أو على المواقع الإلكترونية أو في أي برنامج خرائط آخر. يمكن استخدامه أيضًا كمصدر لواجهة برمجة تطبيق الطقس.

مثال على ملف قاعدة البيانات

وفيما يلي مثال على ملف API لخرائط الطقس مع إطارين لكل قسم بيانات. بيانات المثال قديمة ولا يمكن استخدامها في الاستعلامات الفعلية. للحصول على البيانات الفعلية، يرجى فتح ملف API ذاته.

{
  "version": "2.0",
  "generated": 1609402525,
  "host": "https://tilecache.rainviewer.com",
  "radar": {
    "past": [
      {
        "time": 1609401600,
        "path": "/v2/radar/1609401600"
      },
      {
        "time": 1609402200,
        "path": "/v2/radar/1609402200"
      }
    ],
    "nowcast": [
      {
        "time": 1609402800,
        "path": "/v2/radar/nowcast_6b3c5a659cf4"
      },
      {
        "time": 1609403400,
        "path": "/v2/radar/nowcast_dd3474d83b20"
      }
    ]
  },
  "satellite": {
    "infrared": [
      {
        "time": 1609401600,
        "path": "/v2/satellite/0680143a9470"
      },
      {
        "time": 1609402200,
        "path": "/v2/satellite/ba88bf38ac55"
      }
    ]
  }
}

كائن الجذر

المفتاحالوصفالقيممثال
versionإصدار API.String(8)“2.0.1”
generatedتاريخ توقيت Unix الزمني (UTC) عندما تم إنشاء ملف الـ API هذا. يفيد في التحقق من وجود تحديثات.Int(8)1609402525
hostالمضيف والبروتوكول للصور.String(255)https://tilecache.rainviewer.com
radarخرائط رادار الطقس.كائن الرادار 
satelliteخرائط القمر الصناعي.كائن القمر الصناعي 

كائن الرادار

المفتاحالوصفالقيممثال
pastإطارات رادار الطقس الماضية. ساعتان بفترات فاصلة بطول 10 دقائق.مصفوفة (كائن الإطار) 
nowcastإطارات رادار الطقس المستقبلية. 30 دقيقة أو 60 دقيقة مقابل رعاية ذهبية + وAPI بلاتينية.مصفوفة (كائن الإطار) 

كائن القمر الصناعي

المفتاحالوصفالقيممثال
infraredآخر ساعتين من بيانات الأقمار الصناعية بالأشعة تحت الحمراء (قناة 13) من الأقمار الصناعية المتاحة.مصفوفة (كائن الإطار) 

كائن الإطار

المفتاحالوصفالقيممثال
timeبيانات إنشاء إطار الخريطة بتنسيق توقيت زمني UNIX (UTC). يحتوي إطار الخريطة عادةً على صور (الرادار والأقمار الصناعية) بتوقيتات مختلفة، فلا يعد هذا الوقت الخاص بالبيانات أو وقت إنشاء الإطار.Int(8)1609401600
pathالامتداد الأساسي لصور ذلك الإطار. للحصول على معلومات حول طريقة استخدامه، يرجى الرجوع إلى طريقة استخدام معلومات المضيف `` و المسار في الجزء التالي من هذه الصفحةString(255)/v2/satellite/0680143a9470

كن راعيًا لنا!

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

كن راعيًا لنا

طريقة استخدام معلومات المضيف و المسار

تمامًا مثل تاريخ واجهة برمجة التطبيقات، يجب عليك استخدام بيانات المضيف <code>والمسار</code> في واجهة برمجة التطبيقات كجزء من عنوان URL. جميع عناوين URL المتاحة ومعلماتها موصوفة أدناه.

يبدأ كل عنوان url بـ {host}، حيث:

URLالوصف
{path}/{size}/{z}/{x}/{y}/{color}/{options}.pngبيانات الرادار: تعرض مربعًا واحدًا ببيانات انعكاس الرادار المركبة، بحجم ونظام ألوان وخيارات إضافية محددة.
{path}/{size}/{z}/{lat}/{lon}/{color}/{options}.pngبيانات الرادار: نفس الارتباط أعلاه، ولكن مع المركز في الإحداثيات المحددة (EPSG: 4326) وحجم التكبير المطلوب. مثالي للأدوات المصغرة
{path}/{big_size}/{color}/{options}.pngصورة مركبة مع انعكاس الرادار لكل دول العالم. تتكون ببطء، حتى 10 ثوانٍ لكل عملية تحميل صورة. لا يمكن أن تكون سلسة. ملاحظة هامة: يجب أن يكون مخطط الألوان وغطاء الثلج لبيانات القمر الصناعي دائمًا “0”.

تغطية رادار الطقس

بالإضافة إلى ذلك، يتوفر منتج آخر: تغطية رادار الطقس للغطاء. يعرض هذا الغطاء المناطق المشمولة في رادار الطقس (مناطق شفافة) وغير المشمولة (مناطق سوداء). لا نحدث هذا الغطاء بصورة دورية. تُستخدم الروابط نفسها للرادار والأقمار الصناعية، ولكن دون خيارات أو نظام ألوان.

URLالوصف
/v2/coverage/0/{size}/{z}/{x}/{y}/0/0_0.pngمربع التغطية: عند توفر بيانات الرادار (مناطق شفافة) وعند عدم توفرها (مناطق سوداء).
/v2/coverage/0/{size}/{z}/{lat}/{lon}/0/0_0.pngبيانات التغطية على النحو الوارد أعلاه ولكن لإحداثيات محددة للمركز (خطوط الطول والعرض).
/v2/coverage/0/{big_size}/0/0_0.pngمربع تغطية مركب لجميع أنحاء العالم في ذات الوقت. تتكون ببطء.

أمثلة

يرجى الرجوع إلى الصفحة الخاصة بالأمثلة.

شعار RainViewer RainViewer