تلقّي تنبيهات بشأن الطقس

توفّر نقطة النهاية publicAlerts تفاصيل حول تنبيهات أحداث الطقس المحدّدة الصادرة عن وكالات وطنية ودولية موثوقة. توفّر هذه التنبيهات معلومات مهمة قد تنقذ حياة الأشخاص.

تعرض نقطة النهاية تنبيهات الطقس التي تحدث في الوقت الفعلي لخط عرض وخط طول معيّنين. تشمل الأحوال الجوية المتوافقة ما يلي:

• هطول الأمطار: الأمطار والثلوج والبرد والجفاف والمزيد
• درجات الحرارة القصوى: البرد والحرارة والتجمّد والصقيع والرياح الباردة والرطوبة
• أحداث الرياح والعواصف: العواصف الثلجية والأعاصير والأعاصير القمعية والعواصف الاستوائية والعواصف الرعدية وغيرها
• ضعف الرؤية: الضباب والعواصف الترابية والعواصف الثلجية
• المخاطر المرتبطة بالمياه: الفيضانات وأمواج تسونامي والعواصف والمخاطر الساحلية وغيرها
• الأحداث الجيوفيزيائية والجيولوجية: الزلازل والانهيارات الأرضية والنشاط البركاني
• حوادث الحرائق: حرائق الغابات والطقس المسبّب للحرائق والمزيد

للحصول على قائمة كاملة بأحداث الطقس المتوافقة، يُرجى الاطّلاع على أنواع أحداث الطقس.

قد تحتوي التنبيهات على أوصاف مترجَمة أو لا، وذلك حسب ما هو متاح من مصدر البيانات. بسبب القيود المفروضة على مصادر البيانات، يتم عرض المعلومات كما هي (محتوى خام). لمزيد من المعلومات حول مصادر تنبيهات الطقس، يُرجى الاطّلاع على مصادر البيانات.

تعرض واجهة برمجة التطبيقات المعلومات التالية لتنبيه معيّن بشأن الطقس:

• نوع حالة الطقس المرتبطة بالتنبيه
• قائمة بالمناطق المتأثرة مع الإحداثيات التي تحدد الحدود الجغرافية لتلك المناطق
• ملخّص من جملة واحدة عن حالة الطقس
• مستويات الخطورة واليقين والإلحاح
• وصف لتعليمات الإجراءات المقترَحة للجمهور المستهدَف
• اقتراحات الأمان
• وقتَي بدء التنبيه وانتهائه
• اسم الجهة الناشرة وموقعها الإلكتروني

تتيح لك أداة "مستكشف واجهات برمجة التطبيقات" إجراء طلبات مباشرة حتى تتمكّن من التعرّف على واجهة برمجة التطبيقات وخياراتها:

لمحة عن طلبات تنبيهات الطقس

لطلب معلومات عن تنبيهات الطقس، أرسِل طلب استرداد بيانات باستخدام GET إلى:

https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE

أدرِج إحداثيات خط العرض وخط الطول للموقع الجغرافي في معلمات عنوان URL للطلب.

لمحة عن الردود على تنبيهات الطقس

تعرض واجهة Weather API الحقول التالية في نص الردّ:

مصادر البيانات

تعرض نقطة نهاية تنبيهات الطقس البيانات التي ينشرها مقدّمو الخدمات المدرَجون في الجدول التالي. استنادًا إلى إحداثيات خطوط العرض والطول المقدَّمة في الطلب، يعرض نص الاستجابة البيانات من السلطة المحلية المناسبة.

يتبع مقدّمو الخدمات المضمّنون في الخلاصة إرشادات "تنبيهات Google العامة". يجوز لـ Google تعديل قائمة مقدّمي الخدمات في أي وقت.

تحديد المصدر

في جميع شاشات العرض التي تظهر فيها البيانات، يجب أن يتضمّن تطبيق العميل إشارة إلى المصدر الأصلي باستخدام الحقل dataSource:

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

يجب أن يتضمّن مصدر البيانات الاسم الكامل لمصدر البيانات (كما هو موضّح في حقل name) ورابطًا تشعبيًا يؤدي إلى مصدر البيانات باستخدام عنوان URL المقدَّم في حقل authorityUri (على سبيل المثال، "خدمة الأرصاد الجوية الوطنية").

أنواع الأحداث الجوية

تتوفّر أنواع الأحوال الجوية التالية:

سلوك ترجمة الردود

توفّر Google ترجمات لحقل alertTitle فقط. قد تتم أيضًا ترجمة حقول أخرى، مثل eventType وareaName وinstruction وsafetyRecommendations، وذلك حسب اللغات التي يتيحها مصدر البيانات الأصلي، ولكن لا يمكن لـ Google توفير ترجمات مستقلة لهذه الحقول.

استنادًا إلى المَعلمة languageCode المضمّنة في الطلب، من المتوقّع أن يتّبع الحقل alertTitle السلوكيات التالية:

• اللغة languageCode متاحة: إذا كانت اللغة languageCode المطلوبة متاحة، يتم عرض الردّ باللغة المطلوبة.
• ‫languageCode غير متاحة: في الحالات التي تكون فيها languageCode المطلوبة غير متاحة ولا يمكن العثور على بديل قريب، تعرض نقطة النهاية الردّ باللغة الإنجليزية تلقائيًا.
• عدم توفير languageCode: تعرض نقطة النهاية الردّ باللغة الإنجليزية تلقائيًا.

مثال على طلب تنبيه بشأن الطقس

يطلب المثال التالي معلومات عن تنبيهات الطقس لمدينة في ولاية كارولاينا الشمالية:

curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635&location.longitude=-78.3168047&languageCode=en"

يكون نص الاستجابة على النحو التالي:

{
  "weatherAlerts": [
    {
      "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1",
      "alertTitle": {
        "text": "Flash Flood Warning",
        "languageCode": "en"
      },
      "eventType": "FLASH_FLOOD",
      "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC",
      "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],
        [-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000],
        [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000],
        [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000],
        [-78.350000,35.940000],[-78.450000,35.820000]]]}",
      "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for...
        \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina...
        \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina...
        \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen.
        \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding.
        Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas,
        highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include...
        \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.",
      "severity": "SEVERE",
      "certainty": "LIKELY",
      "urgency": "IMMEDIATE",
      "instruction": [
        "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles."
      ],
      "safetyRecommendations": [
        {
          "directive": "Build an emergency kit and make a family communications plan.",
          "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building 
            an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan."
        },
        {
          "directive": "Be aware that flash flooding can occur. ",
          "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move."
        },
        ...
      ],
      "timezoneOffset": "-14400s",
      "startTime": "2025-08-06T18:24:00Z",
      "expirationTime": "2025-08-06T21:30:00Z",
      "dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }
    }
  ],
  "regionCode": "US"
}

جرِّبها الآن.

يتيح لك "مستكشف واجهات برمجة التطبيقات" إرسال نماذج طلبات لكي تتمكّن من التعرّف على واجهة برمجة التطبيقات وخياراتها.

1. انقر على رمز واجهة برمجة التطبيقات api على يسار الصفحة.

2. يمكنك تعديل مَعلمات الطلب إذا أردت.

3. انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.

4. في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز ملء الشاشة ملء الشاشة لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".