Method: publicAlerts.lookup

هشدارهای عمومی آب و هوا را برای یک مکان مشخص برمی‌گرداند.

درخواست HTTP

GET https://weather.googleapis.com/v1/publicAlerts:lookup

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
location

object ( LatLng )

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

pageSize

integer

اختیاری. حداکثر تعداد رکوردهای هشدار آب و هوای عمومی برای نمایش در هر صفحه.

pageToken

string

اختیاری. یک توکن صفحه که از فراخوانی قبلی publicAlerts.lookup دریافت شده است. این را برای بازیابی صفحه بعدی ارائه دهید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به publicAlerts.lookup باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.

languageCode

string

اختیاری. به کلاینت اجازه می‌دهد زبان پاسخ را انتخاب کند. اگر داده‌ها برای آن زبان ارائه نشوند، API از نزدیکترین مورد منطبق استفاده می‌کند. مقادیر مجاز بر اساس استاندارد IETF BCP-47 هستند. مقدار پیش‌فرض "en" است.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پاسخ برای RPC مربوط به publicAlerts.lookup.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
فیلدها
weatherAlerts[]

object ( PublicAlerts )

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

regionCode

string

کد ISO_3166-1 alpha-2 مربوط به منطقه‌ی مربوط به مکان ارائه شده در درخواست. این منطقه با استفاده از ISO_3166-1_alpha-2 بیان شده است.

nextPageToken

string

یک توکن که می‌تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این فیلد حذف شود، صفحات بعدی وجود نخواهند داشت.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/cloud-platform

هشدارهای عمومی

هشدارهای عمومی آب و هوا را نشان می‌دهد.

نمایش JSON 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
فیلدها
alertId

string

شناسه منحصر به فرد برای این هشدار.

alertTitle

object ( LocalizedText )

عنوان محلی‌شده برای هشدار.

eventType

enum ( WeatherEventType )

نوع رویداد آب و هوایی.

areaName

string

نام منطقه‌ای که هشدار در آن صادر شده است.

instruction[]

string

دستورالعمل‌های توصیه‌شده توسط ناشر. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومی‌سازی شود، اما تضمینی برای بومی‌سازی آن وجود ندارد.

safetyRecommendations[]

object ( SafetyRecommendation )

دستورالعمل توصیه‌های ایمنی به کاربر، این موارد می‌تواند توسط ناشر یا سایر مقامات ارائه شود.

timezoneOffset

string

اختلاف زمانی منطقه زمانی نسبت به UTC برای محل هشدار. این مقدار به صورت رشته‌ای که به 's' ختم می‌شود، قالب‌بندی می‌شود، مثلاً "-14400s" به معنای 4 ساعت عقب‌تر از UTC.

startTime

string ( Timestamp format)

زمان شروع رویداد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

expirationTime

string ( Timestamp format)

زمان انقضای رویداد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

dataSource

object ( DataSource )

جزئیات ناشری که هشدار را صادر کرده است.

polygon

string

نمایش GeoJSON از مناطقی که هشدار در آنها صادر شده است.

داده‌های GeoJSON باید در قالب RFC 7946 باشند و یا یک Polygon (برای یک ناحیه‌ی پیوسته) یا یک MultiPolygon (برای چندین ناحیه‌ی مجزا) را نشان دهند.

مثال:

{ "نوع": "چندضلعی", "مختصات": [ [[-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

یک رشته نمونه MultiPolygon GeoJson به شکل زیر است:

{ "نوع": "چندضلعی", "مختصات": [ [[0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]

description

string

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

severity

enum ( Severity )

سطح شدت هشدار.

certainty

enum ( Certainty )

قطعیت هشدار.

urgency

enum ( Urgency )

فوریت هشدار.

نوع رویداد آب و هوا

نوع رویداد آب و هوایی.

انوم‌ها
WEATHER_EVENT_TYPE_UNSPECIFIED نوع رویداد آب و هوایی نامشخص.
ACID_RAIN پدیده باران اسیدی
AFTERSHOCK رویداد پس‌لرزه.
AVALANCHE رویداد بهمن.
BLIZZARD رویداد بلیزارد.
BLOWING_SNOW رویداد بارش برف.
BUSHFIRE رویداد آتش‌سوزی بوته‌زارها.
COASTAL_FLOOD رویداد سیل ساحلی.
COASTAL_HAZARD رویداد خطر ساحلی.
COLD رویداد سرد.
CYCLONE رویداد سیکلون.
DROUGHT رویداد خشکسالی.
DUST_STORM رویداد طوفان گرد و غبار.
EARTHQUAKE رویداد زلزله.
EXTRATROPICAL_CYCLONE رویداد طوفان گرمسیری اضافی.
FIRE رویداد آتش‌سوزی.
FIRE_WEATHER رویداد آب و هوایی آتش‌سوزی.
FLASH_FLOOD رویداد سیل ناگهانی.
FLOOD حادثه سیل.
FOG رویداد مه گرفتگی.
FREEZING رویداد یخ زدگی.
FREEZING_AIR_TEMPERATURE رویداد دمای هوای یخبندان.
FREEZING_DRIZZLE رویداد نم نم باران یخی.
FREEZING_RAIN_EVENT رویداد باران یخی.
FROST رویداد یخبندان.
GALE رویداد گیل.
GLAZE رویداد لعاب.
HAIL رویداد تگرگ.
HAZARDOUS_SEAS رویداد دریایی خطرناک
HEAT رویداد گرما.
HUMIDITY رویداد رطوبت.
HURRICANE رویداد طوفان.
ICE_STORM رویداد طوفان یخ.
INDUSTRIAL_FIRE حادثه آتش سوزی صنعتی
LAKE_EFFECT_SNOW رویداد برف ناشی از اثر دریاچه.
LANDSLIDE رویداد رانش زمین.
MONSOON رویداد موسمی.
MUDDY_FLOOD رویداد سیل گل آلود.
OUTFLOW رویداد خروج.
RADIATION رویداد تابشی.
RAIN_EVENT رویداد بارانی.
RIVER_FLOODING حادثه طغیان رودخانه.
SEVERE_THUNDERSTORM_WARNING هشدار وقوع رعد و برق شدید.
SNOWSQUALL رویداد کولاک برف.
SNOW_EVENT رویداد برفی.
STORM رویداد طوفان.
STORM_SURGE رویداد موج طوفان.
THUNDER رویداد رعد و برق.
THUNDERSTORM رویداد رعد و برق.
TORNADO رویداد گردباد.
TORNADO_WARNING هشدار وقوع گردباد.
TROPICAL_CYCLONE رویداد طوفان گرمسیری.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES هشدارها و رویدادهای مربوط به طوفان گرمسیری.
TROPICAL_DISTURBANCE رویداد آشفتگی گرمسیری
TROPICAL_STORM رویداد طوفان گرمسیری.
TSUNAMI رویداد سونامی.
TYPHOON رویداد تایفون.
VOLCANIC_ASH رویداد خاکستر آتشفشانی.
VOLCANIC_ERUPTION رویداد فوران آتشفشانی.
WILDFIRE رویداد آتش‌سوزی جنگلی.
WIND رویداد باد.
WIND_CHILL رویداد باد سرد.
WIND_WAVE رویداد موج باد.
WINTER_STORM رویداد طوفان زمستانی.

شدت

کدی که شدت رویداد موضوع پیام هشدار را نشان می‌دهد.

انوم‌ها
SEVERITY_UNKNOWN شدت مشخص نیست.
EXTREME تهدید فوق‌العاده برای جان یا مال.
SEVERE تهدید قابل توجه برای جان یا مال.
MODERATE تهدید احتمالی برای جان یا مال.
MINOR تهدید جزئی برای جان یا مال.

قطعیت

کدی که نشان‌دهنده قطعیت رویداد موضوع پیام هشدار است.

انوم‌ها
CERTAINTY_UNKNOWN قطعیت مشخص نیست.
OBSERVED مشخص شده است که رخ داده یا در حال انجام است.
VERY_LIKELY خیلی محتمله.
LIKELY احتمالاً (p > ~50%).
POSSIBLE ممکن است اما محتمل نیست (p <= ~50%).
UNLIKELY بعید (p ~ 0%).

فوریت

کدی که نشان‌دهنده‌ی فوریت رویداد موضوع پیام هشدار است.

انوم‌ها
URGENCY_UNKNOWN فوریت مشخص نیست.
IMMEDIATE اقدامات واکنشی باید فوراً انجام شود.
EXPECTED اقدامات لازم باید به زودی (ظرف یک ساعت آینده) انجام شود.
FUTURE اقدامات واکنشی باید در آینده نزدیک انجام شود.
PAST دیگر نیازی به اقدام واکنشی نیست.

توصیه‌های ایمنی

نشان دهنده یک توصیه ایمنی است.

نمایش JSON 
{
  "directive": string,
  "subtext": string
}
فیلدها
directive

string

یک دستورالعمل برای کاربر. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومی‌سازی شود، اما تضمینی برای بومی‌سازی آن وجود ندارد.

subtext

string

یک زیرمتن اختیاری برای دستورالعمل، که ممکن است شامل زمینه اضافی برای کاربر باشد. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومی‌سازی شود، اما تضمینی برای بومی‌سازی آن وجود ندارد.

منبع داده

نشان دهنده یک لینک به یک منبع داده است.

نمایش JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
فیلدها
publisher

enum ( Publisher )

منتشرکننده هشدار.

name

string

نام رسمی ناشر. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومی‌سازی شود، اما تضمینی برای بومی‌سازی آن وجود ندارد.

authorityUri

string

آدرس اینترنتی وب‌سایت آن مرجع.

ناشر

منتشرکننده هشدار.

انوم‌ها
PUBLISHER_UNSPECIFIED ناشر مشخص نشده است.
AUSTRALIA_ACT_ESA استرالیا قلمرو پایتختی استرالیا
AUSTRALIA_NSW_RFS نیو ساوت ولز
AUSTRALIA_QLD_QFES کوئینزلند
AUSTRALIA_SA_CFS استرالیای جنوبی
METEO_ALARM_AT Meteoalarm / EUMETNET اتریش
METEO_ALARM_BS بوسنی
BRAZIL_CENAD آژانس بلایای طبیعی برزیل در برزیل
BRAZIL_INMET سازمان هواشناسی برزیل
UK_ENV_AGENCY بریتانیا
METEO_ALARM_BG Meteoalarm / EUMETNET بلغارستان
METEO_ALARM_CR کرواسی
METEO_ALARM_CY قبرس
METEO_ALARM_CS چک
METEO_ALARM_DK دانمارک
EC_INAMHI اکوادور
METEO_ALARM_FI Meteoalarm / EUMETNET فنلاند
METEO_ALARM_FR فرانسه
DE_DWD آلمان
METEO_ALARM_GB Meteoalarm / EUMETNET بریتانیا
METEO_ALARM_GR یونان
METEO_ALARM_HU مجارستان
METEO_ALARM_IS ایسلند
METEO_ALARM_IE ایرلند
METEO_ALARM_IT ایتالیا
JM_JMS جامائیکا
JMA ژاپن
METEO_ALARM_NL Meteoalarm / EUMETNET هلند
METEO_ALARM_LV لتونی
METEO_ALARM_LT لیتوانی
METEO_ALARM_LU لوکزامبورگ
MEXICO_CIRES مکزیک مکزیک CIRES
NZ_GEONET نیوزیلند، نیوزیلند، شبکه جغرافیایی
NZ_NMS مت سرویس
METEO_ALARM_MK هشدار هوا / EUMETNET مقدونیه شمالی
METEO_ALARM_NO نروژ
PHILIPPINES_PAGASA فیلیپین
METEO_ALARM_PL Meteoalarm / EUMETNET لهستان
METEO_ALARM_PT پرتغال
METEO_ALARM_RO رومانی
METEO_ALARM_RS صربستان
SG_MSS سنگاپور
METEO_ALARM_SK Meteoalarm / EUMETNET اسلواکی
METEO_ALARM_SI اسلوونی
SB_MET جزایر سلیمان
METEO_ALARM_ES Meteoalarm / EUMETNET اسپانیا
METEO_ALARM_SE سوئد
METEO_ALARM_CH سوئیس
TAIWAN_NCDR تایوان
NOAA ایالات متحده، اداره ملی اقیانوسی و جوی (NOAA)
WCATWC مرکز ملی هشدار سونامی