MCP Tools Reference: mapstools.googleapis.com

Инструмент: lookup_weather

Получает подробные данные об окружающей среде для местоположения, включая погоду, качество воздуха (ИКВ и загрязнители) и пыльцу (уровни аллергенов деревьев, трав, сорняков и видов растений): текущие условия, почасовые прогнозы/историю и ежедневные прогнозы погоды и качества воздуха; Пыльца – это только ежедневный прогноз (с сегодняшнего дня по +4 дня, без почасовых или прошлых данных). Доступные домены и возможности среды (capabilities: WEATHER, AIR_QUALITY, POLLEN – КРИТИЧЕСКИ ВАЖНО): * Обязательный явный выбор: вы ДОЛЖНЫ включить хотя бы один из параметров WEATHER, AIR_QUALITY или POLLEN в capabilities при каждом вызове. Пропускать capabilities НЕЛЬЗЯ. * Широкие или неоднозначные запросы о погоде на улице (полный набор данных). Если пользователь задает общий вопрос о погоде на улице, путешествиях или ситуации, не ограничиваясь определенной областью (например, "Какая сейчас погода на улице для пробежки?"), явно включите все три функции (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]), чтобы вернуть полный набор данных о погоде на улице (погода + качество воздуха + пыльца). Для прошлых date/hour исключите POLLEN, у которого нет истории. * Выбор целевого домена (конкретные запросы). Если пользователь запрашивает информацию только по одному или двум доменам (например, "Какой сейчас ИКВ в Сиэтле?"), включите только запрошенные функции (WEATHER, AIR_QUALITY и/или POLLEN). Будут выполнены и возвращены только запрошенные домены. Доступные данные по доменам: * Погода (weather): температура (текущая, ощущаемая, максимальная/минимальная, тепловой индекс), ветер (скорость, порывы, направление), астрономические события (восход/закат, фаза луны), осадки (тип, вероятность, количество/QPF) и атмосферные условия (УФ-индекс, влажность, облачность, вероятность грозы, атмосферное давление). * Качество воздуха (air_quality). Универсальный и местный индексы качества воздуха (значение, категория, доминирующий загрязнитель), рекомендации по охране здоровья для семи групп чувствительности и концентрация загрязнителей (include_pollutant_concentration: true). У каждого индекса свой доминирующий загрязнитель. Указывайте его для каждого индекса (например, не указывайте загрязнитель универсального индекса для индекса США). * Пыльца (pollen). Ежедневный универсальный индекс пыльцы (UPI, 0–5) по категориям деревьев, трав и сорняков и по видам растений (index.value с его index.category, например 1 = "Очень низкий"), статус сезона, перекрестные реакции и рекомендации по здоровью. * Отсутствующие поля пыльцы. Отсутствие in_season означает, что сезон не наступил. Не упоминай виды растений, для которых не указан index, если только пользователь не спросит о них. В этом случае скажи, что данных о пыльце этих растений на сегодня нет (не пытайся угадать уровень). Правила в отношении местоположения (ВАЖНО). Целевое местоположение ДОЛЖНО быть указано в location с использованием ТОЛЬКО ОДНОГО из следующих подполей oneof: 1. Географические координаты (lat_lng). Используйте, если известны точные координаты широты и долготы. * Пример: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. Идентификатор места (place_id): * Однозначный идентификатор места на Google Картах (например, полученный из search_places или resolve_names). * Пример: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. Строка адреса (address). Город, регион, район, достопримечательность, почтовый адрес или почтовый индекс. Желательно также указать город и страну. * Пример: {"location": {"address": "Paris, France"}} Режимы времени и использования (date и hour – КРИТИЧЕСКИ ВАЖНО): * Ссылка на местный часовой пояс: все входные данные date ({year, month, day}) и hour (0-23) ДОЛЖНЫ быть выражены в местном гражданском часовом поясе запрашиваемого location (например, в запросе для "Paris tomorrow at 13:00" используется местная дата Europe/Paris и час 13), а не в UTC или часовом поясе вызывающего абонента. * 1. Текущие условия (date и hour не указаны): * Укажите location и целевую capabilities (WEATHER, AIR_QUALITY, POLLEN). НЕ указывайте date или hour. * Возвращает текущие условия в реальном времени (CC) для запрошенных доменов (текущая погода, качество воздуха за текущий час и/или прогноз пыльцы на сегодня). * Для качества воздуха текущие условия – это один час. НЕ используйте только их, чтобы ответить на вопросы о качестве воздуха или общих условиях на улице за сегодня в целом (используйте ежедневные запросы ниже). * 2. Почасовой прогноз/история (указаны date и hour 0-23): * Укажите location, date ({year, month, day}), hour (0-23) и целевой capabilities. Если указаны минуты, округлите значение до ближайшего часа в меньшую сторону. * КРИТИЧЕСКОЕ ОГРАНИЧЕНИЕ (если задано значение hour, то date ОБЯЗАТЕЛЬНО): указывать hour без date (date опущено, hour задано) НЕЛЬЗЯ. Это приведет к ошибке. Даже если пользователь спрашивает о конкретном часе сегодня (например, "at 13:00 today"), вы ДОЛЖНЫ заполнить и date (сегодняшняя дата в location), и hour. * Выполняет ежечасный поиск запрашиваемых данных о погоде и/или качестве воздуха в YYYY-MM-DD-HH и ежедневный поиск запрашиваемых данных о пыльце в YYYY-MM-DD. * Вопросы о погоде, содержащие слово "когда". Если в вопросе о погоде есть слова когда, в какое время, лучшее время (например, "what time will it stop raining?"), используйте почасовые вызовы WEATHER (date + hour) для соответствующих часов. В ежедневном прогнозе погоды нет почасовых значений. Для общих вопросов о погоде на улице, содержащих слова "когда" или "лучшее время" (например, "when is the best time to go walking today?"), в дополнение к вызову данных о качестве воздуха (и пыльце) за весь день, описанному в разделе "Ежедневные запросы", выполняйте почасовые вызовы WEATHER. * 3. Ежедневные запросы (указан параметр date, а параметр hour опущен): * Чтобы получить данные за весь день, укажите location, date ({year, month, day} по местному гражданскому времени в запрашиваемом location) без hour и целевой capabilities (например, "weather and pollen in London tomorrow"). * Запросы о качестве воздуха и общие вопросы о погоде на сегодня. Чтобы получить почасовые данные о качестве воздуха и общие сведения о погоде (включая качество воздуха) на сегодня (например, "how will the air quality change today", "is today a good day for a picnic?"), задайте для параметра date значение сегодняшняя дата в location (без указания часа). Вызова Current Conditions недостаточно, так как он возвращает только данные о качестве воздуха за текущий час. Вы можете добавить его, если пользователь также спрашивает о текущем моменте. * Временные интервалы для качества воздуха. Если запрос касается качества воздуха в определенный интервал времени в течение одного дня (например, "air quality between noon and 6 PM"), лучше сделать один вызов Daily для этой даты и прочитать часы интервала из серии Air Quality, а не запрашивать данные для отдельных часов. Если вы используете почасовые вызовы, охватите каждый час окна. * Возвращает ежедневные прогнозы для запрошенных данных о погоде и/или пыльце, а также почасовые данные о качестве воздуха за весь местный день (00:00–23:00 по местному времени): 24 часа истории для прошедшей даты, 24 часа прогноза для будущей даты, а для сегодняшнего дня – более ранние часы (история), текущий час и оставшиеся часы (прогноз). Поддерживаемые временные горизонты по доменам: * Погода. Почасовой прогноз за последние 24 часа и на следующие 240 часов (10 дней). Для прошедших часов требуются и date, и hour. Ежедневный прогноз на 10 дней, включая сегодняшний (сегодня и следующие 9 дней). Ежедневная история не поддерживается. * Качество воздуха. Почасовые данные за период от 720 часов (30 дней) назад до 96 часов (4 дней) вперед. Запрос за полный день должен укладываться в этот диапазон (на практике – от −29 до +3 дней). * Пыльца. Только ежедневные данные, с сегодняшнего дня по +4 дня (5 дней, включая сегодняшний). Прошедшие даты не поддерживаются, а параметр hour игнорируется. * Примечание. Если запрашивается несколько возможностей, а значение date/hour выходит за пределы одного из диапазонов, вызов все равно выполняется и возвращает только поддерживаемые возможности. * Запросы за пределами диапазона. Если запрашиваемая дата или час могут быть за пределами поддерживаемого диапазона домена, указанного выше (например, пыльца за прошедшую дату), все равно вызовите lookup_weather для запрашиваемой даты или часа. В ошибке будет указан поддерживаемый диапазон. Не заменяйте их другими датами, часами или доменами. Настройки домена и атрибуция: * Язык (language_code): необязательный код языка BCP-47 (например, "fr"). По умолчанию используется "en". * Единицы измерения погоды (weather_options.units_system или units_system). По умолчанию используется METRIC. Установите значение IMPERIAL (градусы Фаренгейта/мили в час), если пользователь подразумевает стандарты США или явно запрашивает имперские единицы измерения. Поддерживается как в weather_options.units_system (предпочтительно), так и в units_system верхнего уровня. Если указаны оба, они не должны конфликтовать. * Параметры качества воздуха (air_quality_options). Задайте include_pollutant_concentration: true, если вам нужны данные о концентрации определенных загрязнителей (PM2.5, PM10, O3, NO2, SO2, CO). При необходимости задайте index_region_code (двухбуквенный код страны по стандарту ISO, например "US"), чтобы запросить данные по определенной региональной шкале ИКВ. По умолчанию ответ включает универсальный ИКВ и региональный ИКВ для местоположения. * Атрибуция. Обоснованные выходные данные ДОЛЖНЫ быть соотнесены с источником с помощью поля attribution внутри каждого возвращенного контейнера домена (weather.attribution, air_quality.attribution, pollen.attribution). * Возвращенное время. Значения date_time качества воздуха уже указаны по местному времени (включая utc_offset). Представляйте их как есть. Значения date_time погоды (текущей и почасовой) и времени восхода/заката указаны по UTC. Преобразуйте их в местное время с помощью time_zone. Укажите, что время местное.

В примере кода ниже показано, как использовать 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)
  },
  "capabilities": [
    enum (Capability)
  ],

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

  // Union field _language_code can be only one of the following:
  "languageCode": string
  // End of list of possible types for union field _language_code.

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

  // Union field _air_quality_options can be only one of the following:
  "airQualityOptions": {
    object (AirQualityOptions)
  }
  // End of list of possible types for union field _air_quality_options.
}
Поля
unitsSystem

enum (UnitsSystem)

Необязательное поле. Система единиц измерения, которая будет использоваться для возвращаемых погодных условий. Если не указать, то по умолчанию будет использоваться метрическая система.
location

object (Location)

Обязательно. Местоположение, для которого нужно получить прогноз погоды.
capabilities[]

enum (Capability)

Необязательное поле. Возможности среды, которые нужно включить в ответ.

Объединенное поле _date.

Поле _date может иметь одно из следующих значений:
date

object (Date)

Необязательное поле. Указывает дату, за которую запрашивается информация об окружающей среде, в соответствии с местным часовым поясом местоположения, указанного в поле location. Поддерживаемые диапазоны дат зависят от запрашиваемых возможностей: - WEATHER: до 24 часов в прошлом (если также задано hour) и до 10 дней (240 часов) в будущем (с сегодняшнего дня до +9 дней для ежедневных прогнозов). - AIR_QUALITY: до 30 дней (720 часов) в прошлом и до 4 дней (96 часов) в будущем. - POLLEN: от сегодняшнего дня до +4 дней (до 5 дней, включая сегодняшний; прошедшие даты не поддерживаются).

Объединенное поле _hour.

Поле _hour может иметь одно из следующих значений:
hour

integer

Необязательное поле. Указывает час, за который запрашивается информация об окружающей среде, в 24-часовом формате (0–23) относительно местного часового пояса местоположения, указанного в поле location. Требуется указать date. Поддерживаемые почасовые диапазоны зависят от запрашиваемых возможностей: - WEATHER: до 24 часов в прошлом и до 240 часов (10 дней) в будущем. - AIR_QUALITY: до 30 дней (720 часов) в прошлом и до 4 дней (96 часов) в будущем. - POLLEN: возвращает только ежедневные прогнозы; hour игнорируется для пыльцы.

Объединенное поле _language_code.

Поле _language_code может иметь одно из следующих значений:
languageCode

string

Необязательное поле. Код языка по стандарту BCP-47 для локализованного текста в ответе (например, "ru", "ja", "fr-CA"). Если не указано, по умолчанию используется "en".

Объединенное поле _weather_options.

Поле _weather_options может иметь одно из следующих значений:
weatherOptions

object (WeatherOptions)

Необязательное поле. Параметры, относящиеся к запросам о погоде. weather_options.units_system поддерживается вместе с units_system верхнего уровня (тег 4) для обеспечения обратной совместимости с существующими вызывающими объектами. Если обе системы единиц измерения конфликтуют, возвращается INVALID_ARGUMENT. Игнорируется, если параметр WEATHER не запрашивается в capabilities.

Объединенное поле _air_quality_options.

Поле _air_quality_options может иметь одно из следующих значений:
airQualityOptions

object (AirQualityOptions)

Необязательное поле. Параметры, относящиеся к запросам качества воздуха. Игнорируется, если параметр AIR_QUALITY не запрашивается в capabilities.

Дата

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год. Должно быть от 1 до 9999 или 0, чтобы указать дату без года.
month

integer

Месяц года. Значение должно быть от 1 до 12 или 0, если нужно указать год без месяца и дня.
day

integer

День месяца. Должно быть от 1 до 31 и соответствовать году и месяцу или быть равно 0, чтобы указать только год или год и месяц, если день не важен.

Местоположение

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

Человекочитаемый адрес (например, почтовый адрес, город или почтовый индекс).

LatLng

JSON-представление 
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Градусная мера широты. Должна попадать в диапазон [-90.0, +90.0].
longitude

number

Градусная мера долготы. Должна попадать в диапазон [-180,0, +180,0].

WeatherOptions

JSON-представление 
{
  "unitsSystem": enum (UnitsSystem)
}
Поля
unitsSystem

enum (UnitsSystem)

Необязательное поле. Система единиц измерения, которая будет использоваться для возвращаемых погодных условий. Если не указать, то по умолчанию будет использоваться метрическая система.

AirQualityOptions

JSON-представление 
{

  // Union field _include_pollutant_concentration can be only one of the
  // following:
  "includePollutantConcentration": boolean
  // End of list of possible types for union field
  // _include_pollutant_concentration.

  // Union field _index_region_code can be only one of the following:
  "indexRegionCode": string
  // End of list of possible types for union field _index_region_code.
}
Поля

Объединенное поле _include_pollutant_concentration.

Поле _include_pollutant_concentration может иметь одно из следующих значений:
includePollutantConcentration

boolean

Необязательное поле. Если задано значение true, в ответ о качестве воздуха включаются подробные данные о концентрации загрязняющих веществ и дополнительная информация (источники и последствия).

Объединенное поле _index_region_code.

Поле _index_region_code может иметь одно из следующих значений:
indexRegionCode

string

Необязательное поле. Двухбуквенный код страны или региона по стандарту ISO 3166-1 alpha-2 (например, "US", "FR", "CN"), который используется для выбора предпочтительной шкалы местного индекса качества воздуха (AQI) наряду с универсальным индексом качества воздуха (UAQI). Если не указан, по умолчанию используется регион запрашиваемого местоположения.

UnitsSystem

Система единиц измерения, используемая для значений.

Перечисления
UNITS_SYSTEM_UNSPECIFIED Система единиц измерения не указана.
IMPERIAL Имперская система мер (например, градусы Фаренгейта, мили и т.д.).
METRIC Метрическая система (например, градусы Цельсия, километры и т.д.).

Возможности

Возможности среды, которые можно запросить в LookupWeatherRequest.

Перечисления
CAPABILITY_UNSPECIFIED Неизвестная функция.
WEATHER Погодные условия (температура, осадки, ветер, УФ-индекс и т. д.).
AIR_QUALITY Информация о качестве воздуха (индекс качества воздуха, загрязнители и рекомендации по охране здоровья).
POLLEN Информация о пыльце (уровень аллергенов в пыльце деревьев, трав, сорняков и других растений).

Схема вывода

Ответ на запрос LookupWeather RPC – представляет погодные условия в запрашиваемом местоположении.

В этом ответе есть информация за час и за день, поэтому он разделен на три раздела: "Почасовой", "Ежедневный" и "Общий". Поля Only-Hourly и Only-Daily помечены как необязательные. Некоторые поля, которые есть и в почасовых, и в ежедневных отчетах, присутствуют всегда, поэтому они не помечены как необязательные. Остальные поля помечены как необязательные, поскольку они не всегда доступны.

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.

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

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

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

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.
}
Поля
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

Относительная влажность в процентах (значения от 0 до 100).

Объединенное поле _uv_index.

Поле _uv_index может иметь одно из следующих значений:
uvIndex

integer

Максимальный УФ-индекс.

Объединенное поле _thunderstorm_probability.

Поле _thunderstorm_probability может иметь одно из следующих значений:
thunderstormProbability

integer

Вероятность грозы (значения от 0 до 100).

Объединенное поле _cloud_cover.

Поле _cloud_cover может иметь одно из следующих значений:
cloudCover

integer

Процент неба, покрытый облаками (значения от 0 до 100).

Объединенное поле _weather.

Поле _weather может иметь одно из следующих значений:
weather

object (WeatherResultData)

Погодные условия в запрошенном местоположении.

Объединенное поле _air_quality.

Поле _air_quality может иметь одно из следующих значений:
airQuality

object (AirQualityResultData)

Информация о качестве воздуха в указанном местоположении.

Объединенное поле _pollen.

Поле _pollen может иметь одно из следующих значений:
pollen

object (PollenResultData)

Информация о пыльце в указанном местоположении.

Объединенное поле _time_zone.

Поле _time_zone может иметь одно из следующих значений:
timeZone

string

Строка часового пояса IANA для местоположения (например, "America/New_York", "Asia/Tokyo").

Температура

JSON-представление 
{
  "unit": enum (Unit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
Поля
unit

enum (Unit)

Необязательное поле. Код единицы измерения температуры.

Объединенное поле _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-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "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-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "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 с начала эпохи Unix (1970-01-01T00:00:00Z). Значение должно быть в диапазоне от -62135596800 до 253402300799 включительно (что соответствует периоду с 0001-01-01T00:00:00Z до 9999-12-31T23:59:59Z).
nanos

integer

Доля секунды в наносекундах. Это поле содержит наносекундную часть продолжительности, а не альтернативу секундам. Свойство может принимать только неотрицательное целочисленное значение, даже если значение временной отметки в секундах является отрицательным. Значение должно быть в диапазоне от 0 до 999 999 999 включительно.

MoonEvents

JSON-представление 
{
  "moonPhase": enum (Phase),
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ]
}
Поля
moonPhase

enum (Phase)

Необязательное поле. Фаза Луны.
moonriseTimes[]

string (Timestamp format)

Время, когда верхний край Луны появляется над горизонтом (см. https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

ПРИМЕЧАНИЕ. В большинстве случаев луна восходит один раз в день. В некоторых случаях список может быть пустым (например, если луна взойдет после полуночи следующего дня). Однако в некоторых случаях (например, в полярных регионах) список может содержать несколько значений. В таких случаях значения сортируются по возрастанию.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "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-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

WeatherCondition

JSON-представление 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Поля
iconBaseUri

string

Базовый URI значка без расширения типа файла. Чтобы показать значок, добавьте к этому 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, например "ru-RU" или "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 – это аббревиатура от Quantitative Precipitation Forecast (количественный прогноз осадков). Подробную информацию вы найдете в определении QuantitativePrecipitationForecast.
qpf

object (QuantitativePrecipitationForecast)

Количество осадков, измеренное в эквиваленте жидкой воды, которое выпало за определенный период времени. Примечание. QPF – это аббревиатура от Quantitative Precipitation Forecast (количественный прогноз осадков). Подробную информацию вы найдете в определении QuantitativePrecipitationForecast.

PrecipitationProbability

JSON-представление 
{
  "type": enum (Type),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
Поля
type

enum (Type)

Необязательное поле. Код, указывающий на тип осадков.

Объединенное поле _percent.

Поле _percent может иметь одно из следующих значений:
percent

integer

Вероятность осадков в процентах (от 0 до 100).

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 (Cardinal),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
Поля
cardinal

enum (Cardinal)

Необязательное поле. Код, обозначающий сторону света, откуда дует ветер.

Объединенное поле _degrees.

Поле _degrees может иметь одно из следующих значений:
degrees

integer

Направление ветра в градусах (значения от 0 до 360).

WindSpeed

JSON-представление 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Поля
unit

enum (Unit)

Необязательное поле. Код, представляющий единицу измерения скорости ветра.

Объединенное поле _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

Человекочитаемый адрес (например, почтовый адрес, город или почтовый индекс).

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

URL, на который ведет ссылка в атрибуции.

WeatherResultData

JSON-представление 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _date_time can be only one of the following:
  "dateTime": string
  // End of list of possible types for union field _date_time.

  // 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 _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // 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)

Ветер.
attribution

object (Attribution)

Обязательная атрибуция, которая показывается вместе с погодой.

Объединенное поле _date_time.

Поле _date_time может иметь одно из следующих значений:
dateTime

string (Timestamp format)

Временная метка для этой записи о текущей погоде или погоде на час.

Используется формат RFC 3339. Результат всегда будет Z-нормализованным, и в нем будут использоваться цифры дробных частей 0, 3, 6 или 9. Допустимы и другие типы нормализации. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30".

Объединенное поле _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)

Почасовые данные об атмосферном давлении.

Объединенное поле _date.

Поле _date может иметь одно из следующих значений:
date

object (Date)

Дата ежедневного прогноза погоды по гражданскому календарю.

Объединенное поле _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

Относительная влажность в процентах (значения от 0 до 100).

Объединенное поле _uv_index.

Поле _uv_index может иметь одно из следующих значений:
uvIndex

integer

Максимальный УФ-индекс.

Объединенное поле _thunderstorm_probability.

Поле _thunderstorm_probability может иметь одно из следующих значений:
thunderstormProbability

integer

Вероятность грозы (значения от 0 до 100).

Объединенное поле _cloud_cover.

Поле _cloud_cover может иметь одно из следующих значений:
cloudCover

integer

Процент неба, покрытый облаками (значения от 0 до 100).

Дата

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Поля
year

integer

Год. Должно быть от 1 до 9999 или 0, чтобы указать дату без года.
month

integer

Месяц года. Значение должно быть от 1 до 12 или 0, если нужно указать год без месяца и дня.
day

integer

День месяца. Должно быть от 1 до 31 и соответствовать году и месяцу или быть равно 0, чтобы указать только год или год и месяц, если день не важен.

AirQualityResultData

JSON-представление 
{
  "hourlyResults": [
    {
      object (AirQualityHourlyResult)
    }
  ],
  "attribution": {
    object (Attribution)
  }
}
Поля
hourlyResults[]

object (AirQualityHourlyResult)

Почасовые данные о качестве воздуха за запрошенное время (содержат одну запись для текущих условий или запросов за один час, до 24 записей для запроса только по дате в прошлом или будущем или текущие + оставшиеся часы, если дата – сегодня).
attribution

object (Attribution)

Обязательная атрибуция, которая должна показываться вместе с данными о качестве воздуха.

AirQualityHourlyResult

JSON-представление 
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
Поля
indexes[]

object (AirQualityIndex)

Индексы качества воздуха (например, универсальный и местный).
pollutants[]

object (Pollutant)

Подробная информация о загрязнителях, которая заполняется, если для параметра air_quality_options.include_pollutant_concentration задано значение true.
healthRecommendations

object (HealthRecommendations)

Рекомендации по охране здоровья для разных групп населения.
dateTime

object (DateTime)

Местные дата и время в часовом поясе местоположения для этой почасовой записи о качестве воздуха (состоит из year, month, day, hours, minutes, seconds и utc_offset).

AirQualityIndex

JSON-представление 
{
  "displayName": string,
  "valueDisplay": string,
  "category": string,
  "dominantPollutant": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Поля
displayName

string

Отображаемое название индекса, например "Универсальный ИКВ" или "ИКВ Агентства по охране окружающей среды США".
valueDisplay

string

Форматированное строковое представление значения ИКВ.
category

string

Текстовое описание категории качества воздуха, например "Хорошее качество воздуха" или "Среднее качество воздуха".
dominantPollutant

string

Код преобладающего загрязнителя (например, "pm25", "o3").

Объединенное поле _value.

Поле _value может иметь одно из следующих значений:
value

integer

Числовое значение ИКВ.

Загрязняющее вещество

JSON-представление 
{
  "displayName": string,
  "fullName": string,
  "concentration": {
    object (Concentration)
  },
  "additionalInfo": {
    object (AdditionalInfo)
  }
}
Поля
displayName

string

Краткое отображаемое название загрязнителя, например PM2.5 или O3.
fullName

string

Полное химическое или общепринятое название загрязнителя, например "Мелкие твердые частицы (< 2,5 мкм)" или "Озон".
concentration

object (Concentration)

Измеренная концентрация загрязнителя.
additionalInfo

object (AdditionalInfo)

Дополнительная информация об источниках загрязнителя и его влиянии на здоровье.

Концентрация

JSON-представление 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Поля
unit

enum (Unit)

Единица измерения концентрации.

Объединенное поле _value.

Поле _value может иметь одно из следующих значений:
value

number

Числовое значение концентрации.

AdditionalInfo

JSON-представление 
{
  "sources": string,
  "effects": string
}
Поля
sources

string

Основные источники выбросов загрязняющего вещества.
effects

string

Возможные последствия для здоровья от воздействия загрязнителя.

HealthRecommendations

JSON-представление 
{
  "generalPopulation": string,
  "elderly": string,
  "lungDiseasePopulation": string,
  "heartDiseasePopulation": string,
  "athletes": string,
  "pregnantWomen": string,
  "children": string
}
Поля
generalPopulation

string

Рекомендации для широкой аудитории.
elderly

string

Рекомендации для пожилых людей.
lungDiseasePopulation

string

Рекомендации для людей с заболеваниями легких или дыхательных путей.
heartDiseasePopulation

string

Рекомендации для людей с сердечно-сосудистыми заболеваниями.
athletes

string

Рекомендации для спортсменов и любителей активного отдыха.
pregnantWomen

string

Рекомендации для беременных.
children

string

Рекомендовано для детей.

DateTime

JSON-представление 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
Поля
year

integer

Необязательное поле. Год. Допустимы значения от 1 до 9999 или 0, если дата и время указываются без года.
month

integer

Необязательное поле. Месяц года. Значение должно быть от 1 до 12 или 0, если месяц не указан.
day

integer

Необязательное поле. День месяца. Значение должно быть в диапазоне от 1 до 31 и соответствовать году и месяцу или быть равно 0, если дата и время указываются без дня.
hours

integer

Необязательное поле. Часы в 24-часовом формате. Укажите значение от 0 до 23. По умолчанию используется 0 (полночь). В API допустимо значение "24:00:00" для таких сценариев, как время закрытия компании.
minutes

integer

Необязательное поле. Минуты часа. Значение по умолчанию – 0.
seconds

integer

Необязательное поле. Секунды. Обычно от 0 до 59, по умолчанию – 0. В API допустимо значение "60", если разрешены секунды координации.
nanos

integer

Необязательное поле. Доли секунды в наносекундах. Значение должно быть в диапазоне от 0 до 999 999 999. По умолчанию используется 0.
Объединенное поле time_offset. Необязательное поле. Указывает либо разницу с UTC, либо часовой пояс DateTime. Выбирайте внимательно, учитывая, что данные о часовом поясе могут измениться в будущем (например, страна меняет даты начала/окончания летнего времени, а будущие даты и время в затронутом диапазоне уже сохранены). Если значение не указано, считается, что дата и время указаны по местному времени. time_offset может иметь одно из следующих значений:
utcOffset

string (Duration format)

Разница с UTC. Значение должно быть целым числом секунд в диапазоне от -18 до +18 часов. Например, смещение UTC -4:00 будет представлено как { seconds: -14400 }.

Продолжительность в секундах, может содержать до девяти дробных цифр и заканчиваться на букву s. Пример: "3.5s".
timeZone

object (TimeZone)

Часовой пояс.

Продолжительность

JSON-представление 
{
  "seconds": string,
  "nanos": integer
}
Поля
seconds

string (int64 format)

Секунды со знаком. Значение должно быть в диапазоне от -315 576 000 000 до +315 576 000 000 включительно. Примечание. Эти границы вычисляются следующим образом: 60 сек/мин * 60 мин/ч * 24 ч/день * 365,25 дней/год * 10 000 лет.
nanos

integer

Доли секунды со знаком и наносекундным разрешением. Продолжительность менее одной секунды представлена полем seconds со значением 0 и полем nanos с положительным или отрицательным значением. Если продолжительность составляет одну секунду или больше, ненулевое значение в поле nanos должно иметь тот же знак, что и в поле seconds. Допустимы значения от -999 999 999 до +999 999 999 включительно.

TimeZone (часовой пояс)

JSON-представление 
{
  "id": string,
  "version": string
}
Поля
id

string

Часовой пояс из базы данных часовых поясов IANA. Пример: "America/New_York".
version

string

Необязательное поле. Номер версии базы данных часовых поясов IANA. Пример: "2019a".

PollenResultData

JSON-представление 
{
  "dailyForecast": {
    object (DailyPollenForecast)
  },
  "attribution": {
    object (Attribution)
  }
}
Поля
dailyForecast

object (DailyPollenForecast)

Ежедневный прогноз уровня пыльцы на запрашиваемую дату.
attribution

object (Attribution)

Обязательная атрибуция, которая должна показываться вместе с данными о пыльце.

DailyPollenForecast

JSON-представление 
{
  "date": {
    object (Date)
  },
  "categories": [
    {
      object (PollenCategoryInfo)
    }
  ],
  "plantSpecies": [
    {
      object (PlantSpeciesInfo)
    }
  ]
}
Поля
date

object (Date)

Дата прогноза по гражданскому календарю.
categories[]

object (PollenCategoryInfo)

Разбивка по основным категориям пыльцы (деревья, травы, сорняки).
plantSpecies[]

object (PlantSpeciesInfo)

Подробная разбивка по видам растений.

PollenCategoryInfo

JSON-представление 
{
  "displayName": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "healthRecommendations": [
    string
  ]
}
Поля
displayName

string

Отображаемое название категории (например, "Деревья", "Травы", "Сорняки").
inSeason

boolean

Цветут ли в регионе растения, относящиеся к этой категории.
index

object (PollenIndex)

Универсальный индекс концентрации пыльцы (UPI) для этой категории.
healthRecommendations[]

string

Практические советы по здоровью для людей, чувствительных к пыльце.

PollenIndex

JSON-представление 
{
  "category": string,
  "description": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Поля
category

string

Локализованная классификация категорий (например, "Нет", "Очень низкий", "Низкий", "Средний", "Высокий", "Очень высокий").
description

string

Описание уровня риска, связанного с пыльцой.

Объединенное поле _value.

Поле _value может иметь одно из следующих значений:
value

integer

Числовое значение UPI (по шкале от 0 до 5).

PlantSpeciesInfo

JSON-представление 
{
  "code": string,
  "displayName": string,
  "family": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "season": string,
  "crossReactions": string
}
Поля
code

string

Машиночитаемый код вида (например, "BIRCH", "JAPANESE_CEDAR", "RAGWEED").
displayName

string

Локализованное отображаемое название вида растения (например, "Береза").
family

string

Ботаническое название семейства (например, "Betulaceae (бетуловые)").
inSeason

boolean

Указывает, цветет ли сейчас этот вид растений.
index

object (PollenIndex)

Универсальный индекс концентрации пыльцы (UPI) для этого вида.
season

string

Описание типичного сезона цветения (например, "Конец зимы, весна").
crossReactions

string

Известные перекрестные аллергены (например, "Пыльца ольхи, орешника, бука и дуба").

Единица измерения

Единица измерения температуры.

Перечисления
UNIT_UNSPECIFIED Единица измерения температуры не указана.
CELSIUS Температура измеряется в градусах Цельсия.
FAHRENHEIT Температура измеряется в градусах Фаренгейта.

фаза колебаний

Отмечает фазу Луны.

Перечисления
PHASE_UNSPECIFIED Фаза луны не указана.
NEW_MOON Луна не освещается солнцем.
WAXING_CRESCENT Луна освещена на 0–50 % с правой стороны в Северном полушарии 🌒 и с левой стороны в Южном полушарии 🌘.
FIRST_QUARTER Луна освещена на 50,1 % с правой стороны в северном полушарии 🌓 и с левой стороны в южном полушарии 🌗.
WAXING_GIBBOUS Луна освещена на 50–100 % с правой стороны в Северном полушарии 🌔 и с левой стороны в Южном полушарии 🌖.
FULL_MOON Луна полностью освещена.
WANING_GIBBOUS Луна освещена на 50–100 % с левой стороны в Северном полушарии 🌖 и с правой стороны в Южном полушарии 🌔.
LAST_QUARTER Луна освещена на 50,1 % с левой стороны в северном полушарии 🌗 и с правой стороны в южном полушарии 🌓.
WANING_CRESCENT В Северном полушарии освещено от 0 до 50 % левой стороны Луны 🌘, а в Южном – от 0 до 50 % правой стороны 🌒.

Тип

Обозначает тип погодных условий в контексте элемента прогноза.

Примечание. Условия со значениями 42–139 в настоящее время возвращаются только для местоположений в Японии и Корее.

Перечисления
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 Сильная гроза.
CLEAR_AFTER_FOG_IN_THE_MORNING Утром туман, днем ясно.
CLEAR_BUT_LATER_TURNING_CLOUDY Ясно, в течение дня облачно.
CLEAR_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Ясно, в течение дня дождь со снегом (в основном дождь).
CLEAR_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Ясно, в течение дня снег с дождем (в основном снег).
CLEAR_BUT_THUNDERSTORMS_LATER Ясно, затем грозы.
CLEAR_IN_THE_MORNING_BUT_CLOUDY_IN_THE_EVENING Утром ясно, вечером облачно.
CLEAR_IN_THE_MORNING_WITH_BRIEF_RAIN_IN_THE_EVENING Утром ясно, вечером кратковременный дождь.
CLEAR_MORNING_WITH_BRIEF_RAIN Утром ясно, кратковременный дождь.
CLEAR_WITH_BRIEF_RAIN Ясно, кратковременный дождь.
CLEAR_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Ясно, кратковременный дождь со снегом (в основном дождь).
CLEAR_WITH_BRIEF_RAIN_LATER Ясно, в течение дня кратковременный дождь.
CLEAR_WITH_BRIEF_SNOW Ясно, кратковременный снег.
CLEAR_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Ясно, кратковременный снег с дождем (в основном снег).
CLEAR_WITH_BRIEF_SNOW_LATER Ясно, затем кратковременный снег.
CLEAR_WITH_PERIODIC_CLOUDS_LATER Ясно, в течение дня переменная облачность.
CLEAR_WITH_PERIODIC_RAIN Ясно, временами дождь.
CLEAR_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Ясно, временами дождь с грозой.
CLEAR_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Ясно, временами дождь со снегом (в основном дождь).
CLEAR_WITH_PERIODIC_RAIN_LATER Ясно, в течение дня временами дождь.
CLEAR_WITH_PERIODIC_SNOW Ясно, временами снег.
CLEAR_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Ясно, временами снег с дождем (в основном снег).
CLEAR_WITH_PERIODIC_SNOW_LATER Ясно, затем временами снег.
CLEAR_WITH_RAIN_AFTER_MIDNIGHT Ясно, после полуночи дождь.
CLEAR_WITH_RAIN_IN_THE_NIGHT Ясно, ночью дождь.
CLEAR_WITH_RAIN_LATER Ясно, в течение дня дождь.
CLEAR_WITH_SNOW_ALONG_THE_MOUNTAINS Ясно, в горах снег.
CLEAR_WITH_SNOW_LATER Ясно, затем снег.
CLEAR_WITH_THUNDERSTORMS_ALONG_THE_MOUNTAINS Ясно, в горах грозы.
CLEAR_WITH_THUNDERSTORMS_IN_THE_AFTERNOON Ясно, после полудня грозы.
CLOUDY_BUT_CLEAR_LATER Облачно, в течение дня ясно.
CLOUDY_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Облачно, в течение дня дождь со снегом (в основном дождь).
CLOUDY_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Облачно, в течение дня снег с дождем (в основном снег).
CLOUDY_BUT_PERIODICALLY_CLEAR_LATER Облачно, ожидаются временные прояснения.
CLOUDY_BUT_THUNDERSTORMS_LATER Облачно, затем грозы.
CLOUDY_MORNING_WITH_BRIEF_RAIN Утром облачно, кратковременный дождь.
CLOUDY_PERIODICALLY_CLEAR Облачно с прояснениями.
CLOUDY_SNOWING_IN_THE_EVENING Облачно, вечером снег.
CLOUDY_SNOWING_IN_THE_NIGHT Облачно, ночью снег.
CLOUDY_WITH_BRIEF_RAIN Облачно, кратковременный дождь.
CLOUDY_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Облачно, кратковременный дождь со снегом (в основном дождь).
CLOUDY_WITH_BRIEF_RAIN_LATER Облачно, затем кратковременный дождь.
CLOUDY_WITH_BRIEF_SNOW Облачно, кратковременный снег.
CLOUDY_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Облачно, кратковременный снег с дождем (в основном снег).
CLOUDY_WITH_BRIEF_SNOW_LATER Облачно, в течение дня кратковременный снег.
CLOUDY_WITH_BRIEF_THUNDERSTORM Облачно, кратковременная гроза.
CLOUDY_WITH_FOG_ON_THE_OCEAN_AND_AT_THE_SEASHORE Облачно, над океаном и на побережье туман.
CLOUDY_WITH_PERIODIC_RAIN Облачно, временами дождь.
CLOUDY_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Облачно, временами дождь с грозой.
CLOUDY_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Облачно, временами дождь со снегом (в основном дождь).
CLOUDY_WITH_PERIODIC_RAIN_LATER Облачно, затем временами дождь.
CLOUDY_WITH_PERIODIC_SNOW Облачно, временами снег.
CLOUDY_WITH_PERIODIC_SNOW_ACCOMPANIED_BY_THUNDER Облачно, временами снег и гроза.
CLOUDY_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Облачно, временами снег с дождем (в основном снег).
CLOUDY_WITH_PERIODIC_SNOW_LATER Облачно, затем временами снег.
CLOUDY_WITH_RAIN_AFTER_MIDNIGHT Облачно, после полуночи дождь.
CLOUDY_WITH_RAIN_FROM_ABOUT_NOON Облачно, после полудня дождь.
CLOUDY_WITH_RAIN_FROM_EVENING Облачно, вечером дождь.
CLOUDY_WITH_RAIN_LATER Облачно, затем дождь.
CLOUDY_WITH_SNOW_FROM_AROUND_NOON Облачно, после полудня снег.
CLOUDY_WITH_SNOW_LATER Облачно, в течение дня снег.
FOG Туман.
RAINSNOW_MIX_LATER_BECOMING_CLEAR_RAIN_AS_MAIN Дождь со снегом (в основном дождь), в течение дня ясно.
RAINSNOW_MIX_RAIN_AS_MAIN Дождь со снегом (в основном дождь).
RAINY_BUT_PERIODICALLY_CLEAR Дождливо, облачно с прояснениями.
RAIN_ACCOMPANIED_BY_LIGHTNING Дождь и гроза.
RAIN_ACCOMPANIED_BY_WINDSTORM Дождь и шквалистый ветер.
RAIN_CLEAR_AT_NIGHT Дождь, ночью с прояснениями.
RAIN_CLEAR_FROM_AROUND_EVENING Дождь, вечером с прояснениями.
RAIN_CLEAR_FROM_AROUND_NOON Дождь, после обеда с прояснениями.
RAIN_LATER_BECOMING_CLEAR Дождь, в течение дня с прояснениями.
RAIN_LATER_BECOMING_CLOUDY Дождь, в течение дня облачно.
RAIN_LATER_BECOMING_SNOW Дождь, в течение дня снег.
RAIN_LATER_WITH_PERIODIC_SNOW Дождь, в течение дня временами снег.
RAIN_SNOW_AT_NIGHT Дождь со снегом ночью.
RAIN_SNOW_IN_THE_EVENING Дождь со снегом вечером.
RAIN_TEMPORARILY_BECOMING_SLEET Дождь, временами мокрый снег.
RAIN_THAT_PERIODICALLY_STOPS Дождь, временами без осадков.
RAIN_WITH_BRIEF_SNOW Дождь, кратковременный снег.
RAIN_WITH_PERIODIC_SNOW Дождь, временами снег.
SNOWRAIN_MIX_LATER_BECOMING_CLEAR_SNOW_AS_MAIN Снег с дождем (в основном снег), в течение дня ясно.
SNOWRAIN_MIX_LATER_BECOMING_CLOUDY_SNOW_AS_MAIN Снег с дождем (в основном снег), в течение дня облачно.
SNOWRAIN_MIX_SNOW_AS_MAIN Снег с дождем (в основном снег).
SNOW_ACCOMPANIED_BY_LIGHTNING Снегопад с молниями.
SNOW_BECOMING_SLEET Снег, мокрый снег.
SNOW_LATER_CLEAR Снег, в течение дня с прояснениями.
SNOW_LATER_CLOUDY Снег, в течение дня облачно.
SNOW_LATER_RAIN Снег, в течение дня дождь.
SNOW_PERIODICALLY_CLEAR Снег с прояснениями.
SNOW_THAT_PERIODICALLY_STOPS Снег, временами без осадков.
SNOW_TURNING_TO_RAIN_AROUND_NOON Снег, после обеда дождь.
SNOW_TURNING_TO_RAIN_IN_THE_EVENING Снег, вечером переходящий в дождь.
SNOW_TURNING_TO_RAIN_IN_THE_NIGHT Снег, ночью дождь.
SNOW_WITH_BRIEF_RAIN Снег, кратковременный дождь.
SNOW_WITH_BRIEF_SLEET Снег, кратковременный мокрый снег.
SNOW_WITH_PERIODIC_RAIN Снег, временами дождь.
VERY_HOT Предмет очень горячий.
SLEET Мокрый снег.
HEAVY_RAIN_TO_RAINSTORM Сильный дождь или ливень.

Тип

Тип осадков в указанном местоположении.

Перечисления
TYPE_UNSPECIFIED Тип осадков не указан.
NONE Без осадков.
SNOW Снег.
RAIN Дождь.
LIGHT_RAIN Небольшой дождь.
HEAVY_RAIN Сильный дождь.
RAIN_AND_SNOW Осадки в виде дождя и снега.
SLEET Мокрый снег.
FREEZING_RAIN Ледяной дождь.
PRECIPITATION_TYPE_HAIL Град.

Единица измерения

Единица измерения количества выпавших осадков.

Перечисления
UNIT_UNSPECIFIED Не указана единица измерения осадков.
MILLIMETERS Количество осадков измеряется в миллиметрах.
INCHES Количество осадков измеряется в дюймах.

Кардинал

Представляет сторону света (включая промежуточные).

Перечисления
CARDINAL_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 Северо-северо-западное направление.

Единица измерения

Единица измерения скорости.

Перечисления
UNIT_UNSPECIFIED Единица измерения скорости не указана.
KILOMETERS_PER_HOUR Скорость измеряется в километрах в час.
MILES_PER_HOUR Скорость измеряется в милях в час.

Единица измерения

Единицы измерения концентрации загрязняющих веществ.

Перечисления
UNIT_UNSPECIFIED Не указана единица измерения концентрации.
PARTS_PER_BILLION Частиц на миллиард.
MICROGRAMS_PER_CUBIC_METER Микрограммы на кубический метр (мкг/м³).

Аннотации инструментов

Аннотации инструментов отправляются клиентам MCP, чтобы описать базовый риск, связанный с определенным инструментом. Большинство клиентов считают эти подсказки ненадежными, но их можно использовать, чтобы решить, когда пользователю может быть отправлен запрос на подтверждение.

Помимо строки заголовка, определены следующие логические подсказки:

  • readOnlyHint: если задано значение true, инструмент не изменяет свою среду. Значение по умолчанию – false.
  • destructiveHint: если задано значение True, инструмент может выполнять деструктивные действия. Если false, то инструмент может выполнять только действия по добавлению. Значение по умолчанию: true.
  • idempotentHint – если задано значение True, повторный вызов инструмента с теми же аргументами не будет иметь дополнительного эффекта в его среде. Значение по умолчанию – false.
  • openWorldHint: если задано значение true, инструмент может взаимодействовать с "открытым миром" внешних объектов. Если false, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

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