Инструмент: lookup_weather
Получает исчерпывающие данные о погоде, включая текущие условия, почасовые и суточные прогнозы.
Доступны следующие данные: температура (текущая, ощущаемая, максимальная/минимальная, индекс жары), ветер (скорость, порывы, направление), небесные явления (восход/заход солнца, фаза луны), осадки (тип, вероятность, количество/QPF), атмосферные условия (УФ-индекс, влажность, облачность, вероятность грозы) и адрес с геолокацией.
Местоположение и правила определения местоположения (КРИТИЧЕСКИ ВАЖНО):
Местоположение, для которого запрашиваются данные о погоде, указывается с помощью поля « location . Это поле имеет структуру типа «один из», то есть для обеспечения точного поиска данных о погоде НЕОБХОДИМО указать значение ТОЛЬКО для ОДНОГО из трех подполей местоположения, указанных ниже.
Географические координаты (широта_долгота)
- Используйте этот метод, если вам предоставлены точные координаты широты и долготы.
- Пример: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Лос-Анджелес
Идентификатор места (place_id)
- Однозначный строковый идентификатор (идентификатор места в Google Maps).
- Идентификатор места (place_id) можно получить с помощью инструмента search_places.
- Пример: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Эйфелева башня
Адресная строка (адрес)
- Строка произвольной формы, требующая конкретизации для геокодирования.
- Город и регион: Всегда указывайте регион/страну (например, "Лондон, Великобритания", а не "Лондон").
- Адрес: Укажите полный адрес (например, "1600 Pennsylvania Ave NW, Washington, DC").
- Почтовые индексы: ОБЯЗАТЕЛЬНО должны сопровождаться названием страны (например, "90210, США", а НЕ "90210").
- Пример: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}
Режимы использования:
Текущая погода: Укажите только
location. Не указывайтеdateиhour.Почасовой прогноз: укажите
location,dateиhour(0-23). Используйте для конкретных временных промежутков (например, «в 17:00») или для терминов типа «в ближайшие несколько часов» или «позже сегодня». Если пользователь указывает минуты, округлите до ближайшего часа в меньшую сторону. Почасовой прогноз на период более 120 часов вперед не поддерживается. Исторические почасовые прогнозы погоды поддерживаются на период до 24 часов назад.Ежедневный прогноз: укажите
locationиdate. Не указывайтеhour. Используйте для общих запросов на день (например, «погода на завтра», «погода в пятницу», «погода 25 декабря»). Если сегодняшняя дата отсутствует в контексте, следует уточнить это у пользователя. Ежедневный прогноз на период более 10 дней, включая сегодняшний день, не поддерживается. Исторические данные о погоде не поддерживаются.
Ограничения параметров:
- Часовые пояса: Все введенные
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 tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Схема ввода
Запрос метода LookupWeather — отображает погодные условия в запрошенном месте.
LookupWeatherRequest
| JSON-представление |
|---|
{ "unitsSystem": enum ( |
| Поля | |
|---|---|
unitsSystem | Необязательный параметр. Система единиц измерения, используемая для возвращаемых погодных условий. Если не указана, возвращаемые погодные условия будут представлены в метрической системе (по умолчанию = МЕТРИЧЕСКАЯ). |
location | Обязательно. Место, для которого необходимо получить информацию о погоде. |
Объединенное поле | |
date | Необязательно. Дата получения необходимой информации о погоде. Примечание: Эта дата указывается относительно местного часового пояса местоположения, указанного в поле местоположения. Дата должна находиться в диапазоне от 24 часов назад до 10 дней в будущем. |
Union field | |
hour | Необязательно. Время запроса информации о погоде в 24-часовом формате (0-23). Это значение указывается относительно местного часового пояса местоположения, указанного в поле местоположения. Почасовой прогноз на период более 120 часов не поддерживается. Исторические почасовые данные о погоде поддерживаются за период до 24 часов назад. |
Дата
| JSON-представление |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Поля | |
|---|---|
year | Год даты. Должен быть от 1 до 9999, или 0, чтобы указать дату без года. |
month | Месяц года. Должен быть от 1 до 12, или 0, чтобы указать год без месяца и дня. |
day | День месяца. Должен быть от 1 до 31 и соответствовать году и месяцу, или 0, чтобы указать только год или год и месяц, где день не имеет значения. |
Расположение
| JSON-представление |
|---|
{ // Union field |
| Поля | |
|---|---|
Поле объединения location_type . Различные способы представления местоположения. location_type может принимать только одно из следующих значений: | |
latLng | Точка, заданная с использованием географических координат. |
placeId | Идентификатор места, связанный с данным местоположением. |
address | Адрес в удобочитаемом виде или код «плюс». Подробности см. на сайте https://plus.codes . |
LatLng
| JSON-представление |
|---|
{ "latitude": number, "longitude": number } |
| Поля | |
|---|---|
latitude | Широта в градусах. Она должна находиться в диапазоне [-90,0, +90,0]. |
longitude | Долгота в градусах. Она должна находиться в диапазоне [-180,0, +180,0]. |
Система единиц
Представляет собой систему единиц измерения, используемую для определения величин.
| Перечисления | |
|---|---|
UNITS_SYSTEM_UNSPECIFIED | Система единиц измерения не указана. |
IMPERIAL | Имперская система единиц измерения (например, градусы Фаренгейта, мили и т. д.). |
METRIC | Метрическая система единиц (например, градусы Цельсия, километры и т. д.). |
Схема вывода
Ответ на RPC-запрос LookupWeather — отображает погодные условия в запрошенном месте.
Этот ответ содержит как почасовую, так и суточную информацию, поэтому он разделен на три раздела: почасовой, суточный и общий. Поля, содержащие только почасовую и только суточную информацию, помечены как необязательные. Для полей, общих для почасовой и суточной информации, некоторые из них присутствуют всегда и не помечены как необязательные, а остальные помечены как необязательные, поскольку они доступны не всегда.
LookupWeatherResponse
| JSON-представление |
|---|
{ "weatherCondition": { object ( |
| Поля | |
|---|---|
weatherCondition | Погодные условия |
precipitation | Вероятность выпадения осадков и количество выпавших осадков. |
wind | Ветровые условия |
returnedLocation | Обязательно. Местоположение, куда возвращается информация о погоде. Это местоположение идентично местоположению в запросе, но может отличаться, если запрашиваемое местоположение представляет собой произвольный текстовый адрес, указывающий на приблизительное местоположение (например, «Маунтин-Вью, Калифорния»). |
attribution | Необходимо указать источник информации, чтобы она отображалась вместе с погодными условиями. |
Объединенное поле | |
temperature | Почасовая температура |
Поле объединения | |
feelsLikeTemperature | Почасовая оценка того, как ощущается температура. |
Объединенное поле | |
heatIndex | Почасовой индекс тепловой нагрузки. |
Объединенное поле | |
airPressure | Почасовые данные об атмосферном давлении. |
Объединенное поле | |
maxTemperature | Максимальная (высокая) температура в течение дня. |
Объединенное поле | |
minTemperature | Минимальная (низкая) температура в течение дня. |
Поле объединения | |
feelsLikeMaxTemperature | Максимальная (высокая) ощущаемая температура в течение дня. |
Поле объединения | |
feelsLikeMinTemperature | Минимальная (низкая) ощущаемая температура в течение дня. |
Объединенное поле | |
maxHeatIndex | Максимальная температура по индексу жары в течение дня. |
Union field | |
sunEvents | События, связанные с солнцем (например, восход, закат). |
Объединенное поле | |
moonEvents | События, связанные с Луной (например, восход и закат Луны). |
Объединенное поле | |
relativeHumidity | Процент относительной влажности (значения от 0 до 100). Это необязательный параметр, поскольку он доступен не всегда. |
Объединенное поле | |
uvIndex | Максимальный ультрафиолетовый (УФ) индекс. Это необязательный параметр, поскольку он доступен не всегда. |
Объединенное поле | |
thunderstormProbability | Вероятность грозы (значения от 0 до 100). Это необязательный параметр, поскольку он доступен не всегда. |
Объединенное поле | |
cloudCover | Процент облачности на небе (значения от 0 до 100). Это необязательный параметр, поскольку он доступен не всегда. |
Температура
| JSON-представление |
|---|
{ "unit": enum ( |
| Поля | |
|---|---|
unit | Код единицы измерения, используемой для определения значения температуры. |
Объединенное поле | |
degrees | Значение температуры (в градусах) в указанной единице измерения. |
Давление воздуха
| JSON-представление |
|---|
{ // Union field |
| Поля | |
|---|---|
Объединенное поле | |
meanSeaLevelMillibars | Среднее атмосферное давление на уровне моря в миллибарах. |
SunEvents
| JSON-представление |
|---|
{ "sunriseTime": string, "sunsetTime": string } |
| Поля | |
|---|---|
sunriseTime | Время восхода солнца. ПРИМЕЧАНИЕ: В некоторых уникальных случаях (например, к северу от Полярного круга) время восхода солнца в течение дня может отсутствовать. В таких случаях это поле будет пустым. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
sunsetTime | Время захода солнца. ПРИМЕЧАНИЕ: В некоторых уникальных случаях (например, к северу от Полярного круга) время захода солнца в течение дня может отсутствовать. В таких случаях это поле будет пустым. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
Отметка времени
| JSON-представление |
|---|
{ "seconds": string, "nanos": integer } |
| Поля | |
|---|---|
seconds | Обозначает количество секунд UTC-времени с начала эпохи Unix 1970-01-01T00:00:00Z. Должно находиться в диапазоне от -62135596800 до 253402300799 включительно (что соответствует периоду с 0001-01-01T00:00:00Z по 9999-12-31T23:59:59Z). |
nanos | Неотрицательные доли секунды с разрешением в наносекунды. Это поле представляет собой наносекундную часть длительности, а не альтернативу секундам. Отрицательные значения секунд с дробными долями должны по-прежнему иметь неотрицательные значения в наносекундах, отсчитываемые вперед во времени. Должны быть в диапазоне от 0 до 999 999 999 включительно. |
MoonEvents
| JSON-представление |
|---|
{
"moonriseTimes": [
string
],
"moonsetTimes": [
string
],
"moonPhase": enum ( |
| Поля | |
|---|---|
moonriseTimes[] | Время, когда верхний край Луны появляется над горизонтом (см. https://en.wikipedia.org/wiki/Moonrise_and_moonset) . ПРИМЕЧАНИЕ: В большинстве случаев в течение дня будет указано только одно время восхода луны. В других случаях список может быть пустым (например, если луна восходит после полуночи следующего дня). Однако в уникальных случаях (например, в полярных регионах) список может содержать более одного значения. В этих случаях значения сортируются в порядке возрастания. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
moonsetTimes[] | Время, когда верхний край Луны скрывается за горизонтом (см. https://en.wikipedia.org/wiki/Moonrise_and_moonset) . ПРИМЕЧАНИЕ: В большинстве случаев в течение дня будет указано только одно время захода Луны. В других случаях список может быть пустым (например, если Луна заходит после полуночи следующего дня). Однако в уникальных случаях (например, в полярных регионах) список может содержать более одного значения. В этих случаях значения сортируются в порядке возрастания. Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
moonPhase | Фаза Луны (или лунная фаза). |
Погодные условия
| JSON-представление |
|---|
{ "iconBaseUri": string, "description": { object ( |
| Поля | |
|---|---|
iconBaseUri | Базовый URI для значка, не включающий расширение файла. Чтобы отобразить значок, при желании добавьте тему оформления и расширение файла ( |
description | Текстовое описание данного погодного явления (локальное). |
type | Тип погодных условий. |
Локализованный текст
| JSON-представление |
|---|
{ "text": string, "languageCode": string } |
| Поля | |
|---|---|
text | Локализованная строка на языке, соответствующем значению |
languageCode | Языковой код текста в системе BCP-47, например, "en-US" или "sr-Latn". Для получения дополнительной информации см. http://www.unicode.org/reports/tr35/#Unicode_locale_identifier . |
Осадки
| JSON-представление |
|---|
{ "probability": { object ( |
| Поля | |
|---|---|
probability | Вероятность выпадения осадков (значения от 0 до 100). |
snowQpf | Количество снега, измеренное в эквиваленте жидкой воды, накопившееся за определенный период времени. Примечание: QPF — это аббревиатура от Quantitative Precipitation Forecast (подробнее см. определение QuantitativePrecipitationForecast). |
qpf | Количество осадков в виде дождя, измеренное в эквиваленте жидкой воды, накопившееся за определенный период времени. Примечание: QPF — это аббревиатура от Quantitative Precipitation Forecast (подробнее см. определение QuantitativePrecipitationForecast). |
Вероятность осадков
| JSON-представление |
|---|
{ "type": enum ( |
| Поля | |
|---|---|
type | Код, указывающий на тип осадков. |
| |
percent | Процентное значение от 0 до 100, указывающее на вероятность осадков. |
Количественный прогноз осадков
| JSON-представление |
|---|
{ "unit": enum ( |
| Поля | |
|---|---|
unit | Код единицы измерения, используемой для определения количества накопленных осадков. |
Объединенное поле | |
quantity | Количество осадков, измеренное в эквиваленте жидкой воды, накопившееся за определенный период времени. |
Ветер
| JSON-представление |
|---|
{ "direction": { object ( |
| Поля | |
|---|---|
direction | Направление ветра, угол его дуновения. |
speed | Скорость ветра. |
gust | Порыв ветра (внезапное увеличение скорости ветра). |
Направление ветра
| JSON-представление |
|---|
{ "cardinal": enum ( |
| Поля | |
|---|---|
cardinal | Код, обозначающий основное направление ветра. |
Объединенное поле | |
degrees | Направление ветра в градусах (значения от 0 до 360). |
Скорость ветра
| JSON-представление |
|---|
{ "unit": enum ( |
| Поля | |
|---|---|
unit | Код, обозначающий единицу измерения скорости ветра. |
Объединенное поле | |
value | Значение скорости ветра. |
Расположение
| JSON-представление |
|---|
{ // Union field |
| Поля | |
|---|---|
Поле объединения location_type . Различные способы представления местоположения. location_type может принимать только одно из следующих значений: | |
latLng | Точка, заданная с использованием географических координат. |
placeId | Идентификатор места, связанный с данным местоположением. |
address | Адрес в удобочитаемом виде или код «плюс». Подробности см. на сайте https://plus.codes . |
LatLng
| JSON-представление |
|---|
{ "latitude": number, "longitude": number } |
| Поля | |
|---|---|
latitude | Широта в градусах. Она должна находиться в диапазоне [-90,0, +90,0]. |
longitude | Долгота в градусах. Она должна находиться в диапазоне [-180,0, +180,0]. |
Атрибуция
| JSON-представление |
|---|
{ "title": string, "url": string } |
| Поля | |
|---|---|
title | Заголовок, отображаемый для указания авторства. |
url | 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%, а в южном полушарии 🌖 — на 50-100%. |
FULL_MOON | Луна полностью освещена. |
WANING_GIBBOUS | В северном полушарии 🌖 левая сторона Луны освещена на 50-100%, а в южном полушарии 🌔 — на 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 | Количество осадков измеряется в дюймах. |
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 | Скорость измеряется в милях в час. |
Аннотации инструментов
Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ❌ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌