فهرست
-
Weather(رابط کاربری) -
AirPressure(پیام) -
CardinalDirection(شمارشی) -
Certainty(شمارشی) -
DataSource(پیام) -
ForecastDay(پیام) -
ForecastDayPart(پیام) -
ForecastHour(پیام) -
HistoryHour(پیام) -
IceThickness(پیام) -
IceThickness.Unit(شمارشی) -
LookupCurrentConditionsRequest(پیام) -
LookupCurrentConditionsResponse(پیام) -
LookupCurrentConditionsResponse.CurrentConditionsHistoryشرایط فعلی (پیام) -
LookupForecastDaysRequest(پیام) -
LookupForecastDaysResponse(پیام) -
LookupForecastHoursRequest(پیام) -
LookupForecastHoursResponseپاسخ (پیام) -
LookupHistoryHoursRequest(پیام) -
LookupHistoryHoursResponse(پیام) -
LookupPublicAlertsRequest(پیام) -
LookupPublicAlertsResponse(پیام) -
MoonEvents(پیام) -
MoonPhase(شمارشی) -
Precipitation(پیام) -
PrecipitationProbability(پیام) -
PrecipitationType(شمارشی) -
PublicAlerts(پیام) -
Publisher(شمارشی) -
QuantitativePrecipitationForecast(پیام) -
QuantitativePrecipitationForecast.Unitواحد (شمارشی) -
SafetyRecommendation(پیام) -
Severity(شمارشی) -
SpeedUnit(شمارشی) -
SunEvents(پیام) -
Temperature(پیام) -
TemperatureUnit(شمارشی) -
UnitsSystem(شمارشی) -
Urgency(شمارشی) -
Visibility(پیام) -
Visibility.Unit(enum) -
WeatherCondition(پیام) - نوع
WeatherCondition.Type(شمارشی) -
WeatherEventType(شمارشی) -
Wind(پیام) -
WindDirection(پیام) -
WindSpeed(پیام)
آب و هوا
تعریف سرویس برای API آب و هوا.
| جستجوی شرایط فعلی |
|---|
شرایط آب و هوایی فعلی را در یک مکان مشخص برمیگرداند.
|
| روزهای جستجو |
|---|
پیشبینیهای روزانه تا 10 روز را در یک مکان مشخص، از روز جاری، برمیگرداند.
|
| ساعتهای پیشبینی جستجو |
|---|
پیشبینیهای ساعتی تا ۲۴۰ ساعت را در یک مکان مشخص، از ساعت فعلی شروع میکند، برمیگرداند.
|
| جستجوتاریخچهساعتها |
|---|
دادههای آب و هوای تاریخی ساعتی تا ۲۴ ساعت را در یک مکان مشخص، از آخرین ساعت شروع میکند، برمیگرداند.
|
| جستجو هشدارهای عمومی |
|---|
هشدارهای عمومی آب و هوا را برای یک مکان مشخص برمیگرداند.
|
فشار هوا
شرایط فشار هوای اتمسفر را نشان میدهد.
| فیلدها | |
|---|---|
mean_sea_level_millibars | فشار متوسط هوا در سطح دریا بر حسب میلی بار. |
کاردینال دایرکتوریشن
نشان دهنده یک جهت اصلی (شامل جهتهای ترتیبی) است.
| انومها | |
|---|---|
CARDINAL_DIRECTION_UNSPECIFIED | جهت اصلی مشخص نشده است. |
NORTH | جهت کاردینال شمالی. |
NORTH_NORTHEAST | جهت بینقطبی ثانویه شمال-شمالشرقی. |
NORTHEAST | جهت بین کاردینالی شمال شرقی. |
EAST_NORTHEAST | جهت فرعی بینقطبی شرقی-شمالشرقی. |
EAST | جهت کاردینال شرقی. |
EAST_SOUTHEAST | جهت فرعی بینقطبی شرقی-جنوبشرقی. |
SOUTHEAST | جهت بین کاردینالی جنوب شرقی. |
SOUTH_SOUTHEAST | جهت بیناصلی ثانویه جنوب-جنوبشرقی. |
SOUTH | جهت کاردینال جنوبی. |
SOUTH_SOUTHWEST | جهت فرعی بینقطبی جنوب-جنوبغربی. |
SOUTHWEST | جهت بین کاردینالی جنوب غربی. |
WEST_SOUTHWEST | جهت فرعی بینقطبی غربی-جنوبغربی. |
WEST | جهت کاردینال غربی. |
WEST_NORTHWEST | جهت فرعی بینقطبی غرب-شمالغربی. |
NORTHWEST | جهت بین کاردینالی شمال غربی. |
NORTH_NORTHWEST | جهت بینقطبی ثانویه شمال-شمالغربی. |
قطعیت
کدی که نشاندهنده قطعیت رویداد موضوع پیام هشدار است.
| انومها | |
|---|---|
CERTAINTY_UNKNOWN | قطعیت مشخص نیست. |
OBSERVED | مشخص شده است که رخ داده یا در حال انجام است. |
VERY_LIKELY | خیلی محتمله. |
LIKELY | احتمالاً (p > ~50%). |
POSSIBLE | ممکن است اما محتمل نیست (p <= ~50%). |
UNLIKELY | بعید (p ~ 0%). |
منبع داده
نشان دهنده یک لینک به یک منبع داده است.
| فیلدها | |
|---|---|
publisher | منتشرکننده هشدار. |
name | نام رسمی ناشر. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومیسازی شود، اما تضمینی برای بومیسازی آن وجود ندارد. |
authority_uri | آدرس اینترنتی وبسایت آن مرجع. |
روز پیشبینی
نشاندهندهی یک رکورد پیشبینی روزانه در یک مکان مشخص است.
| فیلدها | |
|---|---|
interval | بازه زمانی UTC که این روز پیشبینیشده در آن شروع (شامل) و پایان (منحصراً) میشود. توجه: یک روز از ساعت ۷ صبح شروع میشود و ساعت ۷ صبح روز بعد، به وقت محلی، پایان مییابد. برای مثال: اگر منطقه زمانی محلی UTC-7 باشد، بازه زمانی از ساعت |
display_date | تاریخ محلی در منطقه زمانی مکان (زمان رسمی) که این پیشبینی روزانه برای آن محاسبه میشود. این فیلد ممکن است برای اهداف نمایشی در کلاینت استفاده شود. |
daytime_forecast | شرایط آب و هوایی پیشبینی شده برای بخش روزانه روز (۷ صبح تا ۷ بعد از ظهر به وقت محلی). |
nighttime_forecast | شرایط آب و هوایی پیشبینیشده برای بخش شبانه روز (از ساعت ۷ عصر تا ۷ صبح روز بعد، به وقت محلی). |
max_temperature | حداکثر (بالاترین) دما در طول روز. |
min_temperature | حداقل (پایینترین) دما در طول روز. |
feels_like_max_temperature | حداکثر (بالاترین) دمایی که در طول روز احساس میشود. |
feels_like_min_temperature | حداقل (پایینترین) دمایی که در طول روز احساس میشود. |
max_heat_index | حداکثر دمای شاخص گرما در طول روز. |
sun_events | وقایع مربوط به خورشید (مثلاً طلوع خورشید، غروب خورشید). |
moon_events | رویدادهای مربوط به ماه (مثلاً طلوع ماه، غروب ماه). |
بخش روز پیشبینی
نشاندهندهی رکورد پیشبینی برای بخشی از روز است.
| فیلدها | |
|---|---|
interval | تاریخ و زمان UTC که این بخش از روز شروع (شامل) و پایان (منحصراً) میشود. توجه: بخشی از روز از ساعت ۷ صبح شروع و ساعت ۷ عصر همان روز، به وقت محلی، پایان مییابد. به عنوان مثال: اگر منطقه زمانی محلی UTC-7 باشد، بازه زمانی روز از ساعت |
weather_condition | وضعیت آب و هوای پیشبینی شده. |
precipitation | میزان بارندگی پیشبینی شده |
wind | میانگین جهت باد و حداکثر سرعت و تندباد. |
ice_thickness | مقدار یخ انباشته شده برای آن بخش از روز. |
relative_humidity | درصد رطوبت نسبی پیشبینیشده (مقادیر از ۰ تا ۱۰۰). |
uv_index | حداکثر شاخص فرابنفش پیشبینیشده (UV). |
thunderstorm_probability | احتمال متوسط رعد و برق. |
cloud_cover | میانگین درصد پوشش ابر |
ساعت پیشبینی
نشاندهندهی یک رکورد پیشبینی ساعتی در یک مکان مشخص است.
| فیلدها | |
|---|---|
interval | این دادههای پیشبینی برای بازه زمانی یک ساعته (به زمان UTC) معتبر است (مهرهای زمانی به نزدیکترین ساعت گرد شدهاند). |
display_date_time | تاریخ و زمان محلی در منطقه زمانی مکان (زمان رسمی) که این پیشبینی ساعتی برای آن محاسبه میشود. این فیلد ممکن است برای اهداف نمایشی در کلاینت استفاده شود. توجه: این تاریخ شامل سال، ماه، روز، ساعت و انحراف از UTC خواهد بود. |
weather_condition | وضعیت آب و هوای پیشبینی شده. |
temperature | دمای پیشبینیشده. |
feels_like_temperature | معیاری برای سنجش میزان دمایی که در محل مورد نظر احساس خواهد شد. |
dew_point | دمای نقطه شبنم پیشبینیشده |
heat_index | دمای پیشبینیشده شاخص گرما |
wind_chill | باد سرد پیشبینیشده، دمای هوایی که روی پوست نمایان میشود. |
wet_bulb_temperature | دمای حباب مرطوب پیشبینیشده، کمترین دمایی که با تبخیر آب قابل دستیابی است. |
precipitation | احتمال بارش پیشبینیشده و میزان بارش انباشتهشده در طول ساعت گذشته. |
air_pressure | شرایط فشار هوای پیشبینیشده |
wind | وضعیت باد پیشبینیشده |
visibility | میزان دید پیشبینیشده |
ice_thickness | ضخامت یخ پیشبینیشده |
is_daytime | اگر این ساعت بین زمان طلوع خورشید محلی (شامل) و غروب خورشید (به جز) باشد، درست است. در غیر این صورت، شب است (بین غروب خورشید و طلوع خورشید بعدی). توجه: اگر این بازه زمانی به ترتیب با زمان طلوع و غروب خورشید محلی تلاقی کند، این ساعت به عنوان روز یا شب در نظر گرفته میشود (مثلاً: اگر بازه زمانی از ۵ صبح تا ۶ صبح باشد و طلوع خورشید ساعت ۵:۵۹ صبح باشد، آنگاه is_daytime درست خواهد بود). |
relative_humidity | درصد رطوبت نسبی پیشبینیشده (مقادیر از ۰ تا ۱۰۰). |
uv_index | شاخص فرابنفش پیشبینیشده (UV). |
thunderstorm_probability | احتمال پیشبینیشدهی رعد و برق (مقادیر از ۰ تا ۱۰۰). |
cloud_cover | درصد پیشبینیشدهی آسمان پوشیده از ابر (مقادیر از ۰ تا ۱۰۰). |
ساعت تاریخ
نشاندهندهی یک رکورد تاریخچهی ساعتی در یک مکان مشخص است.
| فیلدها | |
|---|---|
interval | این دادههای تاریخی برای بازه زمانی یک ساعته (به زمان UTC) معتبر هستند (مهرهای زمانی به نزدیکترین ساعت گرد میشوند). |
display_date_time | تاریخ و زمان محلی در منطقه زمانی محل (زمان رسمی) که این رکورد ساعتی برای آن محاسبه میشود. این فیلد ممکن است برای اهداف نمایشی در کلاینت استفاده شود. توجه: این تاریخ شامل سال، ماه، روز، ساعت و انحراف از UTC خواهد بود. |
weather_condition | وضعیت آب و هوای تاریخی |
temperature | دمای تاریخی. |
feels_like_temperature | معیاری برای سنجش میزان دمای احساس شده در محل مورد نظر. |
dew_point | دمای نقطه شبنم تاریخی. |
heat_index | دمای شاخص گرمای تاریخی. |
wind_chill | بادِ سردِ تاریخی، دمای هوا که روی پوست نمایان میشود. |
wet_bulb_temperature | دمای حباب مرطوب تاریخی، پایینترین دمایی که با تبخیر آب قابل دستیابی است. |
precipitation | احتمال بارندگی تاریخی و میزان بارندگی انباشته شده در ساعت گذشته. |
air_pressure | شرایط فشار هوای تاریخی. |
wind | شرایط باد تاریخی. |
visibility | دید تاریخی. |
ice_thickness | ضخامت یخ تاریخی |
is_daytime | اگر این ساعت بین زمان طلوع خورشید محلی (شامل) و غروب خورشید (به جز) باشد، درست است. در غیر این صورت، شب است (بین غروب خورشید و طلوع خورشید بعدی). توجه: اگر این بازه زمانی به ترتیب با زمان طلوع و غروب خورشید محلی تلاقی کند، این ساعت به عنوان روز یا شب در نظر گرفته میشود (مثلاً: اگر بازه زمانی از ۵ صبح تا ۶ صبح باشد و طلوع خورشید ساعت ۵:۵۹ صبح باشد، آنگاه is_daytime درست خواهد بود). |
relative_humidity | درصد رطوبت نسبی تاریخی (مقادیر از ۰ تا ۱۰۰). |
uv_index | شاخص تاریخی فرابنفش (UV). |
thunderstorm_probability | احتمال وقوع رعد و برق در گذشته (مقادیر از ۰ تا ۱۰۰). |
cloud_cover | درصد تاریخی آسمان پوشیده از ابر (مقادیر از ۰ تا ۱۰۰). |
ضخامت یخ
نشان دهنده شرایط ضخامت یخ است.
| فیلدها | |
|---|---|
unit | کدی که واحد اندازهگیری ضخامت یخ را نشان میدهد. |
thickness | مقدار ضخامت یخ. |
واحد
واحدی را نشان میدهد که برای اندازهگیری ضخامت یخ استفاده میشود.
| انومها | |
|---|---|
UNIT_UNSPECIFIED | واحد مشخص نشده است. |
MILLIMETERS | ضخامت بر حسب میلیمتر اندازهگیری میشود. |
INCHES | ضخامت بر حسب اینچ اندازهگیری میشود. |
جستجوشرایط فعلیدرخواست
درخواست برای RPC مربوط به LookupCurrentConditions.
| فیلدها | |
|---|---|
location | الزامی. مکانی که قرار است شرایط آب و هوایی فعلی آن را دریافت کنید. |
units_system | اختیاری. سیستم واحد مورد استفاده برای شرایط آب و هوایی برگردانده شده. در صورت عدم ارائه، شرایط آب و هوایی برگردانده شده در سیستم متریک خواهد بود (پیش فرض = METRIC). |
language_code | اختیاری. به کلاینت اجازه میدهد زبان پاسخ را انتخاب کند. اگر دادهها برای آن زبان ارائه نشوند، API از نزدیکترین مورد منطبق استفاده میکند. مقادیر مجاز بر اساس استاندارد IETF BCP-47 هستند. مقدار پیشفرض "en" است. |
جستجوشرایط فعلیپاسخ
پاسخ برای RPC مربوط به LookupCurrentConditions - نشان دهنده شرایط آب و هوایی فعلی در مکان درخواست شده است.
| فیلدها | |
|---|---|
current_time | زمان فعلی (UTC) مرتبط با دادههای برگردانده شده. |
time_zone | منطقه زمانی در محل درخواستی. |
weather_condition | وضعیت آب و هوای فعلی. |
temperature | دمای فعلی. |
feels_like_temperature | معیاری برای سنجش دمای فعلی محل مورد نظر. |
dew_point | دمای نقطه شبنم فعلی. |
heat_index | دمای شاخص گرمای فعلی. |
wind_chill | باد سرد فعلی، دمای هوایی که روی پوست نمایان است. |
precipitation | احتمال بارش فعلی و میزان بارش انباشته شده در ساعت گذشته. |
air_pressure | شرایط فعلی فشار هوا. |
wind | وضعیت فعلی باد. |
visibility | میزان دید فعلی. |
current_conditions_history | تغییرات در شرایط فعلی طی ۲۴ ساعت گذشته. |
is_daytime | اگر زمان فعلی در مکان درخواستشده بین زمان طلوع آفتاب محلی (شامل) و زمان غروب آفتاب (بهجز) باشد، صحیح است. در غیر این صورت، شب است (بین غروب آفتاب و طلوع آفتاب بعدی). |
relative_humidity | درصد فعلی رطوبت نسبی (مقادیر از 0 تا 100). |
uv_index | شاخص فعلی اشعه ماوراء بنفش (UV). |
thunderstorm_probability | احتمال وقوع رعد و برق فعلی (مقادیر از 0 تا 100). |
cloud_cover | درصد فعلی آسمان پوشیده از ابر (مقادیر از ۰ تا ۱۰۰). |
شرایط فعلیتاریخچه
نشان دهنده مجموعهای از تغییرات در شرایط فعلی در طول ۲۴ ساعت گذشته است.
| فیلدها | |
|---|---|
temperature_change | دمای فعلی منهای دمای ۲۴ ساعت پیش. |
max_temperature | حداکثر (بالاترین) دما در ۲۴ ساعت گذشته. |
min_temperature | حداقل (پایینترین) دما در ۲۴ ساعت گذشته. |
snow_qpf | مقدار برفی که در ۲۴ ساعت گذشته انباشته شده است، به صورت معادل آب مایع اندازهگیری میشود. توجه: QPF مخفف پیشبینی کمی بارش است (برای جزئیات بیشتر، لطفاً به تعریف پیشبینی کمی بارش مراجعه کنید). |
qpf | میزان بارندگی، که به صورت معادل آب مایع اندازهگیری میشود و در طول ۲۴ ساعت گذشته انباشته شده است. توجه: QPF مخفف پیشبینی کمی بارش است (برای جزئیات بیشتر، لطفاً به تعریف پیشبینی کمی بارش مراجعه کنید). |
جستجوروزهای پیشبینیدرخواست
درخواست RPC مربوط به LookupForecastDays.
| فیلدها | |
|---|---|
location | الزامی. مکانی که قرار است پیشبینی روزانه آب و هوای آن را دریافت کنید. |
units_system | اختیاری. سیستم واحد مورد استفاده برای شرایط آب و هوایی برگردانده شده. در صورت عدم ارائه، شرایط آب و هوایی برگردانده شده در سیستم متریک خواهد بود (پیش فرض = METRIC). |
page_size | اختیاری. حداکثر تعداد رکوردهای پیشبینی روزانه برای برگرداندن در هر صفحه - مقداری از ۱ تا ۱۰ (شامل). مقدار پیشفرض ۵ است. |
page_token | اختیاری. یک توکن صفحه که از درخواست قبلی دریافت شده است. برای بازیابی صفحه بعدی استفاده میشود. |
days | اختیاری. تعداد کل روزهایی که از روز جاری قابل واکشی هستند را محدود میکند - مقداری از ۱ تا ۱۰ (شامل). مقدار پیشفرض، حداکثر مقدار مجاز ۱۰ است. |
language_code | اختیاری. به کلاینت اجازه میدهد زبان پاسخ را انتخاب کند. اگر دادهها برای آن زبان ارائه نشوند، API از نزدیکترین مورد منطبق استفاده میکند. مقادیر مجاز بر اساس استاندارد IETF BCP-47 هستند. مقدار پیشفرض "en" است. |
جستجوپیشبینیروزهاپاسخ
پاسخ برای RPC مربوط به LookupForecastDays.
| فیلدها | |
|---|---|
forecast_days[] | پیشبینی روزانه، بر اساس تعداد روزها و اندازه صفحه مشخص شده در درخواست، ثبت میشود. |
time_zone | منطقه زمانی در محل درخواستی. |
next_page_token | توکن برای بازیابی صفحه بعدی. |
جستجوپیش بینیساعتدرخواست
درخواست برای RPC مربوط به LookupForecastHours.
| فیلدها | |
|---|---|
location | الزامی. مکانی که قرار است پیشبینی ساعتی آن را دریافت کنید. |
units_system | اختیاری. سیستم واحد مورد استفاده برای شرایط آب و هوایی برگردانده شده. در صورت عدم ارائه، شرایط آب و هوایی برگردانده شده در سیستم متریک خواهد بود (پیش فرض = METRIC). |
page_size | اختیاری. حداکثر تعداد رکوردهای پیشبینی ساعتی که در هر صفحه برگردانده میشوند - مقداری از ۱ تا ۲۴ (شامل). مقدار پیشفرض، حداکثر مقدار مجاز ۲۴ است. |
page_token | اختیاری. یک توکن صفحه که از درخواست قبلی دریافت شده است. برای بازیابی صفحه بعدی استفاده میشود. |
hours | اختیاری. تعداد کل ساعاتی که از ساعت فعلی قابل واکشی هستند را محدود میکند - مقداری از ۱ تا ۲۴۰ (شامل). مقدار پیشفرض، حداکثر مقدار مجاز ۲۴۰ است. |
language_code | اختیاری. به کلاینت اجازه میدهد زبان پاسخ را انتخاب کند. اگر دادهها برای آن زبان ارائه نشوند، API از نزدیکترین مورد منطبق استفاده میکند. مقادیر مجاز بر اساس استاندارد IETF BCP-47 هستند. مقدار پیشفرض "en" است. |
جستجوپیشبینیساعتپاسخ
پاسخ برای RPC مربوط به LookupForecastHours.
| فیلدها | |
|---|---|
forecast_hours[] | پیشبینی ساعتی، بر اساس تعداد ساعات و اندازه صفحه مشخص شده در درخواست، ثبت میشود. |
time_zone | منطقه زمانی در محل درخواستی. |
next_page_token | توکن برای بازیابی صفحه بعدی. |
جستجوتاریخچهساعتدرخواست
درخواست برای RPC مربوط به LookupHistoryHours.
| فیلدها | |
|---|---|
location | الزامی. مکانی که قرار است دادههای تاریخی ساعتی آن را دریافت کنید. |
units_system | اختیاری. سیستم واحد مورد استفاده برای شرایط آب و هوایی برگردانده شده. در صورت عدم ارائه، شرایط آب و هوایی برگردانده شده در سیستم متریک خواهد بود (پیش فرض = METRIC). |
page_size | اختیاری. حداکثر تعداد رکوردهای تاریخی ساعتی برای برگرداندن در هر صفحه - مقداری از ۱ تا ۲۴ (شامل). مقدار پیشفرض حداکثر مجاز ۲۴ است. |
page_token | اختیاری. یک توکن صفحه که از درخواست قبلی دریافت شده است. برای بازیابی صفحه بعدی استفاده میشود. |
hours | اختیاری. تعداد کل ساعاتی که باید از آخرین ساعت واکشی شوند را محدود میکند - از ۱ تا ۲۴ (شامل). مقدار پیشفرض، حداکثر مقدار مجاز ۲۴ است. |
language_code | اختیاری. به کلاینت اجازه میدهد زبان پاسخ را انتخاب کند. اگر دادهها برای آن زبان ارائه نشوند، API از نزدیکترین مورد منطبق استفاده میکند. مقادیر مجاز بر اساس استاندارد IETF BCP-47 هستند. مقدار پیشفرض "en" است. |
جستجوتاریخچهساعتپاسخ
پاسخ برای RPC مربوط به LookupHistoryHours.
| فیلدها | |
|---|---|
history_hours[] | سوابق تاریخی ساعتی، مطابق با تعداد ساعات و اندازه صفحه مشخص شده در درخواست. |
time_zone | منطقه زمانی در محل درخواستی. |
next_page_token | توکن برای بازیابی صفحه بعدی. |
جستجودرخواست هشدارهای عمومی
درخواست برای RPC مربوط به LookupPublicAlerts.
| فیلدها | |
|---|---|
location | الزامی. مکانی که باید هشدارهای عمومی آب و هوا برای آن دریافت شود. این سرویس هشدارهایی را که منطقه آسیبدیده آنها با این مکان تلاقی دارد، برمیگرداند. |
page_size | اختیاری. حداکثر تعداد رکوردهای هشدار آب و هوای عمومی برای نمایش در هر صفحه. |
page_token | اختیاری. یک توکن صفحه که از فراخوانی قبلی |
language_code | اختیاری. به کلاینت اجازه میدهد زبان پاسخ را انتخاب کند. اگر دادهها برای آن زبان ارائه نشوند، API از نزدیکترین مورد منطبق استفاده میکند. مقادیر مجاز بر اساس استاندارد IETF BCP-47 هستند. مقدار پیشفرض "en" است. |
جستجوپاسخ هشدارهای عمومی
پاسخ برای RPC مربوط به LookupPublicAlerts.
| فیلدها | |
|---|---|
weather_alerts[] | هشدار عمومی آب و هوا، بر اساس تعداد هشدارها و اندازه صفحه مشخص شده در درخواست، اطلاعات را ثبت میکند. |
region_code | کد ISO_3166-1 alpha-2 مربوط به منطقهی مربوط به مکان ارائه شده در درخواست. این منطقه با استفاده از ISO_3166-1_alpha-2 بیان شده است. |
next_page_token | یک توکن که میتواند به عنوان |
رویدادهای ماه
رویدادهای مربوط به ماه (مثلاً طلوع ماه، غروب ماه) را نشان میدهد.
| فیلدها | |
|---|---|
moonrise_times[] | زمانی که لبه بالایی ماه در بالای افق ظاهر میشود (به https://en.wikipedia.org/wiki/Moonrise_and_moonset مراجعه کنید) . توجه: در بیشتر موارد، یک زمان طلوع ماه در هر روز وجود خواهد داشت. در موارد دیگر، لیست ممکن است خالی باشد (مثلاً وقتی ماه بعد از نیمه شب روز بعد طلوع میکند). با این حال، در موارد منحصر به فرد (مثلاً در مناطق قطبی)، لیست ممکن است شامل بیش از یک مقدار باشد. در این موارد، مقادیر به ترتیب صعودی مرتب میشوند. |
moonset_times[] | زمانی که لبه بالایی ماه در زیر افق ناپدید میشود (به https://en.wikipedia.org/wiki/Moonrise_and_moonset مراجعه کنید) . توجه: در بیشتر موارد، برای هر روز یک زمان مشخص برای ماه وجود دارد. در موارد دیگر، لیست ممکن است خالی باشد (مثلاً وقتی ماه بعد از نیمهشب روز بعد غروب میکند). با این حال، در موارد منحصر به فرد (مثلاً در مناطق قطبی)، لیست ممکن است شامل بیش از یک مقدار باشد. در این موارد، مقادیر به ترتیب صعودی مرتب میشوند. |
moon_phase | فاز ماه (معروف به فاز قمری). |
فاز ماه
فاز ماه (یا فاز قمری) را نشان میدهد.
| انومها | |
|---|---|
MOON_PHASE_UNSPECIFIED | فاز ماه نامشخص. |
NEW_MOON | ماه توسط خورشید روشن نمیشود. |
WAXING_CRESCENT | ماه در نیمکره شمالی 🌒 در سمت راست خود 0% تا 50% و در نیمکره جنوبی 🌘 در سمت چپ خود 🌘 روشن است. |
FIRST_QUARTER | ماه در نیمکره شمالی 🌓 در سمت راست خود 50.1٪ و در نیمکره جنوبی 🌗 در سمت چپ خود 50.1٪ روشن است. |
WAXING_GIBBOUS | ماه در نیمکره شمالی 🌔 در سمت راست خود 50٪ تا 100٪ و در نیمکره جنوبی 🌖 در سمت چپ خود روشن میشود. |
FULL_MOON | ماه کاملاً روشن است. |
WANING_GIBBOUS | ماه در نیمکره شمالی 🌖 در سمت چپ خود 50٪ تا 100٪ و در نیمکره جنوبی 🌔 در سمت راست خود روشن میشود. |
LAST_QUARTER | ماه در نیمکره شمالی 🌗 در سمت چپ خود 50.1٪ و در نیمکره جنوبی 🌓 در سمت راست خود 50.1٪ روشن است. |
WANING_CRESCENT | ماه در نیمکره شمالی 🌘 در سمت چپ خود 0% تا 50% و در نیمکره جنوبی 🌒 در سمت راست خود 🌒 روشن میشود. |
بارش
مجموعهای از مقادیر بارش را در یک مکان مشخص نشان میدهد.
| فیلدها | |
|---|---|
probability | احتمال بارش (مقادیر از 0 تا 100). |
snow_qpf | مقدار برفی که به صورت معادل آب مایع اندازهگیری میشود و در طول یک دوره زمانی انباشته شده است. توجه: QPF مخفف پیشبینی کمی بارش است (برای جزئیات بیشتر، لطفاً به تعریف پیشبینی کمی بارش مراجعه کنید). |
qpf | میزان بارش باران، که به صورت معادل آب مایع اندازهگیری میشود و در یک دوره زمانی انباشته شده است. توجه: QPF مخفف پیشبینی کمی بارش است (برای جزئیات بیشتر، لطفاً به تعریف پیشبینی کمی بارش مراجعه کنید). |
احتمال بارش
احتمال بارش در یک مکان مشخص را نشان میدهد.
| فیلدها | |
|---|---|
type | کدی که نوع بارش را نشان میدهد. |
percent | درصدی از ۰ تا ۱۰۰ که احتمال بارش را نشان میدهد. |
نوع بارش
نوع بارش را در یک مکان مشخص نشان میدهد.
| انومها | |
|---|---|
PRECIPITATION_TYPE_UNSPECIFIED | نوع بارش نامشخص. |
NONE | بدون بارندگی. |
SNOW | بارش برف. |
RAIN | بارش باران. |
LIGHT_RAIN | بارش خفیف باران. |
HEAVY_RAIN | بارش شدید باران. |
RAIN_AND_SNOW | هم بارش باران و هم بارش برف. |
SLEET | بارش تگرگ. |
FREEZING_RAIN | بارش باران یخی. |
هشدارهای عمومی
هشدارهای عمومی آب و هوا را نشان میدهد.
| فیلدها | |
|---|---|
alert_id | شناسه منحصر به فرد برای این هشدار. |
alert_title | عنوان محلیشده برای هشدار. |
event_type | نوع رویداد آب و هوایی. |
area_name | نام منطقهای که هشدار در آن صادر شده است. |
instruction[] | دستورالعملهای توصیهشده توسط ناشر. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومیسازی شود، اما تضمینی برای بومیسازی آن وجود ندارد. |
safety_recommendations[] | دستورالعمل توصیههای ایمنی به کاربر، این موارد میتواند توسط ناشر یا سایر مقامات ارائه شود. |
timezone_offset | اختلاف زمانی منطقه زمانی نسبت به UTC برای محل هشدار. این مقدار به صورت رشتهای که به 's' ختم میشود، قالببندی میشود، مثلاً "-14400s" به معنای 4 ساعت عقبتر از UTC. |
start_time | زمان شروع رویداد. |
expiration_time | زمان انقضای رویداد. |
data_source | جزئیات ناشری که هشدار را صادر کرده است. |
polygon | نمایش 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 | آخرین متنی که هشدار صادر شده توسط مرجع رسمی را شرح میدهد. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومیسازی شود، اما تضمینی برای بومیسازی آن وجود ندارد. |
severity | سطح شدت هشدار. |
certainty | قطعیت هشدار. |
urgency | فوریت هشدار. |
ناشر
منتشرکننده هشدار.
| انومها | |
|---|---|
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 | مرکز ملی هشدار سونامی |
پیشبینی بارش کمی
مقدار مورد انتظار بارش ذوب شده انباشته شده در یک دوره زمانی مشخص در یک منطقه مشخص را نشان میدهد (مرجع: https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast ) - که معمولاً به اختصار QPF نامیده میشود.
| فیلدها | |
|---|---|
unit | کد واحد مورد استفاده برای اندازهگیری میزان بارش انباشته شده. |
quantity | مقدار بارندگی، که به صورت معادل آب مایع اندازهگیری میشود، و در یک دوره زمانی انباشته شده است. |
واحد
واحدی را نشان میدهد که برای اندازهگیری میزان بارش انباشته شده استفاده میشود.
| انومها | |
|---|---|
UNIT_UNSPECIFIED | واحد بارش نامشخص. |
MILLIMETERS | میزان بارش بر حسب میلیمتر اندازهگیری میشود. |
INCHES | میزان بارش بر حسب اینچ اندازهگیری میشود. |
توصیههای ایمنی
نشان دهنده یک توصیه ایمنی است.
| فیلدها | |
|---|---|
directive | یک دستورالعمل برای کاربر. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومیسازی شود، اما تضمینی برای بومیسازی آن وجود ندارد. |
subtext | یک زیرمتن اختیاری برای دستورالعمل، که ممکن است شامل زمینه اضافی برای کاربر باشد. لطفاً توجه داشته باشید که اگرچه این فیلد باید بومیسازی شود، اما تضمینی برای بومیسازی آن وجود ندارد. |
شدت
کدی که شدت رویداد موضوع پیام هشدار را نشان میدهد.
| انومها | |
|---|---|
SEVERITY_UNKNOWN | شدت مشخص نیست. |
EXTREME | تهدید فوقالعاده برای جان یا مال. |
SEVERE | تهدید قابل توجه برای جان یا مال. |
MODERATE | تهدید احتمالی برای جان یا مال. |
MINOR | تهدید جزئی برای جان یا مال. |
واحد سرعت
نشان دهنده واحدی است که برای اندازه گیری سرعت استفاده می شود.
| انومها | |
|---|---|
SPEED_UNIT_UNSPECIFIED | واحد سرعت مشخص نشده است. |
KILOMETERS_PER_HOUR | سرعت بر حسب کیلومتر بر ساعت اندازهگیری میشود. |
MILES_PER_HOUR | سرعت بر حسب مایل در ساعت اندازهگیری میشود. |
رویدادهای سان
نشان دهنده وقایع مربوط به خورشید است (مثلاً طلوع خورشید، غروب خورشید).
| فیلدها | |
|---|---|
sunrise_time | ساعتی که خورشید طلوع میکند. نکته: در برخی موارد خاص (مثلاً شمال دایره قطبی) ممکن است زمان طلوع آفتاب برای یک روز وجود نداشته باشد. در این موارد، این فیلد تنظیم نخواهد شد. |
sunset_time | ساعتی که خورشید غروب میکند. نکته: در برخی موارد خاص (مثلاً شمال دایره قطبی) ممکن است زمان غروب آفتاب برای یک روز وجود نداشته باشد. در این موارد، این فیلد تنظیم نخواهد شد. |
دما
نشان دهنده مقدار دما است.
| فیلدها | |
|---|---|
unit | کد مربوط به واحد مورد استفاده برای اندازهگیری مقدار دما. |
degrees | مقدار دما (برحسب درجه) در واحد مشخص شده. |
واحد دما
نشان دهنده واحدی است که برای اندازه گیری دما استفاده می شود.
| انومها | |
|---|---|
TEMPERATURE_UNIT_UNSPECIFIED | واحد دما مشخص نشده است. |
CELSIUS | دما بر حسب سانتیگراد اندازهگیری میشود. |
FAHRENHEIT | دما بر حسب فارنهایت اندازهگیری میشود. |
سیستم واحدها
سیستم واحدهای مورد استفاده برای اندازهگیری مقادیر را نشان میدهد.
| انومها | |
|---|---|
UNITS_SYSTEM_UNSPECIFIED | سیستم واحدها مشخص نیست. |
IMPERIAL | سیستم واحدهای امپراتوری (مثلاً فارنهایت، مایل و غیره). |
METRIC | سیستم واحدهای متریک (مثلاً سانتیگراد، کیلومتر و غیره). |
فوریت
کدی که نشاندهندهی فوریت رویداد موضوع پیام هشدار است.
| انومها | |
|---|---|
URGENCY_UNKNOWN | فوریت مشخص نیست. |
IMMEDIATE | اقدامات واکنشی باید فوراً انجام شود. |
EXPECTED | اقدامات لازم باید به زودی (ظرف یک ساعت آینده) انجام شود. |
FUTURE | اقدامات واکنشی باید در آینده نزدیک انجام شود. |
PAST | دیگر نیازی به اقدام واکنشی نیست. |
قابلیت مشاهده
شرایط دید، یعنی فاصلهای که در آن میتوان اشیاء را تشخیص داد، را نشان میدهد.
| فیلدها | |
|---|---|
unit | کدی که واحد مورد استفاده برای اندازهگیری فاصله را نشان میدهد. |
distance | فاصله دید در واحد مشخص شده. |
واحد
واحدی را نشان میدهد که برای اندازهگیری فاصله دید استفاده میشود.
| انومها | |
|---|---|
UNIT_UNSPECIFIED | واحد دید مشخص نشده است. |
KILOMETERS | میزان دید بر حسب کیلومتر اندازهگیری میشود. |
MILES | میزان دید بر حسب مایل اندازهگیری میشود. |
وضعیت آب و هوا
نشان دهنده وضعیت آب و هوا برای یک مکان مشخص در یک دوره زمانی مشخص است.
سلب مسئولیت: آیکونهای آب و هوا و کدهای وضعیت ممکن است تغییر کنند. گوگل ممکن است در صورت نیاز، کدها و آیکونهای جدیدی را معرفی کند یا موارد موجود را بهروزرسانی کند. توصیه میکنیم برای بهروزترین اطلاعات، مرتباً به این مستندات مراجعه کنید.
| فیلدها | |
|---|---|
icon_base_uri | آدرس اینترنتی (URI) پایه برای آیکون، بدون در نظر گرفتن پسوند نوع فایل. برای نمایش آیکون، در صورت تمایل، یک تم و پسوند نوع فایل ( |
description | توضیحات متنی برای این وضعیت آب و هوایی (بومیسازی شده). |
type | نوع شرایط آب و هوایی. |
نوع
نوع وضعیت آب و هوا را در متن عنصر پیشبینی مشخص میکند.
| انومها | |
|---|---|
TYPE_UNSPECIFIED | وضعیت آب و هوا مشخص نیست. |
CLEAR | بدون ابر. |
MOSTLY_CLEAR | ابرهای دوره ای |
PARTLY_CLOUDY | هوای ابری (کمی ابری). |
MOSTLY_CLOUDY | عمدتاً ابری (ابر بیشتر از آفتاب). |
CLOUDY | ابری (تماماً ابری، بدون خورشید). |
WINDY | باد شدید. |
WIND_AND_RAIN | باد شدید همراه با بارندگی. |
LIGHT_RAIN_SHOWERS | باران ملایم و متناوب. |
CHANCE_OF_SHOWERS | احتمال بارش پراکنده باران. |
SCATTERED_SHOWERS | باران متناوب. |
RAIN_SHOWERS | رگبار به بارندگی گفته میشود که مدت زمان کوتاهتری نسبت به باران دارد و با ناگهانی بودن از نظر زمان شروع و توقف و تغییرات سریع در شدت مشخص میشود. |
HEAVY_RAIN_SHOWERS | رگبارهای شدید. |
LIGHT_TO_MODERATE_RAIN | باران (به مقدار کم تا متوسط). |
MODERATE_TO_HEAVY_RAIN | باران (با شدت متوسط تا شدید). |
RAIN | باران متوسط. |
LIGHT_RAIN | باران ملایم. |
HEAVY_RAIN | باران شدید. |
RAIN_PERIODICALLY_HEAVY | باران به صورت دورهای شدید. |
LIGHT_SNOW_SHOWERS | برف سبکی که با شدتهای مختلف و برای مدت کوتاهی میبارد. |
CHANCE_OF_SNOW_SHOWERS | احتمال بارش برف. |
SCATTERED_SNOW_SHOWERS | برفی که با شدتهای مختلف و برای مدت کوتاهی میبارد. |
SNOW_SHOWERS | رگبار برف. |
HEAVY_SNOW_SHOWERS | رگبار شدید برف. |
LIGHT_TO_MODERATE_SNOW | برف سبک تا متوسط. |
MODERATE_TO_HEAVY_SNOW | برف متوسط تا سنگین. |
SNOW | برف متوسط. |
LIGHT_SNOW | برف سبک. |
HEAVY_SNOW | برف سنگین. |
SNOWSTORM | برف همراه با احتمال رگبار و رعد و برق. |
SNOW_PERIODICALLY_HEAVY | برف، گاهی شدید. |
HEAVY_SNOW_STORM | برف سنگین همراه با احتمال رعد و برق. |
BLOWING_SNOW | برف همراه با باد شدید. |
RAIN_AND_SNOW | باران و برف با هم مخلوط میشوند. |
HAIL | درود. |
HAIL_SHOWERS | تگرگی که با شدتهای مختلف و برای مدت کوتاهی میبارد. |
THUNDERSTORM | رعد و برق. |
THUNDERSHOWER | رگبار باران همراه با رعد و برق و وزش باد. |
LIGHT_THUNDERSTORM_RAIN | باران رعد و برق خفیف. |
SCATTERED_THUNDERSTORMS | رعد و برقهایی که برای مدت کوتاهی با شدتهای مختلف باران همراه هستند. |
HEAVY_THUNDERSTORM | رعد و برق شدید. |
نوع رویداد آب و هوا
نوع رویداد آب و هوایی.
| انومها | |
|---|---|
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 | رویداد طوفان زمستانی. |
باد
مجموعهای از ویژگیهای باد را نشان میدهد.
| فیلدها | |
|---|---|
direction | جهت باد، زاویهای که باد از آن میوزد. |
speed | سرعت باد. |
gust | تندباد (افزایش ناگهانی سرعت باد). |
جهت باد
نشان دهنده جهتی است که باد از آن سرچشمه میگیرد.
| فیلدها | |
|---|---|
cardinal | کدی که جهت اصلی وزش باد را نشان میدهد. |
degrees | جهت باد بر حسب درجه (مقادیر از ۰ تا ۳۶۰). |
سرعت باد
نشان دهنده سرعت باد است.
| فیلدها | |
|---|---|
unit | کدی که واحد مورد استفاده برای اندازهگیری سرعت باد را نشان میدهد. |
value | مقدار سرعت باد. |