MCP Tools Reference: mapstools.googleapis.com

ابزار: lookup_weather

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

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

مکان و قوانین مکان (حیاتی):

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

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

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

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

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

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

    • رشته‌ای با قالب آزاد که برای زمین‌کدیابی به جزئیات نیاز دارد.
    • شهر و منطقه: همیشه منطقه/کشور را اضافه کنید (برای نمونه، «تهران، ایران»، نه «تهران»).
    • نشانی خیابان: نشانی کامل را ارائه دهید (برای نمونه، «1600 Pennsylvania Ave NW, Washington, DC»).
    • کدهای پستی/کد منطقه: حتماً باید با نام کشور همراه باشد (برای نمونه، «۹۰۲۱۰، ایالات متحده امریکا»، نه «۹۰۲۱۰»).
    • مثال: {"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 برای فراخوانی ابزار lookup_weather MCP را نشان می‌دهد.

درخواست 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)

اختیاری. سیستم واحدها برای استفاده در شرایط آب‌وهوای برگشتی. اگر ارائه نشود، شرایط آب‌وهوای برگشتی در سیستم متریک خواهد بود (پیش‌فرض = متریک).
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

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

number

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

UnitsSystem

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

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

طرح‌واره برونداد

پاسخ برای «فراخوانی رویه دور Weather» - نشان‌دهنده شرایط آب‌وهوایی در مکان درخواست‌شده است.

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

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)

الزامی. مکان برگشت اطلاعات آب‌وهوا. این مکان با مکان درخواست یکسان است، اما اگر مکان درخواست‌شده نشانی نوشتار آزاد باشد که به مکان تقریبی (مثلاً «مانتین ویو، کالیفرنیا») جستجو می‌شود، می‌تواند با آن متفاوت باشد.
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 است. باید بین ۶۲۱۳۵۵۹۶۸۰۰- و ۲۵۳۴۰۲۳۰۰۷۹۹ شامل این دو عدد باشد (که معادل ۰۰۰۱-۰۱-۰۱T۰۰:۰۰:۰۰Z تا ۹۹۹۹-۱۲-۳۱T۲۳:۵۹:۵۹Z است).
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) را به این نشانی وب اضافه کنید. به‌طور پیش‌فرض، نماد دارای زمینه روشن است، اما می‌توان _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 مخفف «پیش‌بینی کمی بارش» است (برای جزئیات بیشتر، لطفاً تعریف «پیش‌بینی کمی بارش» را ببینید).
qpf

object (QuantitativePrecipitationForecast)

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

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

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

number

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

اِسناد

نمایش 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: اگر درست باشد، ابزار محیطش را تغییر نمی‌دهد. پیش‌فرض: نادرست.
  • ‫destructiveHint: اگر درست باشد، ابزار می‌تواند کنش‌های مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند کنش‌های افزودنی انجام دهد. پیش‌فرض: درست.
  • idempotentHint: اگر درست باشد، فراخوانی مکرر ابزار با همان آرگومان‌ها تأثیر اضافه‌ای بر محیط آن نخواهد داشت. پیش‌فرض: نادرست.
  • ‫openWorldHint: اگر درست باشد، ابزار می‌تواند با «دنیای باز» نهادهای خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با نهادهای داخلی تعامل داشته باشد. برای مثال، ابزار جستجوی وب دنیای باز است، اما ابزار حافظه دنیای باز نیست.

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