MCP Tools Reference: mapstools.googleapis.com

工具：lookup_weather

检索某个地点的综合环境情报，包括天气、空气质量（AQI 和污染物）以及 Pollen（树木、草、杂草和植物物种过敏原水平）：天气和空气质量的当前状况、每小时预报/历史记录和每日预报；Pollen 仅提供每日预报（今天到 +4 天，无每小时或过去的数据）。可用的环境网域和功能（capabilities：WEATHER、AIR_QUALITY、POLLEN - 关键）：* 强制性显式选择：您必须在每次调用的 capabilities 中至少包含 WEATHER、AIR_QUALITY 或 POLLEN 之一。不允许省略 capabilities。* 宽泛/模糊的户外查询（完整户外环境套件）：如果用户提出宽泛的户外、旅行或情境问题，而未限定特定领域（例如“现在户外跑步的条件如何？”），请明确包含所有三项功能 (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"])，以返回完整的户外环境套件（天气 + 空气质量 + 花粉）；对于过去的 date/hour，请排除没有历史记录的 POLLEN。* 有针对性的领域选择（特定查询）：如果用户明确要求仅查询一两个领域（例如，“西雅图此时此刻的 AQI 是多少？”），请仅包含所请求的功能（WEATHER、AIR_QUALITY 和/或 POLLEN）。系统只会执行并返回所请求领域的信息。按领域提供的具体数据：* 天气 (weather)：温度（当前温度、体感温度、最高/最低温度、热度指数）、风（风速、阵风、风向）、天体事件（日出/日落、月相）、降水（类型、概率、数量/QPF）和大气条件（紫外线指数、湿度、云量、雷暴概率、气压）。* 空气质量 (air_quality)：通用和本地空气质量指数（AQI 值、类别、主要污染物）、针对 7 个敏感群体的健康建议，以及污染物浓度 (include_pollutant_concentration: true)。每个指数都有自己的主要污染物；请按指数报告（例如，不要将通用 AQI 的污染物作为美国 AQI 的污染物）。* 花粉 (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. 地点 ID (place_id)：* 明确的 Google 地图地点 ID（例如，从 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（所请求 location 的当地民用时间中的 {year, month, day}），不提供 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，并从空气质量序列中读取该时间窗口的小时数，而不是对各个小时进行采样。如果您使用每小时调用，请覆盖时间范围内的每个小时。* 返回所请求的天气和/或花粉每日预报，以及当天每小时空气质量系列，涵盖整个本地日（本地时间 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)：如果需要特定污染物浓度（PM2.5、PM10、O3、NO2、SO2、CO），请设置 include_pollutant_concentration: true；可选择设置 index_region_code（由两个字母组成的 ISO 国家/地区代码，例如 "US"），以请求特定区域的 AQI 标度。默认情况下，响应中会包含通用 AQI 和该地点的区域 AQI。* 归因：必须使用每个返回的网域容器（weather.attribution、air_quality.attribution、pollen.attribution）内的 attribution 字段，将接地输出归因于来源。* 返回的时间：空气质量 date_time 值已采用地点的当地时间（包含 utc_offset）；请按原样显示。天气 date_time（当前和每小时）以及日出/日落时间采用世界协调时间 (UTC)；请使用 time_zone 将其转换为地点的当地时间。将所有时间标记为本地时间。

以下代码示例展示了如何使用 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)
  },
  "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)

可选。返回的天气状况所使用的单位制。如果未提供，返回的天气状况将采用公制（默认 = METRIC）。
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 语言代码（例如“en”“ja”“fr-CA”）。如果未指定，则默认为“en”。

联合字段 _weather_options。

_weather_options 只能是下列其中一项：
weatherOptions

object (WeatherOptions)

可选。天气请求特有的选项。weather_options.units_system 与顶级 units_system（标记 4）一起受支持，以保持与现有调用方的向后兼容性；如果两者指定了冲突的单位系统，则返回 INVALID_ARGUMENT。如果未在 capabilities 中请求 WEATHER，则会被忽略。

联合字段 _air_quality_options。

_air_quality_options 只能是下列其中一项：
airQualityOptions

object (AirQualityOptions)

可选。空气质量请求特有的选项。如果未在 capabilities 中请求 AIR_QUALITY，则会被忽略。

日期

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

与营业地点相关联的地点 ID。
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)

可选。返回的天气状况所使用的单位制。如果未提供，返回的天气状况将采用公制（默认 = METRIC）。

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) 标度以及通用 AQI (UAQI)。如果未指定，则默认为所请求位置的区域。

UnitsSystem

表示用于测量值的单位制。

枚举
UNITS_SYSTEM_UNSPECIFIED 未指定单位制。
IMPERIAL 英制单位系统（例如华氏度、英里等）。
METRIC 公制单位系统（例如摄氏度、公里等）。

能力

可在 LookupWeatherRequest 中请求的环境功能。

枚举
CAPABILITY_UNSPECIFIED 未指定功能。
WEATHER 天气状况（温度、降水、风、紫外线等）。
AIR_QUALITY 空气质量信息（AQI、污染物和健康建议）。
POLLEN 花粉信息（树木、草、杂草和植物物种过敏原水平）。

输出架构

LookupWeather RPC 的响应 - 表示所请求位置的天气状况。

此响应同时代表每小时和每日信息，因此响应分为三个部分：每小时、每日和共享。“仅限每小时”和“仅限每日”字段标记为选填。对于每小时和每日信息中共享的字段，有些字段始终存在，因此未标记为可选，而其余字段则标记为可选，因为它们并非始终可用。

LookupWeatherResponse

JSON 表示法 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

必需。返回天气信息的位置。此位置与请求中的位置相同，但如果请求的位置是查找粗略位置的自由文本地址（例如“Mountain View, CA”），则可能与请求中的位置不同。
attribution

object (Attribution)

与天气信息一起显示的必需出处。

联合字段 _temperature。

_temperature 只能是下列其中一项：
temperature

object (Temperature)

每小时温度

联合字段 _feels_like_temperature。

_feels_like_temperature 只能是下列其中一项：
feelsLikeTemperature

object (Temperature)

每小时的体感温度。

联合字段 _heat_index。

_heat_index 只能是下列其中一项：
heatIndex

object (Temperature)

每小时酷热指数温度。

联合字段 _air_pressure。

_air_pressure 只能是下列其中一项：
airPressure

object (AirPressure)

每小时气压状况。

联合字段 _max_temperature。

_max_temperature 只能是下列其中一项：
maxTemperature

object (Temperature)

全天的最高温度。

联合字段 _min_temperature。

_min_temperature 只能是下列其中一项：
minTemperature

object (Temperature)

全天最低温度。

联合字段 _feels_like_max_temperature。

_feels_like_max_temperature 只能是下列其中一项：
feelsLikeMaxTemperature

object (Temperature)

全天最高体感温度。

联合字段 _feels_like_min_temperature。

_feels_like_min_temperature 只能是下列其中一项：
feelsLikeMinTemperature

object (Temperature)

全天最低体感温度。

联合字段 _max_heat_index。

_max_heat_index 只能是下列其中一项：
maxHeatIndex

object (Temperature)

全天最高酷热指数温度。

联合字段 _sun_events。

_sun_events 只能是下列其中一项：
sunEvents

object (SunEvents)

与太阳相关的事件（例如日出、日落）。

联合字段 _moon_events。

_moon_events 只能是下列其中一项：
moonEvents

object (MoonEvents)

与月亮相关的事件（例如月出、月落）。

联合字段 _relative_humidity。

_relative_humidity 只能是下列其中一项：
relativeHumidity

integer

相对湿度百分比（值介于 0 到 100 之间）。

联合字段 _uv_index。

_uv_index 只能是下列其中一项：
uvIndex

integer

最高紫外线 (UV) 指数。

联合字段 _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 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“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 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

时间戳

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 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 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“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 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："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 语言代码，例如“en-US”或“sr-Latn”。

如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。

降水概率

JSON 表示法 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
字段
probability

object (PrecipitationProbability)

降水概率（值介于 0 到 100 之间）。
snowQpf

object (QuantitativePrecipitationForecast)

一段时间内累积的降雪量，以液态水当量衡量。注意：QPF 是 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

一段时间内累积的降水量，以液态水当量衡量。

Wind

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

与营业地点相关联的地点 ID。
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

要链接到的归因网址。

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 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："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

最高紫外线 (UV) 指数。

联合字段 _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)

所请求时间的每小时空气质量数据（包含 1 个条目，用于查询当前状况或单小时查询；最多 24 个条目，用于查询过去或未来的日期；或当前 + 剩余小时数，当日期为今天时）。
attribution

object (Attribution)

与空气质量数据一起显示的必需提供方信息。

AirQualityHourlyResult

JSON 表示法 
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
字段
indexes[]

object (AirQualityIndex)

空气质量指数（例如通用 AQI 和本地 AQI）。
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

指数的显示名称（例如“通用 AQI”“美国 EPA AQI”）。
valueDisplay

string

AQI 值的格式化字符串表示。
category

string

空气质量级别文本（例如“空气质量良好”“空气质量一般”）。
dominantPollutant

string

主要污染物的代码（例如“pm25”“o3”）。

联合字段 _value。

_value 只能是下列其中一项：
value

integer

AQI 数值。

污染物

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 到 59 之间的数字，默认为 0。
seconds

integer

可选。时间的秒数部分。通常必须是 0 到 59 之间的数字，默认为 0。如果 API 允许闰秒，则 API 可以允许 60 一值。
nanos

integer

可选。秒数的小数部分（以纳秒为单位）。必须是 0 到 999,999,999 之间的数字，默认为 0。
联合字段 time_offset。可选。指定 DateTime 的世界协调时间 (UTC) 偏移量或时区。考虑到时区数据将来可能会发生变化（例如，某个国家/地区修改了夏令时开始/结束日期，而受影响范围内的未来 DateTime 已存储），请仔细进行选择。如果省略，则 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 天/年 * 10000 年
nanos

integer

时间跨度的秒数的有符号小数部分（以纳秒为单位）。小于 1 秒的时长用 0 seconds 字段和正或负 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

植物科名（例如“桦木科”）。
inSeason

boolean

此植物物种当前是否处于当季。
index

object (PollenIndex)

此物种的通用花粉指数 (UPI) 测量值。
season

string

典型的花期说明（例如“冬末、春季”）。
crossReactions

string

已知交叉反应性过敏原（例如“桤木、榛树、山毛榉和橡树花粉”）。

单位

表示用于测量温度的单位。

枚举
UNIT_UNSPECIFIED 未指定温度单位。
CELSIUS 温度以摄氏度为单位。
FAHRENHEIT 温度以华氏度为单位。

阶段

标记月相。

枚举
PHASE_UNSPECIFIED 未指定月相。
NEW_MOON 月球没有被太阳照亮。
WAXING_CRESCENT 在北半球，月球右侧有 0%-50% 的区域被照亮 🌒；在南半球，月球左侧有 0%-50% 的区域被照亮 🌘。
FIRST_QUARTER 月球在北半球右侧被照亮 50.1% 🌓，在南半球左侧被照亮 50.1% 🌗。
WAXING_GIBBOUS 月球右侧（北半球 🌔）或左侧（南半球 🌖）有 50%-100% 的区域被照亮。
FULL_MOON 月球完全被照亮。
WANING_GIBBOUS 在北半球，月球左侧有 50%-100% 的区域被照亮 🌖；在南半球，月球右侧有 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 十亿分率 (ppb)。
MICROGRAMS_PER_CUBIC_METER 微克每立方米 (µg/m³)。

工具注释

工具注解会发送到 MCP 客户端，用于描述给定工具的基本风险。大多数客户端会将这些提示视为不可信，但它们可用于决定何时向用户发送确认提示。

除了标题字符串之外，还定义了以下布尔值提示：

  • readOnlyHint：如果为 true，则该工具不会修改其环境。默认值：false。
  • destructiveHint：如果为 true，则该工具可以执行破坏性操作。如果为 false，则该工具只能执行添加操作。默认值：true。
  • idempotentHint：如果为 true，则使用相同参数重复调用该工具不会对其环境产生额外影响。默认值：false。
  • openWorldHint：如果为 true，则该工具可以与外部实体的“开放世界”进行交互。如果为 false，则该工具只能与内部实体交互。例如，网页搜索工具是开放世界，而记忆工具不是开放世界。

破坏性提示：❌ | 幂等性提示：❌ | 只读提示：✅ | 开放世界提示：❌