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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الحقل النوع الوصف مطلوبة أم اختيارية
alertId سلسلة رقم تعريف التنبيه. يمكنك أيضًا العثور على هذه المعلومات على الموقع الإلكتروني لمزوّد البيانات. مطلوب
alertTitle سلسلة عنوان التنبيه الذي يصف حالة الطقس

ملاحظة: هذه هي السلسلة الوحيدة التي تتم ترجمتها عند تضمين مَعلمة رمز اللغة في الطلب.		 مطلوب
eventType تعداد نوع حدث الطقس المرتبط بالتنبيه

للاطّلاع على قائمة كاملة بأحداث الطقس المتاحة، راجِع أنواع أحداث الطقس.		 مطلوب
areaName سلسلة تمثّل هذه السمة اسم المنطقة الجغرافية المتأثرة بالتنبيه، والتي تشمل الموقع الجغرافي المطلوب. مطلوب
polygon سلسلة إحداثيات تحدّد مساحة مغلقة للأبعاد الخاصة بالتنبيه اختياري
description سلسلة عبارة قصيرة تلخّص وصف الحدث باللغة المحدّدة (مثلاً، "تحذير من إعصار"). اختياري
severity تعداد مستوى خطورة التنبيه:
  • شديدة الخطورة: تهديد غير عادي للحياة أو الممتلكات
  • شديدة: تشكّل خطرًا كبيرًا على الحياة أو الممتلكات
  • معتدل: خطر محتمل على الحياة أو الممتلكات
  • بسيط: لا يشكّل خطرًا معروفًا على الحياة أو الممتلكات أو يشكّل خطرًا بسيطًا
  • غير معروف: درجة الخطورة غير معروفة
 اختياري
certainty تعداد مستوى صحة التنبيه:
  • تم رصده: تم تحديد أنّه حدث أو أنّه مستمر
  • احتمال كبير: من المرجّح جدًا أن يكون قد حدث أو أن يكون مستمرًا
  • محتمل: من المحتمل (الاحتمال > %50 تقريبًا) أن يكون قد حدث أو أن يكون مستمرًا
  • محتمل: محتمل ولكن من غير المرجّح أن يكون قد حدث أو أن يكون مستمرًا (الاحتمال <= %50 تقريبًا)
  • غير محتمل: من غير المتوقّع حدوثه (قيمة الاحتمال قريبة من 0)
  • غير معروف: مستوى اليقين غير معروف
 اختياري
urgency تعداد مستوى الأهمية للتنبيه:
  • فوري: يجب اتّخاذ إجراء استجابة على الفور
  • النتيجة المتوقّعة: يجب اتخاذ إجراء سريع الاستجابة قريبًا (في غضون الساعة التالية)
  • المستقبل: يجب اتخاذ إجراء سريع الاستجابة في المستقبل القريب
  • السابق: لم يعُد مطلوبًا اتّخاذ إجراء استجابة
  • غير معروف: مستوى الإلحاح غير معروف
 اختياري
instruction سلسلة وصف لتعليمات الإجراءات السريعة الاستجابة للجمهور المستهدف اختياري
safetyRecommendations سلسلة اقتراحات بشأن السلامة استنادًا إلى رموز الهيئات العامة يتضمّن توجيهات من المستوى الأعلى ونصًا فرعيًا يتضمّن معلومات إضافية. اختياري
timezoneOffset سلسلة إزاحة المنطقة الزمنية للحدث، بالتنسيق +/-HH:MM مطلوب
startTime DateTime تاريخ ووقت Epoch الفعّال (بالتوقيت العالمي المتفق عليه) للمعلومات الواردة في رسالة التنبيه اختياري
expirationTime DateTime تاريخ ووقت Epoch (التوقيت العالمي المتفق عليه) المتوقّع لانتهاء التنبيه قد تكون القيمة فارغة للأحداث التي تستمر إلى أجل غير مسمّى، وفي هذه الحالة سيشير العنوان إلى أنّ الحدث "سارٍ". اختياري
dataSource تعداد تفاصيل الجهة المرجعية، بما في ذلك الناشر والاسم وعنوان URL مطلوب
regionCode تعداد رمز المنطقة الخاصة بالموقع الجغرافي الذي تم طلبه اختياري

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

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

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

البلد وكالة
أستراليا وكالة خدمات الطوارئ في مقاطعة العاصمة الأسترالية (ACT ESA)
خدمة مكافحة الحرائق في المناطق الريفية في نيو ساوث ويلز (NSW RFS)
خدمة مكافحة الحرائق الريفية في جنوب أستراليا (SA CFS)
خدمة الحرائق في تسمانيا (TFS)
خدمات الإطفاء والطوارئ في كوينزلاند (QFES)
النمسا GeoSphere Austria من خلال MeteoAlarm
بلجيكا المعهد الملكي للأرصاد الجوية في بلجيكا من خلال MeteoAlarm
البوسنة والهرسك المعهد الاتّحادي للأرصاد الجوية والمائية (FHMZ) من خلال MeteoAlarm
بلغاريا المعهد الوطني للأرصاد الجوية والهيدرولوجيا من خلال MeteoAlarm
البرازيل Centro Nacional de Gerenciamento de Riscos e Desastres (CENAD)
Instituto Nacional de Meteorologia (INMET)
كولومبيا Unidad Nacional para la Gestión del Riesgo de Desastres (UNGRD)
ساحل العاج Société d'Exploitation et de Développement Aéroportuaire, Aéronautique et Météorologique
كرواتيا Croatian Meteorological and Hydrological Service من خلال MeteoAlarm
قبرص إدارة الأرصاد الجوية من خلال MeteoAlarm
التشيك معهد الأرصاد الجوية المائية التشيكي من خلال MeteoAlarm
الدانمرك معهد الأرصاد الجوية الدنماركي من خلال MeteoAlarm
الإكوادور المعهد الوطني للأرصاد الجوية وعلم المياه
إستونيا وزارة المناخ من خلال MeteoAlarm
فنلندا معهد الأرصاد الجوية الفنلندي من خلال MeteoAlarm
فرنسا Météo-France من خلال MeteoAlarm
ألمانيا DWD - The German Weather Service
اليونان خدمة الأرصاد الجوية الوطنية اليونانية من خلال MeteoAlarm
غينيا Agence Nationale de la Météorologie
المجر HungaroMet Nonprofit Zrt من خلال MeteoAlarm
أيسلندا مكتب الأرصاد الجوية الآيسلندي من خلال MeteoAlarm
أيرلندا Met Eirann من خلال MeteoAlarm
إيطاليا Italian Meteorological Service من خلال MeteoAlarm
جامايكا Meteorological Service of Jamaica
اليابان وكالة الأرصاد الجوية اليابانية (JMA)
لاتفيا Latvian Environment, Geology and Meteorology Centre من خلال MeteoAlarm
ليتوانيا مصلحة الأرصاد الجوية المائية الليتوانية من خلال MeteoAlarm
لوكسمبورغ MeteoLux من خلال MeteoAlarm
مدغشقر Météo Madagascar
المكسيك Centro de Instrumentación y Registro Sísmico A.C. (CIRES)
هولندا المعهد الملكي الهولندي للأرصاد الجوية من خلال MeteoAlarm
مقدونيا الشمالية National Hydrometeorological Service من خلال MeteoAlarm
النرويج معهد الأرصاد الجوية النرويجي من خلال MeteoAlarm
نيوزيلندا GNS Science (GeoNet)
MetService
الفلبين إدارة الخدمات الجوية والجيوفيزيائية والفلكية الفلبينية (PAGASA)
بولندا معهد الأرصاد الجوية وإدارة المياه من خلال MeteoAlarm
البرتغال معهد البحر والغلاف الجوي البرتغالي من خلال MeteoAlarm
رومانيا إدارة الأرصاد الجوية الوطنية من خلال MeteoAlarm
صربيا معهد جمهورية صربيا للأرصاد الجوية والمياه من خلال MeteoAlarm
سنغافورة Meteorological Service Singapore
سلوفاكيا معهد الأرصاد الجوية المائية السلوفاكي من خلال MeteoAlarm
سلوفينيا معهد الأرصاد الجوية والمياه في سلوفينيا من خلال MeteoAlarm
جزر سليمان Solomon Islands Meteorological Services
كوريا الجنوبية إدارة الأرصاد الجوية الكورية
إسبانيا وكالة الأرصاد الجوية الإسبانية من خلال MeteoAlarm
السويد المعهد السويدي للأرصاد الجوية والهيدرولوجيا من خلال MeteoAlarm
سويسرا المكتب الاتحادي للأرصاد الجوية وعلم المناخ MeteoSwiss من خلال MeteoAlarm
تايوان المركز الوطني للعلوم والتكنولوجيا للحد من الكوارث (NCDR)
تايلاند Thai Meteorological Department
المملكة المتحدة مكتب الأرصاد الجوية من خلال MeteoAlarm
وكالة البيئة في المملكة المتحدة
الولايات المتحدة المركز الوطني للتحذير من التسونامي
خدمة الطقس الوطنية في الولايات المتحدة
فيتنام المركز الوطني للتنبؤات الهيدرومناخية

تحديد المصدر

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

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

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

أنواع أحداث الطقس

تتوفّر أنواع أحداث الطقس التالية:

أنواع أحداث الطقس
ACID_RAIN
AVALANCHE
BLIZZARD
BLOWING_SNOW
COASTAL_FLOOD
COASTAL_HAZARD
COLD
CYCLONE
DROUGHT
EXTRATROPICAL_CYCLONE
FIRE_WEATHER
FLASH_FLOOD
FLOOD
FOG
FREEZING
FREEZING_AIR_TEMPERATURE
FREEZING_DRIZZLE
FREEZING_RAIN
FROST
GALE
GLAZE
HAIL
HAZARDOUS_SEAS
HEAT
HUMIDITY
HURRICANE
ICE_STORM
LAKE_EFFECT_SNOW
MONSOON
MUDDY_FLOOD
OUTFLOW
RAIN 		RIVER_FLOODING
SEVERE_THUNDERSTORM_WARNING
SNOW
SNOWSQUALL
STORM
STORM_SURGE
THUNDER
THUNDERSTORM
TORNADO
TORNADO_WARNING
TROPICAL_CYCLONE
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES
TROPICAL_DISTURBANCE
TROPICAL_STORM
TYPHOON
WIND
WIND_CHILL
WIND_WAVE
WINTER_STORM
WILDFIRE
BUSHFIRE
FIRE
LANDSLIDE
EARTHQUAKE
DUST_STORM
AFTERSHOCK
TSUNAMI
VOLCANIC_ASH
VOLCANIC_ERUPTION
RADIATION

أسلوب ترجمة الردود

تقدّم 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"
}

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

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

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

  2. عدِّل مَعلمات الطلب اختياريًا.

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

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