دریافت هشدار آب و هوا

نقطه پایانی publicAlerts جزئیات هشدارهای مربوط به رویدادهای خاص آب و هوایی را که توسط آژانس‌های معتبر ملی و بین‌المللی صادر شده‌اند، ارائه می‌دهد. این هشدارها اطلاعات حیاتی و بالقوه نجات‌بخش را ارائه می‌دهند.

این نقطه پایانی، هشدارهای آب و هوایی را که به صورت بلادرنگ برای عرض و طول جغرافیایی مشخص رخ می‌دهند، برمی‌گرداند. رویدادهای آب و هوایی پشتیبانی شده شامل موارد زیر است:

  • بارش: باران، برف، تگرگ، خشکسالی و موارد دیگر
  • دماهای شدید: سرما، گرما، یخبندان، یخ زدگی، باد سرد و رطوبت
  • رویدادهای باد و طوفان: کولاک، تندباد، گردباد، طوفان‌های گرمسیری، رعد و برق و موارد دیگر
  • اختلالات دید: مه، طوفان گرد و غبار و برف شدید
  • خطرات مرتبط با آب: سیل، سونامی، امواج طوفان، خطرات ساحلی و موارد دیگر
  • رویدادهای ژئوفیزیکی و زمین‌شناسی: زلزله، رانش زمین و فعالیت‌های آتشفشانی
  • حوادث آتش‌سوزی: آتش‌سوزی‌های جنگلی، آب و هوای آتش‌سوزی و موارد دیگر

برای فهرست کاملی از رویدادهای آب و هوایی پشتیبانی‌شده، به انواع رویدادهای آب و هوایی مراجعه کنید.

بسته به آنچه از منبع داده در دسترس است، هشدارها ممکن است حاوی توضیحات محلی باشند یا نباشند. به دلیل محدودیت‌های منبع داده، اطلاعات به همان صورت (محتوای خام) ارائه می‌شوند. برای اطلاعات بیشتر در مورد منابع هشدار آب و هوا، به منابع داده مراجعه کنید.

این API اطلاعات زیر را برای یک هشدار آب و هوایی مشخص برمی‌گرداند:

  • نوع رویداد آب و هوایی مرتبط با هشدار
  • فهرستی از مناطق آسیب‌دیده به همراه مختصات جغرافیایی که مرزهای آن مناطق را مشخص می‌کند
  • خلاصه‌ای یک جمله‌ای از رویداد آب و هوایی
  • سطوح شدت، قطعیت و فوریت
  • شرح دستورالعمل‌های اقدام-توصیه برای مخاطبان هدف
  • توصیه‌های ایمنی
  • زمان شروع و پایان هشدار
  • نام و وب‌سایت مرجع انتشار

مرورگر APIها به شما امکان می‌دهد درخواست‌های زنده ارسال کنید تا بتوانید با API و گزینه‌های API آشنا شوید:

درباره درخواست‌های هشدار آب و هوا

برای درخواست اطلاعات هشدار آب و هوا، یک درخواست HTTP GET به آدرس زیر ارسال کنید:

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

مختصات طول و عرض جغرافیایی مکان را در پارامترهای URL درخواست خود وارد کنید.

درباره پاسخ‌های هشدار آب و هوا

API آب و هوا فیلدهای زیر را در بدنه پاسخ برمی‌گرداند:

میدان نوع توضیحات الزامی یا اختیاری
alertId رشته شناسه هشدار. این شناسه را می‌توان در وب‌سایت ارائه‌دهنده داده نیز یافت. مورد نیاز
alertTitle رشته عنوان هشدار، که رویداد آب و هوایی را توصیف می‌کند.

نکته: این تنها رشته‌ای است که وقتی یک پارامتر کد زبان در درخواست گنجانده می‌شود، ترجمه می‌شود.		 مورد نیاز
eventType شمارشی نوع رویداد آب و هوایی مرتبط با هشدار.

برای فهرست کامل رویدادهای آب و هوایی پشتیبانی‌شده، به انواع رویدادهای آب و هوایی مراجعه کنید.		 مورد نیاز
areaName رشته نام منطقه جغرافیایی تحت تأثیر هشدار، که شامل مکان درخواست شده نیز می‌شود. مورد نیاز
polygon رشته مختصاتی که یک ناحیه با ابعاد بسته از هشدار را تعریف می‌کنند. اختیاری
description رشته عبارت کوتاهی که شرح رویداد را به زبان مشخص شده خلاصه می‌کند (مثلاً «هشدار گردباد»). اختیاری
severity شمارشی سطح شدت هشدار:
  • شدید: تهدید فوق‌العاده برای جان یا مال
  • شدید: تهدید جدی برای جان یا مال
  • متوسط: احتمال تهدید جانی یا مالی
  • جزئی: تهدید جانی یا مالی ناچیز یا بدون خطر شناخته شده
  • ناشناخته: شدت نامشخص
 اختیاری
certainty شمارشی سطح اطمینان برای هشدار:
  • مشاهده شده: مشخص شده که رخ داده یا در حال انجام است
  • بسیار محتمل: به احتمال زیاد رخ داده یا در حال انجام است
  • احتمالاً: احتمالاً (p > ~50%) رخ داده یا در حال انجام است
  • ممکن: ممکن است اما بعید است که رخ داده باشد یا در حال انجام باشد (p <= ~50%)
  • بعید: انتظار نمی‌رود رخ دهد (p ~ 0)
  • نامعلوم: قطعیت نامعلوم
 اختیاری
urgency شمارشی میزان فوریت برای هشدار:
  • فوری: اقدامات واکنشی باید فوراً انجام شود
  • مورد انتظار: اقدام واکنشی باید به زودی (ظرف یک ساعت آینده) انجام شود
  • آینده: اقدامات واکنشی باید در آینده نزدیک انجام شود
  • گذشته: دیگر نیازی به اقدام واکنشی نیست
  • ناشناخته: فوریت نامشخص
 اختیاری
instruction رشته شرح دستورالعمل‌های اقدام واکنشی برای مخاطبان هدف. اختیاری
safetyRecommendations رشته توصیه‌های ایمنی مبتنی بر ضوابط مقامات دولتی. شامل دستورالعمل‌های سطح بالا و متن ضمنی با اطلاعات تکمیلی. اختیاری
timezoneOffset رشته انحراف منطقه زمانی رویداد، با فرمت +/-HH:MM. مورد نیاز
startTime تاریخ و زمان تاریخ و زمان مؤثر عصر (زمان UTC) اطلاعات موجود در پیام هشدار. اختیاری
expirationTime تاریخ و زمان تاریخ و زمان دوره (زمان UTC) که انتظار می‌رود یک هشدار در آن پایان یابد. این مقدار ممکن است برای رویدادهای نامحدود طولانی تهی باشد، در این صورت عنوان رویداد نشان می‌دهد که رویداد "در حال اجرا" است. اختیاری
dataSource شمارشی جزئیات مرجع شامل ناشر، نام و نشانی اینترنتی (URL). مورد نیاز
regionCode شمارشی کد منطقه محل مورد درخواست. اختیاری

منابع داده

نقطه پایانی هشدارهای آب و هوایی، داده‌های منتشر شده توسط ارائه دهندگان ذکر شده در جدول زیر را برمی‌گرداند. بر اساس مختصات طول و عرض جغرافیایی ارائه شده در درخواست، بدنه پاسخ، داده‌ها را از مرجع محلی مربوطه ارائه می‌دهد.

ارائه‌دهندگان موجود در فید، از دستورالعمل‌های هشدارهای عمومی گوگل پیروی می‌کنند. گوگل ممکن است فهرست ارائه‌دهندگان را در هر زمانی به‌روزرسانی کند.

کشور آژانس
استرالیا آژانس خدمات اضطراری ACT (ACT ESA)
خدمات آتش نشانی روستایی نیو ساوت ولز (NSW RFS)
سازمان آتش نشانی جنوب استرالیا (SA CFS)
سازمان آتش نشانی تاسمانی (TFS)
خدمات آتش نشانی و اورژانس کوئینزلند (QFES)
اتریش GeoSphere اتریش از طریق MeteoAlarm
بلژیک موسسه سلطنتی هواشناسی بلژیک از طریق MeteoAlarm
بوسنی و هرزگوین موسسه فدرال هواشناسی آب و هوا (FHMZ) از طریق MeteoAlarm
بلغارستان موسسه ملی هواشناسی و هیدرولوژی از طریق MeteoAlarm
برزیل Centro Nacional de Gerenciamento de Riscos e Desastres (CENAD)
موسسه ملی هواشناسی (INMET)
کلمبیا Unidad Nacional para la Gestión del Riesgo de Desastras (UNGRD)
ساحل عاج Société d'Exploitation et de Développement Aéroportuaire, Aéronautique et Météorologique
کرواسی خدمات هواشناسی و هیدرولوژی کرواسی از طریق MeteoAlarm
قبرس اداره هواشناسی از طریق MeteoAlarm
چک موسسه آب و هواشناسی چک از طریق MeteoAlarm
دانمارک موسسه هواشناسی دانمارک از طریق MeteoAlarm
اکوادور موسسه ملی هواشناسی و هیدرولوژی
استونی وزارت آب و هوا از طریق MeteoAlarm
فنلاند موسسه هواشناسی فنلاند از طریق MeteoAlarm
فرانسه Météo-France از طریق MeteoAlarm
آلمان DWD - سرویس هواشناسی آلمان
یونان سرویس هواشناسی ملی یونان از طریق MeteoAlarm
گینه آژانس ملی هواشناسی
مجارستان HungaroMet غیرانتفاعی Zrt از طریق MeteoAlarm
ایسلند اداره هواشناسی ایسلند از طریق MeteoAlarm
ایرلند با Eirann از طریق MeteoAlarm آشنا شوید
ایتالیا سرویس هواشناسی ایتالیا از طریق MeteoAlarm
جامائیکا سازمان هواشناسی جامائیکا
ژاپن سازمان هواشناسی ژاپن (JMA)
لتونی مرکز محیط زیست، زمین شناسی و هواشناسی لتونی از طریق MeteoAlarm
لیتوانی خدمات آب و هواشناسی لیتوانی از طریق MeteoAlarm
لوکزامبورگ MeteoLux از طریق MeteoAlarm
ماداگاسکار هواشناسی ماداگاسکار
مکزیک Centro de Instrumentación y Registro Sísmico AC (CIRES)
هلند موسسه هواشناسی سلطنتی هلند از طریق MeteoAlarm
مقدونیه شمالی سرویس ملی هواشناسی از طریق MeteoAlarm
نروژ موسسه هواشناسی نروژ از طریق MeteoAlarm
نیوزیلند علوم GNS (GeoNet)
مت سرویس
فیلیپین اداره خدمات جوی، ژئوفیزیکی و نجومی فیلیپین (PAGASA)
لهستان موسسه هواشناسی و مدیریت آب از طریق MeteoAlarm
پرتغال موسسه پرتغالی دریا و جو از طریق MeteoAlarm
رومانی اداره ملی هواشناسی از طریق MeteoAlarm
صربستان موسسه آب و هواشناسی جمهوری صربستان از طریق MeteoAlarm
سنگاپور سازمان هواشناسی سنگاپور
اسلواکی موسسه آب و هواشناسی اسلواکی از طریق MeteoAlarm
اسلوونی موسسه آب و هواشناسی اسلوونی از طریق MeteoAlarm
جزایر سلیمان خدمات هواشناسی جزایر سلیمان
کره جنوبی اداره هواشناسی کره
اسپانیا سازمان هواشناسی ایالتی از طریق MeteoAlarm
سوئد موسسه هواشناسی و هیدرولوژی سوئد از طریق MeteoAlarm
سوئیس دفتر فدرال هواشناسی و اقلیم‌شناسی MeteoSwiss از طریق MeteoAlarm
تایوان مرکز ملی علوم و فناوری برای کاهش بلایای طبیعی (NCDR)
تایلند اداره هواشناسی تایلند
بریتانیا اداره هواشناسی از طریق 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

رفتار ترجمه پاسخ

گوگل فقط برای فیلد alertTitle ترجمه ارائه می‌دهد. فیلدهای دیگری مانند eventType ، areaName ، instruction و safetyRecommendations نیز ممکن است بسته به پشتیبانی زبان منبع داده اصلی ترجمه شوند؛ با این حال، گوگل نمی‌تواند ترجمه‌های مستقلی برای این فیلدها ارائه دهد.

بر اساس پارامتر 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"
}

امتحانش کن!

مرورگر APIها به شما امکان می‌دهد درخواست‌های نمونه ایجاد کنید تا با API و گزینه‌های API آشنا شوید.

  1. آیکون API یعنی api را در سمت راست صفحه انتخاب کنید.

  2. در صورت تمایل، پارامترهای درخواست را ویرایش کنید.

  3. دکمه اجرا را انتخاب کنید. در کادر محاوره‌ای، حسابی را که می‌خواهید برای ارسال درخواست استفاده کنید، انتخاب کنید.

  4. در پنل APIs Explorer، آیکون تمام صفحه را در حالت تمام صفحه انتخاب کنید تا پنجره APIs Explorer باز شود.