MCP Tools Reference: mapstools.googleapis.com

工具：lookup_weather

擷取特定地點的完整環境情報，包括天氣、空氣品質 (AQI 和污染物) 和花粉 (樹木、草、雜草和植物物種過敏原等級)：目前狀況、每小時預報/歷史記錄，以及每日天氣和空氣品質預報；花粉僅提供每日預報 (今天到 +4 天，不提供每小時或過去資料)。可用的環境網域和功能 (capabilities：WEATHER、AIR_QUALITY、POLLEN - 重要)：* 必須明確選取：每次呼叫時，capabilities 必須包含 WEATHER、AIR_QUALITY 或 POLLEN 至少其中一項。不得省略 capabilities。* 廣泛/模糊的戶外查詢 (完整戶外環境套件)：如果使用者詢問一般戶外、旅遊或情境問題，但未限定特定領域 (例如「現在適合出門跑步嗎？」)，請明確加入所有三項功能 (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"])，傳回完整的戶外環境套件 (天氣 + 空氣品質 + 花粉)；如果是過去的 date/hour，請省略沒有記錄的 POLLEN。* 指定領域選取 (特定查詢)：如果使用者明確要求一或兩個領域 (例如「西雅圖目前的空氣品質指數是多少？」)，請僅納入要求的函式 (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)，絕不使用世界標準時間或呼叫端時區。* 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；如要要求特定區域的 AQI 量表，可選擇設定 index_region_code (雙字母 ISO 國家/地區代碼，例如 "US")。根據預設，回應會包含通用空氣品質指數和該地點的區域空氣品質指數。* 出處：有基準的輸出內容必須使用每個傳回網域容器 (weather.attribution、air_quality.attribution、pollen.attribution) 內的 attribution 欄位註明出處。* 傳回時間：空氣品質 date_time 值已採用當地時間 (包含 utc_offset)，請直接顯示。天氣 date_time (目前和每小時) 和日出/日落時間為世界標準時間，請使用 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) 級別，以及通用空氣品質指數 (UAQI)。如未指定，則預設為所要求位置的區域。

UnitsSystem

代表用於測量值的單位系統。

列舉
UNITS_SYSTEM_UNSPECIFIED 未指定單位系統。
IMPERIAL 英制單位系統 (例如華氏、英里等)。
METRIC 公制單位系統 (例如攝氏、公里等)。

功能

可在 LookupWeatherRequest 中要求的環境功能。

列舉
CAPABILITY_UNSPECIFIED 未指定功能。
WEATHER 天氣狀況 (溫度、降雨、風、紫外線等)。
AIR_QUALITY 空氣品質資訊 (AQI、污染物和健康建議)。
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)

必填。傳回天氣資訊的位置。這個位置與要求中的位置相同，但如果要求的位置是查詢大概位置的自由格式文字地址 (例如「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

紫外線指數最大值。

聯集欄位 _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 個小數位數，也接受「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 正規化，並使用 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)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 (含) 之間 (對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z)。
nanos

integer

非負數的秒數分數，解析度為奈秒。這個欄位是時間長度的奈秒部分，而非秒數的替代值。含有分數的負秒值仍須有非負奈秒值，以向前計算時間。必須介於 0 至 999,999,999 之間 (含 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 個小數位數，也接受「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 正規化，並使用 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，不含檔案類型副檔名。如要顯示圖示，請視需要附加主題和檔案類型副檔名 (.png 或 .svg) 至這個 URI。根據預設，圖示會採用淺色主題，但您可以附加 _dark，以便在深色模式下使用。例如：「https://maps.gstatic.com/weather/v1/dust.svg」或「https://maps.gstatic.com/weather/v1/dust_dark.svg」，其中 icon_base_uri 為「https://maps.gstatic.com/weather/v1/dust」。
description

object (LocalizedText)

天氣狀況的文字說明 (本地化)。
type

enum (Type)

天氣狀況類型。

LocalizedText

JSON 表示法 
{
  "text": string,
  "languageCode": string
}
欄位
text

string

本地化字串，語言與下方的 google.type.LocalizedText.language_code 對應。
languageCode

string

文字的 BCP-47 語言代碼，例如「en-US」或「sr-Latn」。

詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。

降水率

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

object (PrecipitationProbability)

降雨機率 (值介於 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

與地點相關聯的地點 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 正規化，並使用 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

紫外線指數最大值。

聯集欄位 _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)

空氣品質指數 (例如通用空氣品質指數和當地空氣品質指數)。
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

指數的顯示名稱 (例如「Universal AQI」、「US EPA AQI」)。
valueDisplay

string

AQI 值的格式化字串表示法。
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 到 59 之間，預設為 0。
seconds

integer

(選用步驟) 時間的分秒。通常必須介於 0 到 59 之間，預設值為 0。如果 API 允許閏秒，則可允許值為 60。
nanos

integer

(選用步驟) 以奈秒為單位的秒數。必須介於 0 到 999,999,999 之間，預設值為 0。
聯集欄位 time_offset。(選用步驟) 指定 DateTime 的世界標準時間偏移或時區。請謹慎選擇，因為時區資料日後可能會變更 (例如某個國家/地區修改日光節約時間的開始/結束日期，而受影響範圍內的未來日期時間已儲存)。如果省略，系統會將 DateTime 視為當地時間。time_offset 只能是下列其中一項：
utcOffset

string (Duration format)

世界標準時間時差。必須是整數秒，介於 -18 小時和 +18 小時之間。舉例來說，如果世界標準時間時差為 -4:00，則會表示為 { seconds: -14400 }。

以秒為單位的時間長度，最多 9 個小數位數，結尾為「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

時間範圍內以奈秒解析度表示的有正負號秒數分數。如果時間長度不到一秒，則會以 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%。
FIRST_QUARTER 月球在北半球的右側 🌓 和南半球的左側 🌗 有 50.1% 的面積被照亮。
WAXING_GIBBOUS 月亮右側 (北半球 🌔) 或左側 (南半球 🌖) 的受光面積為 50% 到 100%。
FULL_MOON 月球完全照亮。
WANING_GIBBOUS 月球左側 (北半球) 🌖 或右側 (南半球) 🌔 有 50% 到 100% 的部分受到照亮。
LAST_QUARTER 月球在北半球的左側 🌗 和南半球的右側 🌓 照亮 50.1%。
WANING_CRESCENT 月球左側 (北半球 🌘) 或右側 (南半球 🌒) 的受光面積為 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，工具只能與內部實體互動。舉例來說，網頁搜尋工具是開放世界，而記憶工具則不是。

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