MCP Tools Reference: mapstools.googleapis.com

ابزار: lookup_weather

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

داده‌های خاص موجود: دما (دمای فعلی، دمای مورد انتظار، حداکثر/حداقل، شاخص گرما)، باد (سرعت، تندباد، جهت)، رویدادهای آسمانی (طلوع/غروب خورشید، فاز ماه)، بارش (نوع، احتمال، مقدار/QPF)، شرایط جوی (شاخص UV، رطوبت، پوشش ابر، احتمال رعد و برق) و آدرس موقعیت مکانی با کد جغرافیایی.

قوانین مکان و مکان (مهم):

مکانی که داده‌های آب و هوا برای آن درخواست می‌شود با استفاده از فیلد location مشخص می‌شود. این فیلد ساختار «یکی از» دارد، به این معنی که برای اطمینان از جستجوی دقیق داده‌های آب و هوا، باید فقط برای یکی از سه فیلد فرعی مکان زیر مقداری ارائه دهید.

  1. مختصات جغرافیایی (lat_lng)

    • وقتی مختصات دقیق عرض/طول جغرافیایی (lat/lng) به شما ارائه شد، از آن استفاده کنید.
    • مثال: {"مکان": {"lat_lng": {"عرض جغرافیایی": 34.0522، "طول جغرافیایی": -118.2437}}} // لس آنجلس

  2. شناسه مکان (place_id)

    • یک شناسه رشته‌ای بدون ابهام (شناسه مکان گوگل مپ).
    • place_id را می‌توان از ابزار search_places دریافت کرد.
    • مثال: {"مکان": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // برج ایفل

  3. رشته آدرس (آدرس)

    • یک رشته آزاد که برای کدگذاری جغرافیایی به ویژگی خاصی نیاز دارد.
    • شهر و منطقه: همیشه منطقه/کشور را وارد کنید (مثلاً «لندن، بریتانیا»، نه «لندن»).
    • آدرس خیابان: آدرس کامل را وارد کنید (مثلاً «۱۶۰۰ خیابان پنسیلوانیا شمال غربی، واشنگتن دی سی»).
    • کد پستی: باید با نام کشور همراه باشد (مثلاً «۹۰۲۱۰، ایالات متحده آمریکا»، نه «۹۰۲۱۰»).
    • مثال: {"مکان": {"آدرس": "خیابان پنسیلوانیا ۱۶۰۰ شمال غربی، واشنگتن دی سی"}}

حالت‌های استفاده:

  • آب و هوای فعلی: فقط location ارائه دهید. date و hour را مشخص نکنید.

  • پیش‌بینی ساعتی: location ، date و hour (0-23) را وارد کنید. برای زمان‌های خاص (مثلاً "ساعت 5 بعد از ظهر") یا عباراتی مانند "چند ساعت آینده" یا "بعداً امروز" استفاده کنید. اگر کاربر دقیقه را مشخص کند، به نزدیکترین ساعت گرد می‌شود. پیش‌بینی ساعتی فراتر از 120 ساعت از الان پشتیبانی نمی‌شود. آب و هوای ساعتی تاریخی تا 24 ساعت گذشته پشتیبانی می‌شود.

  • پیش‌بینی روزانه: location و date را وارد کنید. hour مشخص نکنید. برای درخواست‌های عمومی روزانه استفاده کنید (مثلاً «آب و هوای فردا»، «آب و هوای جمعه»، «آب و هوای ۲۵/۱۲»). اگر تاریخ امروز در متن نیست، باید آن را با کاربر روشن کنید. پیش‌بینی روزانه فراتر از ۱۰ روز شامل امروز پشتیبانی نمی‌شود. آب و هوای تاریخی پشتیبانی نمی‌شود.

محدودیت‌های پارامتر:

  • مناطق زمانی: تمام ورودی‌های date و hour باید نسبت به منطقه زمانی محلی مکان باشند، نه منطقه زمانی کاربر.
  • قالب تاریخ: ورودی‌ها باید به صورت اعداد صحیح {year, month, day} جدا شوند.
  • واحدها: پیش‌فرض روی METRIC است. اگر کاربر استانداردهای ایالات متحده را مطرح می‌کند یا صریحاً درخواست می‌کند، units_system برای فارنهایت/مایل روی IMPERIAL تنظیم کنید.

  • خروجی متصل به زمین باید با استفاده از اطلاعات موجود در فیلد attribution در صورت وجود، به منبع نسبت داده شود.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار lookup_weather MCP را نشان می‌دهد.

درخواست کرل 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست برای متد LookupWeather - نشان دهنده شرایط آب و هوایی در مکان درخواست شده است.

درخواست جستجو آب و هوا

نمایش JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.
}
فیلدها
unitsSystem

enum ( UnitsSystem )

اختیاری. سیستم واحد مورد استفاده برای شرایط آب و هوایی برگردانده شده. در صورت عدم ارائه، شرایط آب و هوایی برگردانده شده در سیستم متریک خواهد بود (پیش فرض = METRIC).

location

object ( Location )

الزامی. مکانی که باید شرایط آب و هوایی آن را دریافت کنید.

فیلد اتحادیه _date .

_date فقط می‌تواند یکی از موارد زیر باشد:

date

object ( Date )

اختیاری. تاریخ اطلاعات آب و هوایی مورد نیاز. توجه: این تاریخ نسبت به منطقه زمانی محلی مکان مشخص شده در فیلد مکان است. تاریخ باید بین ۲۴ ساعت گذشته و ۱۰ روز آینده باشد.

میدان اتحادیه _hour .

_hour فقط می‌تواند یکی از موارد زیر باشد:

hour

integer

اختیاری. ساعت اطلاعات آب و هوای درخواستی، در قالب ۲۴ ساعته (۰-۲۳). این مقدار نسبت به منطقه زمانی محلی مکان مشخص شده در فیلد مکان است. پیش‌بینی ساعتی فراتر از ۱۲۰ ساعت از اکنون پشتیبانی نمی‌شود. آب و هوای ساعتی تاریخی تا ۲۴ ساعت گذشته پشتیبانی می‌شود.

تاریخ

نمایش JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
فیلدها
year

integer

سال تاریخ. باید از ۱ تا ۹۹۹۹ باشد، یا برای مشخص کردن تاریخ بدون سال، ۰ باشد.

month

integer

ماه سال. باید از ۱ تا ۱۲ باشد، یا برای مشخص کردن سال بدون ماه و روز، ۰ باشد.

day

integer

روز ماه. باید از ۱ تا ۳۱ باشد و برای سال و ماه معتبر باشد، یا ۰ برای مشخص کردن یک سال به تنهایی یا یک سال و ماه که روز در آن مهم نیست.

مکان

نمایش JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
فیلدها
فیلد واحد location_type . روش‌های مختلف برای نمایش یک مکان. location_type فقط می‌تواند یکی از موارد زیر باشد:
latLng

object ( LatLng )

نقطه‌ای که با استفاده از مختصات جغرافیایی مشخص شده است.

placeId

string

شناسه مکان مرتبط با مکان.

address

string

آدرس قابل خواندن توسط انسان یا یک کد پلاس. برای جزئیات بیشتر به https://plus.codes مراجعه کنید.

لات‌لنگ

نمایش JSON 
{
  "latitude": number,
  "longitude": number
}
فیلدها
latitude

number

عرض جغرافیایی بر حسب درجه. باید در محدوده [-90.0، +90.0] باشد.

longitude

number

طول جغرافیایی بر حسب درجه. باید در محدوده [-۱۸۰.۰، +۱۸۰.۰] باشد.

سیستم واحدها

سیستم واحدهای مورد استفاده برای اندازه‌گیری مقادیر را نشان می‌دهد.

انوم‌ها
UNITS_SYSTEM_UNSPECIFIED سیستم واحدها مشخص نیست.
IMPERIAL سیستم واحدهای امپراتوری (مثلاً فارنهایت، مایل و غیره).
METRIC سیستم واحدهای متریک (مثلاً سانتیگراد، کیلومتر و غیره).

طرحواره خروجی

پاسخ برای RPC مربوط به LookupWeather - نشان دهنده شرایط آب و هوایی در مکان درخواست شده است.

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

جستجو در آب و هوا

نمایش JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
فیلدها
weatherCondition

object ( WeatherCondition )

وضعیت آب و هوا

precipitation

object ( Precipitation )

احتمال بارندگی و میزان بارندگی تجمعی

wind

object ( Wind )

شرایط باد

returnedLocation

object ( Location )

الزامی. مکانی که اطلاعات آب و هوا در آن برگردانده می‌شود. این مکان با مکان موجود در درخواست یکسان است، اما اگر مکان درخواستی یک آدرس متن آزاد باشد که به یک مکان تقریبی (مثلاً "Mountain View، CA") اشاره دارد، می‌تواند متفاوت باشد.

attribution

object ( Attribution )

برای نمایش آب و هوا، ذکر منبع الزامی است.

میدان یونیون _temperature .

_temperature فقط می‌تواند یکی از موارد زیر باشد:

temperature

object ( Temperature )

دمای ساعتی

میدان یونیون _feels_like_temperature .

_feels_like_temperature فقط می‌تواند یکی از موارد زیر باشد:

feelsLikeTemperature

object ( Temperature )

معیار ساعتی برای سنجش دمای هوا.

_heat_index .

_heat_index فقط می‌تواند یکی از موارد زیر باشد:

heatIndex

object ( Temperature )

دمای شاخص گرمای ساعتی.

_air_pressure .

_air_pressure فقط می‌تواند یکی از موارد زیر باشد:

airPressure

object ( AirPressure )

شرایط فشار هوای ساعتی.

فیلد اتحادیه _max_temperature .

_max_temperature فقط می‌تواند یکی از موارد زیر باشد:

maxTemperature

object ( Temperature )

حداکثر (بالاترین) دما در طول روز.

فیلد اتحادیه _min_temperature .

_min_temperature می‌تواند فقط یکی از موارد زیر باشد:

minTemperature

object ( Temperature )

حداقل (پایین‌ترین) دما در طول روز.

فیلد اتحادیه _feels_like_max_temperature .

_feels_like_max_temperature می‌تواند فقط یکی از موارد زیر باشد:

feelsLikeMaxTemperature

object ( Temperature )

حداکثر (بالاترین) دمایی که در طول روز احساس می‌شود.

فیلد اتحادیه _feels_like_min_temperature .

_feels_like_min_temperature می‌تواند فقط یکی از موارد زیر باشد:

feelsLikeMinTemperature

object ( Temperature )

حداقل (پایین‌ترین) دمایی که در طول روز احساس می‌شود.

فیلد اتحادیه _max_heat_index .

_max_heat_index می‌تواند فقط یکی از موارد زیر باشد:

maxHeatIndex

object ( Temperature )

حداکثر دمای شاخص گرما در طول روز.

_sun_events میدان یونیون.

_sun_events فقط می‌تواند یکی از موارد زیر باشد:

sunEvents

object ( SunEvents )

وقایع مربوط به خورشید (مثلاً طلوع خورشید، غروب خورشید).

_moon_events میدان یونیون.

_moon_events فقط می‌تواند یکی از موارد زیر باشد:

moonEvents

object ( MoonEvents )

رویدادهای مربوط به ماه (مثلاً طلوع ماه، غروب ماه).

_relative_humidity میدان یونیون.

_relative_humidity فقط می‌تواند یکی از موارد زیر باشد:

relativeHumidity

integer

درصد رطوبت نسبی (مقادیر از ۰ تا ۱۰۰). تعریف اختیاری است زیرا همیشه در دسترس نیست

فیلد یونیون _uv_index .

_uv_index فقط می‌تواند یکی از موارد زیر باشد:

uvIndex

integer

حداکثر شاخص فرابنفش (UV). تعریف آن اختیاری است زیرا همیشه در دسترس نیست.

_thunderstorm_probability در میدان یونیون.

_thunderstorm_probability می‌تواند فقط یکی از موارد زیر باشد:

thunderstormProbability

integer

احتمال رعد و برق (مقادیر از 0 تا 100). تعریف اختیاری است زیرا همیشه در دسترس نیست

_cloud_cover میدان یونیون.

_cloud_cover فقط می‌تواند یکی از موارد زیر باشد:

cloudCover

integer

درصد آسمان پوشیده از ابر (مقادیر از ۰ تا ۱۰۰). تعریف اختیاری است زیرا همیشه در دسترس نیست.

دما

نمایش JSON 
{
  "unit": enum (TemperatureUnit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
فیلدها
unit

enum ( TemperatureUnit )

کد مربوط به واحد مورد استفاده برای اندازه‌گیری مقدار دما.

رشته تحصیلی اتحادیه _degrees .

_degrees فقط می‌تواند یکی از موارد زیر باشد:

degrees

number

مقدار دما (برحسب درجه) در واحد مشخص شده.

فشار هوا

نمایش JSON 
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
فیلدها

میدان یونیون _mean_sea_level_millibars .

_mean_sea_level_millibars فقط می‌تواند یکی از موارد زیر باشد:

meanSeaLevelMillibars

number

فشار متوسط ​​هوا در سطح دریا بر حسب میلی بار.

رویدادهای سان

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

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" .

sunsetTime

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" .

مهر زمانی

نمایش JSON 
{
  "seconds": string,
  "nanos": integer
}
فیلدها
seconds

string ( int64 format)

ثانیه‌های زمان UTC را از زمان یونیکس ۱۹۷۰-۰۱-۰۱T۰۰:۰۰:۰۰Z نشان می‌دهد. باید بین -۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).

nanos

integer

کسرهای غیرمنفی ثانیه با وضوح نانوثانیه. این فیلد بخش نانوثانیه از مدت زمان است، نه جایگزینی برای ثانیه. مقادیر منفی ثانیه با کسرها باید همچنان دارای مقادیر نانوثانیه غیرمنفی باشند که در زمان به جلو شمارش می‌شوند. باید بین ۰ تا ۹۹۹۹۹۹۹۹۹۹ باشد.

رویدادهای ماه

نمایش JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
فیلدها
moonriseTimes[]

string ( Timestamp format)

زمانی که لبه بالایی ماه در بالای افق ظاهر می‌شود (به https://en.wikipedia.org/wiki/Moonrise_and_moonset مراجعه کنید) .

توجه: در بیشتر موارد، یک زمان طلوع ماه در هر روز وجود خواهد داشت. در موارد دیگر، لیست ممکن است خالی باشد (مثلاً وقتی ماه بعد از نیمه شب روز بعد طلوع می‌کند). با این حال، در موارد منحصر به فرد (مثلاً در مناطق قطبی)، لیست ممکن است شامل بیش از یک مقدار باشد. در این موارد، مقادیر به ترتیب صعودی مرتب می‌شوند.

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

moonsetTimes[]

string ( Timestamp format)

زمانی که لبه بالایی ماه در زیر افق ناپدید می‌شود (به https://en.wikipedia.org/wiki/Moonrise_and_moonset مراجعه کنید) .

توجه: در بیشتر موارد، برای هر روز یک زمان مشخص برای ماه وجود دارد. در موارد دیگر، لیست ممکن است خالی باشد (مثلاً وقتی ماه بعد از نیمه‌شب روز بعد غروب می‌کند). با این حال، در موارد منحصر به فرد (مثلاً در مناطق قطبی)، لیست ممکن است شامل بیش از یک مقدار باشد. در این موارد، مقادیر به ترتیب صعودی مرتب می‌شوند.

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

moonPhase

enum ( MoonPhase )

فاز ماه (معروف به فاز قمری).

وضعیت آب و هوا

نمایش JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
فیلدها
iconBaseUri

string

آدرس اینترنتی (URI) پایه برای آیکون، بدون در نظر گرفتن پسوند نوع فایل. برای نمایش آیکون، در صورت تمایل، یک تم و پسوند نوع فایل ( .png یا .svg ) را به این آدرس اینترنتی اضافه کنید. به طور پیش‌فرض، آیکون با تم روشن است، اما می‌توان برای حالت تاریک، _dark را اضافه کرد. به عنوان مثال: "https://maps.gstatic.com/weather/v1/dust.svg" یا "https://maps.gstatic.com/weather/v1/dust_dark.svg"، که icon_base_uri برابر با "https://maps.gstatic.com/weather/v1/dust" است.

description

object ( LocalizedText )

توضیحات متنی برای این وضعیت آب و هوایی (بومی‌سازی شده).

type

enum ( Type )

نوع شرایط آب و هوایی.

متن محلی‌شده

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

string

رشته‌ی محلی‌شده به زبانی که متناظر با google.type.LocalizedText.language_code در زیر است.

languageCode

string

کد زبان BCP-47 متن، مانند "en-US" یا "sr-Latn".

برای اطلاعات بیشتر، به آدرس http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید.

بارش

نمایش JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
فیلدها
probability

object ( PrecipitationProbability )

احتمال بارش (مقادیر از 0 تا 100).

snowQpf

object ( QuantitativePrecipitationForecast )

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

qpf

object ( QuantitativePrecipitationForecast )

میزان بارش باران، که به صورت معادل آب مایع اندازه‌گیری می‌شود و در یک دوره زمانی انباشته شده است. توجه: QPF مخفف پیش‌بینی کمی بارش است (برای جزئیات بیشتر، لطفاً به تعریف پیش‌بینی کمی بارش مراجعه کنید).

احتمال بارش

نمایش JSON 
{
  "type": enum (PrecipitationType),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
فیلدها
type

enum ( PrecipitationType )

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

فیلد اتحادیه _percent .

_percent فقط می‌تواند یکی از موارد زیر باشد:

percent

integer

درصدی از ۰ تا ۱۰۰ که احتمال بارش را نشان می‌دهد.

پیش‌بینی بارش کمی

نمایش JSON 
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
فیلدها
unit

enum ( Unit )

کد واحد مورد استفاده برای اندازه‌گیری میزان بارش انباشته شده.

فیلد مشترک _quantity .

_quantity فقط می‌تواند یکی از موارد زیر باشد:

quantity

number

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

باد

نمایش JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
فیلدها
direction

object ( WindDirection )

جهت باد، زاویه‌ای که باد از آن می‌وزد.

speed

object ( WindSpeed )

سرعت باد.

gust

object ( WindSpeed )

تندباد (افزایش ناگهانی سرعت باد).

جهت باد

نمایش JSON 
{
  "cardinal": enum (CardinalDirection),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
فیلدها
cardinal

enum ( CardinalDirection )

کدی که جهت اصلی وزش باد را نشان می‌دهد.

رشته تحصیلی اتحادیه _degrees .

_degrees فقط می‌تواند یکی از موارد زیر باشد:

degrees

integer

جهت باد بر حسب درجه (مقادیر از ۰ تا ۳۶۰).

سرعت باد

نمایش JSON 
{
  "unit": enum (SpeedUnit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
فیلدها
unit

enum ( SpeedUnit )

کدی که واحد مورد استفاده برای اندازه‌گیری سرعت باد را نشان می‌دهد.

_value .

_value فقط می‌تواند یکی از موارد زیر باشد:

value

number

مقدار سرعت باد.

مکان

نمایش JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
فیلدها
فیلد واحد location_type . روش‌های مختلف برای نمایش یک مکان. location_type فقط می‌تواند یکی از موارد زیر باشد:
latLng

object ( LatLng )

نقطه‌ای که با استفاده از مختصات جغرافیایی مشخص شده است.

placeId

string

شناسه مکان مرتبط با مکان.

address

string

آدرس قابل خواندن توسط انسان یا یک کد پلاس. برای جزئیات بیشتر به https://plus.codes مراجعه کنید.

لات‌لنگ

نمایش JSON 
{
  "latitude": number,
  "longitude": number
}
فیلدها
latitude

number

عرض جغرافیایی بر حسب درجه. باید در محدوده [-90.0، +90.0] باشد.

longitude

number

طول جغرافیایی بر حسب درجه. باید در محدوده [-۱۸۰.۰، +۱۸۰.۰] باشد.

انتساب

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

string

عنوانی که برای انتساب نمایش داده می‌شود.

url

string

نشانی اینترنتی (URL) برای پیوند دادن به منبع.

واحد دما

نشان دهنده واحدی است که برای اندازه گیری دما استفاده می شود.

انوم‌ها
TEMPERATURE_UNIT_UNSPECIFIED واحد دما مشخص نشده است.
CELSIUS دما بر حسب سانتیگراد اندازه‌گیری می‌شود.
FAHRENHEIT دما بر حسب فارنهایت اندازه‌گیری می‌شود.

فاز ماه

فاز ماه (یا فاز قمری) را نشان می‌دهد.

انوم‌ها
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% و در نیمکره جنوبی 🌒 در سمت راست خود 🌒 روشن می‌شود.

نوع

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

انوم‌ها
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 رعد و برق شدید.

نوع بارش

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

انوم‌ها
PRECIPITATION_TYPE_UNSPECIFIED نوع بارش نامشخص.
NONE بدون بارندگی.
SNOW بارش برف.
RAIN بارش باران.
LIGHT_RAIN بارش خفیف باران.
HEAVY_RAIN بارش شدید باران.
RAIN_AND_SNOW هم بارش باران و هم بارش برف.
SLEET بارش تگرگ.
FREEZING_RAIN بارش باران یخی.

واحد

واحدی را نشان می‌دهد که برای اندازه‌گیری میزان بارش انباشته شده استفاده می‌شود.

انوم‌ها
UNIT_UNSPECIFIED واحد بارش نامشخص.
MILLIMETERS میزان بارش بر حسب میلی‌متر اندازه‌گیری می‌شود.
INCHES میزان بارش بر حسب اینچ اندازه‌گیری می‌شود.

کاردینال دایرکتوریشن

نشان دهنده یک جهت اصلی (شامل جهت‌های ترتیبی) است.

انوم‌ها
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 جهت بین‌قطبی ثانویه شمال-شمال‌غربی.

واحد سرعت

نشان دهنده واحدی است که برای اندازه گیری سرعت استفاده می شود.

انوم‌ها
SPEED_UNIT_UNSPECIFIED واحد سرعت مشخص نشده است.
KILOMETERS_PER_HOUR سرعت بر حسب کیلومتر بر ساعت اندازه‌گیری می‌شود.
MILES_PER_HOUR سرعت بر حسب مایل در ساعت اندازه‌گیری می‌شود.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌