MCP Tools Reference: mapstools.googleapis.com

ابزار: lookup_weather

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

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

مکان و قوانین مکان (بسیار مهم):

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

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

    • وقتی مختصات دقیق طول/عرض جغرافیایی به شما ارائه می‌شود، از آن استفاده کنید.
    • مثال: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. شناسه جا (place_id)

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

  3. رشته نشانی (نشانی)

    • رشته‌ای با قالب آزاد که برای زمین‌کدیابی به جزئیات نیاز دارد.
    • شهر و منطقه: همیشه منطقه/کشور را اضافه کنید (مثلاً «لندن، پادشاهی متحد»، نه «لندن»).
    • نشانی خیابان: نشانی کامل را ارائه دهید (مثلاً «1600 Pennsylvania Ave NW, Washington, DC»).
    • کد پستی: باید همراه با نام کشور باشد (برای نمونه، «90210, USA» و نه «90210»).
    • مثال: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

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

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

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

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

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

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

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

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

درخواست Curl 
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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

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

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

LookupWeatherRequest

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

LatLng

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

number

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

number

طول جغرافیایی برحسب درجه. باید در محدوده [-180.0, +180.0] باشد.

UnitsSystem

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

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

طرح خروجی

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

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

LookupWeatherResponse

نمایش 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

احتمال رعدوبرق (مقادیر از ۰ تا ۱۰۰). اختیاری تعریف کنید چون همیشه دردسترس نیست

فیلد اتحادیه _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

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

AirPressure

نمایش 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

میانگین فشار هوای سطح دریا به میلی‌بار.

SunEvents

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

string (Timestamp format)

زمانی که خورشید طلوع می‌کند.

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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)

نشان‌دهنده ثانیه‌های ساعت هماهنگ جهانی از تاریخ یونیکس ‎1970-01-01T00:00:00Z است. باید بین ‎-۶۲۱۳۵۵۹۶۸۰۰ و ۲۵۳۴۰۲۳۰۰۷۹۹ باشد (که معادل ۰۰۰۱-۰۱-۰۱T00:00:00Z تا ۹۹۹۹-۱۲-۳۱T23:59:59Z است).
nanos

integer

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

MoonEvents

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

string (Timestamp format)

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

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولیدشده همیشه Z-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «Z» نیز پذیرفته می‌شود. مثال‌ها: "2014-10-02T15:01:23Z"، "2014-10-02T15:01:23.045123456Z"، یا "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

گام ماه (یا همان گام قمری).

WeatherCondition

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

string

URI پایه برای نماد، بدون احتساب افزونه نوع فایل. برای نمایش نماد، درصورت تمایل، یک زمینه و افزونه نوع فایل (.png یا .svg) را به این URI اضافه کنید. به‌طور پیش‌فرض، نماد دارای زمینه روشن است، اما _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)

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

LocalizedText

نمایش 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)

احتمال بارش (مقادیر از ۰ تا ۱۰۰).
snowQpf

object (QuantitativePrecipitationForecast)

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

object (QuantitativePrecipitationForecast)

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

PrecipitationProbability

نمایش 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

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

QuantitativePrecipitationForecast

نمایش 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)

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

WindDirection

نمایش 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

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

WindSpeed

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

LatLng

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

number

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

number

طول جغرافیایی برحسب درجه. باید در محدوده [-180.0, +180.0] باشد.

اِسناد

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

string

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

string

نشانی وب برای پیوند دادن به اِسناد.

TemperatureUnit

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

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

MoonPhase

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

شمارشی‌ها
MOON_PHASE_UNSPECIFIED گام ماه نامشخص است.
NEW_MOON ماه توسط خورشید روشن نمی‌شود.
WAXING_CRESCENT در نیم‌کره شمالی، ۰٪ تا ۵۰٪ از سمت راست ماه روشن است 🌒 و در نیم‌کره جنوبی، ۰٪ تا ۵۰٪ از سمت چپ ماه روشن است 🌘.
FIRST_QUARTER ‫۵۰٫۱٪ از سمت راست ماه در نیم‌کره شمالی 🌓 و سمت چپ آن در نیم‌کره جنوبی 🌗 روشن است.
WAXING_GIBBOUS در نیم‌کره شمالی، ۵۰٪ تا ۱۰۰٪ سمت راست ماه روشن است 🌔 و در نیم‌کره جنوبی، سمت چپ آن روشن است 🌖.
FULL_MOON ماه کاملاً روشن است.
WANING_GIBBOUS ‫۵۰٪ تا ۱۰۰٪ سمت چپ ماه در نیم‌کره شمالی 🌖 و سمت راست آن در نیم‌کره جنوبی 🌔 روشن است.
LAST_QUARTER ‫۵۰٫۱٪ از ماه در نیم‌کره شمالی در سمت چپ 🌗 و در نیم‌کره جنوبی در سمت راست 🌓 روشن است.
WANING_CRESCENT ماه در نیم‌کره شمالی 🌘 از سمت چپ و در نیم‌کره جنوبی 🌒 از سمت راست به‌اندازه ۰٪ تا ۵۰٪ روشن است.

نوع

نوع شرایط آب‌وهوایی را در بافت عنصر پیش‌بینی علامت‌گذاری می‌کند.

شمارشی‌ها
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 توفان تندری سنگین.

PrecipitationType

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

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

واحد

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

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

CardinalDirection

نشان‌دهنده جهت اصلی (ازجمله جهت‌های فرعی) است.

شمارشی‌ها
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 جهت فرعی شمال-شمال غربی.

SpeedUnit

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

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

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

حاشیه‌نویسی‌های ابزار به کارخواهان MCP ارسال می‌شود تا خطر اصلی ابزار موردنظر را شرح دهد. اکثر کارخواه‌ها این راهنمایی‌ها را غیرقابل‌اعتماد تلقی می‌کنند، اما می‌توان از آن‌ها برای تصمیم‌گیری درباره زمان ارسال پیام‌واره تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به‌صورت زیر تعریف می‌شوند:

  • ‫readOnlyHint: اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: false.
  • ‫destructiveHint: اگر درست باشد، ابزار می‌تواند کنش‌های مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند کنش‌های افزایشی انجام دهد. پیش‌فرض: true.
  • idempotentHint: اگر درست باشد، فراخوانی مکرر ابزار با آرگومان‌های یکسان تأثیر بیشتری بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • openWorldHint: اگر درست باشد، ابزار می‌تواند با «دنیای باز» نهادهای خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با نهادهای داخلی تعامل داشته باشد. برای مثال، ابزار جستجوی وب دنیای باز است، درحالی‌که ابزار حافظه دنیای باز نیست.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌