Package google.maps.weather.v1

索引

天氣

Weather API 的服務定義。

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

傳回指定地點的目前天氣狀況。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform
LookupForecastDays

rpc LookupForecastDays(LookupForecastDaysRequest) returns (LookupForecastDaysResponse)

從當天起算，傳回指定地點最多 10 天的每日預報。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform
LookupForecastHours

rpc LookupForecastHours(LookupForecastHoursRequest) returns (LookupForecastHoursResponse)

從目前時間開始，傳回指定地點最多 240 小時的每小時預報。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform
LookupHistoryHours

rpc LookupHistoryHours(LookupHistoryHoursRequest) returns (LookupHistoryHoursResponse)

從最後一小時開始，傳回指定地點最多 24 小時的每小時歷史天氣資料。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform
LookupPublicAlerts

rpc LookupPublicAlerts(LookupPublicAlertsRequest) returns (LookupPublicAlertsResponse)

傳回指定地點的公共天氣警報。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

AirPressure

代表大氣壓力狀況。

欄位
mean_sea_level_millibars

float

平均海平面氣壓，單位為毫巴。

CardinalDirection

代表基本方位 (包括序數方位)。

列舉
CARDINAL_DIRECTION_UNSPECIFIED 未指定方位。
NORTH 正北方位。
NORTH_NORTHEAST 次要中間方位，介於東北和北之間。
NORTHEAST 東北方。
EAST_NORTHEAST 次要中間方位，介於東方和東北方之間。
EAST 東方基本方位。
EAST_SOUTHEAST 東南東次要羅盤方位。
SOUTHEAST 東南方位。
SOUTH_SOUTHEAST 次要方位，位於東南和南之間。
SOUTH 正南方。
SOUTH_SOUTHWEST 次要方位，介於西南和南之間。
SOUTHWEST 西南方。
WEST_SOUTHWEST 次要方位，介於西南和西之間。
WEST 西方的基本方位。
WEST_NORTHWEST 西西北次要方位。
NORTHWEST 西北方。
NORTH_NORTHWEST 西北偏北次要中間方向。

確定度

表示警報訊息主題事件確定程度的代碼。

列舉
CERTAINTY_UNKNOWN 確定性不明。
OBSERVED 已發生或正在發生。
VERY_LIKELY 很有可能。
LIKELY 可能 (p > ~50%)。
POSSIBLE 可能但不太可能 (p <= ~50%)。
UNLIKELY 不太可能 (p ~ 0%)。

DataSource

代表資料來源的連結。

欄位
publisher

Publisher

快訊發布者。
name

string

正式發布者名稱。請注意，雖然這個欄位應經過本地化，但我們無法保證一定會本地化。
authority_uri

string

主管機關網站的網址。

ForecastDay

代表特定地點的每日預報記錄。

欄位
interval

Interval

這個預測日期的開始 (含) 和結束 (不含) 世界標準時間間隔。注意：一天的開始時間為當地時間上午 7 點，結束時間為隔天上午 7 點。舉例來說，如果當地時區為 UTC-7，間隔就會從 14:00:00.000Z 開始，並在隔天同一時間結束。
display_date

Date

計算每日預報時，該地點所在時區的當地日期 (民用時間)。此欄位可能會用於在用戶端上顯示。
daytime_forecast

ForecastDayPart

預測白天時段 (當地時間上午 7 點至下午 7 點) 的天氣狀況。
nighttime_forecast

ForecastDayPart

預測當天夜間 (當地時間下午 7 點至次日早上 7 點) 的天氣狀況。
max_temperature

Temperature

當天的最高溫度。
min_temperature

Temperature

當天的最低溫度。
feels_like_max_temperature

Temperature

全天最高體感溫度。
feels_like_min_temperature

Temperature

全天最低體感溫度。
max_heat_index

Temperature

當天最高體感溫度。
sun_events

SunEvents

與太陽相關的事件 (例如日出、日落)。
moon_events

MoonEvents

與月亮相關的事件 (例如月出、月落)。

ForecastDayPart

代表一天中某個時段的預測記錄。

欄位
interval

Interval

這段時間的開始 (含) 和結束 (不含) 世界標準時間日期和時間。注意：一天中的某個時段是指當地時間當天上午 7 點到下午 7 點。舉例來說，如果當地時區為 UTC-7，則白天時段會從 14:00:00.000Z 開始，並於隔天的 02:00:00.000Z 結束；夜間時段則會從隔天的 02:00:00.000Z 開始，並於當天的 14:00:00.000Z 結束。
weather_condition

WeatherCondition

天氣預報狀況。
precipitation

Precipitation

預測降水量。
wind

Wind

平均風向、最大風速和陣風。
ice_thickness

IceThickness

當天累積的結冰量。
relative_humidity

int32

預測的相對濕度百分比 (值介於 0 到 100 之間)。
uv_index

int32

預測的最高紫外線指數。
thunderstorm_probability

int32

平均雷雨機率。
cloud_cover

int32

平均雲量百分比。

ForecastHour

代表特定地點的每小時天氣預報記錄。

欄位
interval

Interval

這項預測資料的有效時間間隔 (以世界標準時間表示)，為一小時 (時間戳記會向下四捨五入至最接近的小時)。
display_date_time

DateTime

計算每小時預報時，該地點時區的當地日期和時間 (民用時間)。此欄位可能會用於在用戶端上顯示。注意：這個日期會包含年、月、日、小時和與世界標準時間的時差。
weather_condition

WeatherCondition

天氣預報狀況。
temperature

Temperature

預測溫度。
feels_like_temperature

Temperature

要求地點的體感溫度。
dew_point

Temperature

預測露點溫度。
heat_index

Temperature

預測的酷熱指數溫度。
wind_chill

Temperature

預報的風寒指數，即皮膚暴露在空氣中時的溫度。
wet_bulb_temperature

Temperature

預測的溼球溫度，即蒸發水可達到的最低溫度。
precipitation

Precipitation

預測降雨機率和過去一小時的累積降雨量。
air_pressure

AirPressure

預測的氣壓狀況。
wind

Wind

預測風勢。
visibility

Visibility

預測瀏覽權限。
ice_thickness

IceThickness

預測冰層厚度。
is_daytime

bool

如果這個小時介於當地日出 (含) 和日落 (不含) 時間之間，則為 True。否則就是夜間 (日落到下一次日出之間)。注意：如果間隔分別與當地日出和日落時間相交，則該小時會視為白天或夜晚 (例如：如果間隔是從上午 5 點到上午 6 點，而日出時間是上午 5 點 59 分，則 is_daytime 會為 true)。
relative_humidity

int32

預測的相對濕度百分比 (值介於 0 到 100 之間)。
uv_index

int32

預測紫外線指數。
thunderstorm_probability

int32

預測雷雨機率 (值介於 0 到 100 之間)。
cloud_cover

int32

預測雲量百分比 (值介於 0 到 100 之間)。

HistoryHour

代表特定地點的每小時記錄。

欄位
interval

Interval

這項歷史資料的有效時間間隔 (以世界標準時間為準，時間戳記會向下捨入至最接近的小時)。
display_date_time

DateTime

計算這項每小時記錄時，該地點所在時區的當地日期和時間 (民用時間)。此欄位可能會用於在用戶端上顯示。注意：這個日期會包含年、月、日、小時和與世界標準時間的時差。
weather_condition

WeatherCondition

歷來的天氣狀況。
temperature

Temperature

歷史溫度。
feels_like_temperature

Temperature

要求地點的體感溫度。
dew_point

Temperature

歷史露點溫度。
heat_index

Temperature

歷史酷熱指數溫度。
wind_chill

Temperature

歷史風寒指數，即皮膚暴露在空氣中的溫度。
wet_bulb_temperature

Temperature

歷史溼球溫度，即蒸發水可達到的最低溫度。
precipitation

Precipitation

過去一小時的降水機率和累積降水量。
air_pressure

AirPressure

歷來氣壓狀況。
wind

Wind

歷來風況。
visibility

Visibility

過去的瀏覽權限。
ice_thickness

IceThickness

歷年冰層厚度。
is_daytime

bool

如果這個小時介於當地日出 (含) 和日落 (不含) 時間之間，則為 True。否則就是夜間 (日落到下一次日出之間)。注意：如果間隔分別與當地日出和日落時間相交，則該小時會視為白天或夜晚 (例如：如果間隔是從上午 5 點到上午 6 點，而日出時間是上午 5 點 59 分，則 is_daytime 會為 true)。
relative_humidity

int32

歷史相對濕度百分比 (值介於 0 到 100 之間)。
uv_index

int32

歷史紫外線指數。
thunderstorm_probability

int32

歷史雷雨機率 (值介於 0 到 100)。
cloud_cover

int32

歷史雲量百分比 (值介於 0 到 100 之間)。

IceThickness

代表冰層厚度狀況。

欄位
unit

Unit

代表用於測量冰層厚度的單位。
thickness

float

冰層厚度值。

單位

代表用來測量冰層厚度的單位。

列舉
UNIT_UNSPECIFIED 未指定單位。
MILLIMETERS 厚度以公釐為單位。
INCHES 厚度以英吋為單位。

LookupCurrentConditionsRequest

LookupCurrentConditions RPC 的要求。

欄位
location

LatLng

必要欄位。要取得目前天氣狀況的位置。
units_system

UnitsSystem

(選用步驟) 用於傳回天氣狀況的單位系統。如未提供，傳回的天氣狀況將採用公制單位 (預設值 = METRIC)。
language_code

string

(選用步驟) 允許用戶端選擇回覆的語言。如果無法提供該語言的資料，API 會使用最接近的語言。有效值須符合 IETF BCP-47 標準。預設值為「en」。

LookupCurrentConditionsResponse

LookupCurrentConditions RPC 的回應 - 代表要求位置的目前天氣狀況。

欄位
current_time

Timestamp

與傳回資料相關聯的目前時間 (世界標準時間)。
time_zone

TimeZone

要求位置的時區。
weather_condition

WeatherCondition

目前的天氣狀況。
temperature

Temperature

目前溫度。
feels_like_temperature

Temperature

要求地點目前的體感溫度。
dew_point

Temperature

目前的露點溫度。
heat_index

Temperature

目前的酷熱指數溫度。
wind_chill

Temperature

目前風寒指數，即皮膚暴露在空氣中的溫度。
precipitation

Precipitation

目前的降水機率，以及過去一小時的累積降水量。
air_pressure

AirPressure

目前的氣壓狀況。
wind

Wind

目前的風況。
visibility

Visibility

目前的瀏覽權限。
current_conditions_history

CurrentConditionsHistory

過去 24 小時內現況的變化。
is_daytime

bool

如果要求位置的目前時間介於當地日出時間 (含) 和日落時間 (不含) 之間，則為 True。否則就是夜間 (日落到下一次日出之間)。
relative_humidity

int32

目前的相對濕度百分比 (值介於 0 到 100)。
uv_index

int32

目前的紫外線指數。
thunderstorm_probability

int32

目前雷雨機率 (值介於 0 到 100 之間)。
cloud_cover

int32

目前雲層遮蔽天空的百分比 (值介於 0 到 100 之間)。

CurrentConditionsHistory

代表過去 24 小時內現況的一系列變化。

欄位
temperature_change

Temperature

目前溫度減去 24 小時前的溫度。
max_temperature

Temperature

過去 24 小時內的最高溫。
min_temperature

Temperature

過去 24 小時的最低溫。
snow_qpf

QuantitativePrecipitationForecast

過去 24 小時內累積的雪量，以等量的液態水測量。注意：QPF 是定量降水預報的縮寫 (詳情請參閱「定量降水預報」定義)。
qpf

QuantitativePrecipitationForecast

過去 24 小時內累積的降雨量，以等量的液態水測量。注意：QPF 是定量降水預報的縮寫 (詳情請參閱「定量降水預報」定義)。

LookupForecastDaysRequest

要求 LookupForecastDays RPC。

欄位
location

LatLng

必要欄位。取得每日天氣預報的位置。
units_system

UnitsSystem

(選用步驟) 用於傳回天氣狀況的單位系統。如未提供，傳回的天氣狀況將採用公制單位 (預設值 = METRIC)。
page_size

int32

(選用步驟) 每頁傳回的每日預報記錄數量上限，值介於 1 到 10 (含)。預設值為 5。
page_token

string

(選用步驟) 先前要求傳回的頁面符記。用於擷取後續網頁。
days

int32

(選用步驟) 限制從當天起可擷取的總天數，值介於 1 到 10 (含)。預設值為允許的最大值 10。
language_code

string

(選用步驟) 允許用戶端選擇回覆的語言。如果無法提供該語言的資料，API 會使用最接近的語言。有效值須符合 IETF BCP-47 標準。預設值為「en」。

LookupForecastDaysResponse

LookupForecastDays RPC 的回應。

欄位
forecast_days[]

ForecastDay

每日預測記錄，視要求中指定的天數和網頁大小而定。
time_zone

TimeZone

要求位置的時區。
next_page_token

string

用於擷取下一頁的權杖。

LookupForecastHoursRequest

要求 LookupForecastHours RPC。

欄位
location

LatLng

必要欄位。要取得每小時天氣預報的地點。
units_system

UnitsSystem

(選用步驟) 用於傳回天氣狀況的單位系統。如未提供，傳回的天氣狀況將採用公制單位 (預設值 = METRIC)。
page_size

int32

(選用步驟) 每頁傳回的小時預報記錄數量上限，值介於 1 到 24 (含首尾值)。預設值為允許上限 24。
page_token

string

(選用步驟) 先前要求傳回的頁面符記。用於擷取後續網頁。
hours

int32

(選用步驟) 限制從目前小時開始擷取的總時數，值介於 1 到 240 (含首尾值)。預設值為允許的最大值 240。
language_code

string

(選用步驟) 允許用戶端選擇回覆的語言。如果無法提供該語言的資料，API 會使用最接近的語言。有效值須符合 IETF BCP-47 標準。預設值為「en」。

LookupForecastHoursResponse

LookupForecastHours RPC 的回應。

欄位
forecast_hours[]

ForecastHour

每小時的預報記錄，視要求中指定的小時數和頁面大小而定。
time_zone

TimeZone

要求位置的時區。
next_page_token

string

用於擷取下一頁的權杖。

LookupHistoryHoursRequest

LookupHistoryHours RPC 的要求。

欄位
location

LatLng

必要欄位。要取得每小時歷史資料的位置。
units_system

UnitsSystem

(選用步驟) 用於傳回天氣狀況的單位系統。如未提供，傳回的天氣狀況將採用公制單位 (預設值 = METRIC)。
page_size

int32

(選用步驟) 每頁傳回的小時記錄數上限，值介於 1 到 24 (含首尾)。預設值為允許上限 24。
page_token

string

(選用步驟) 先前要求傳回的頁面符記。用於擷取後續網頁。
hours

int32

(選用步驟) 限制要從最後一小時開始擷取的總時數，範圍為 1 到 24 (含)。預設值為允許上限 24。
language_code

string

(選用步驟) 允許用戶端選擇回覆的語言。如果無法提供該語言的資料，API 會使用最接近的語言。有效值須符合 IETF BCP-47 標準。預設值為「en」。

LookupHistoryHoursResponse

LookupHistoryHours RPC 的回應。

欄位
history_hours[]

HistoryHour

每小時的歷史記錄，視要求中指定的小時數和網頁大小而定。
time_zone

TimeZone

要求位置的時區。
next_page_token

string

用於擷取下一頁的權杖。

LookupPublicAlertsRequest

LookupPublicAlerts RPC 的要求。

欄位
location

LatLng

必要欄位。要接收災害天氣警報的地點。服務會傳回受影響區域與這個位置相交的警報。
page_size

int32

(選用步驟) 每頁傳回的公開天氣警報記錄數量上限。
page_token

string

(選用步驟) 屬於接收自前一個 LookupPublicAlerts 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時，提供至 LookupPublicAlerts 的所有其他參數須與提供網頁權杖的呼叫相符。
language_code

string

(選用步驟) 允許用戶端選擇回覆的語言。如果無法提供該語言的資料，API 會使用最接近的語言。有效值須符合 IETF BCP-47 標準。預設值為「en」。

LookupPublicAlertsResponse

LookupPublicAlerts 遠端程序呼叫 (RPC) 的回應。

欄位
weather_alerts[]

PublicAlerts

公開天氣警報記錄，視要求中指定的警報數量和網頁大小而定。
region_code

string

與要求中提供的位置資訊對應的區域 ISO_3166-1 alpha-2 代碼。地區以 ISO_3166-1_alpha-2 表示。
next_page_token

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

MoonEvents

代表與月亮相關的事件 (例如月出、月落)。

欄位
moonrise_times[]

Timestamp

月球上肢出現在地平線上的時間 (請參閱 https://en.wikipedia.org/wiki/Moonrise_and_moonset)。

注意：在大多數情況下，每天只會顯示一次月出時間。在其他情況下，清單可能會空白 (例如月亮在隔天午夜後升起)。不過，在特殊情況下 (例如極地地區)，清單可能包含多個值。在這些情況下，值會以遞增順序排序。
moonset_times[]

Timestamp

月球上緣消失在地平線下的時間 (請參閱 https://en.wikipedia.org/wiki/Moonrise_and_moonset)。

注意：在大多數情況下，每天只會有一段月出時間。在其他情況下，清單可能會是空白 (例如月亮在隔天午夜後落下)。不過，在特殊情況下 (例如極地地區)，清單可能包含多個值。在這些情況下，值會以遞增順序排序。
moon_phase

MoonPhase

月相。

MoonPhase

標示月相。

列舉
MOON_PHASE_UNSPECIFIED 未指定月相。
NEW_MOON 月球未受到太陽照射。
WAXING_CRESCENT 在北半球，月球右側的亮面為 0% 至 50% 🌒；在南半球，月球左側的亮面為 0% 至 50% 🌘。
FIRST_QUARTER 在北半球，月球右側有 50.1% 的面積受到照亮 🌓；在南半球，月球左側有 50.1% 的面積受到照亮 🌗。
WAXING_GIBBOUS 北半球的月亮右側會亮起 50% 至 100% 的光芒 🌔，南半球的月亮左側則會亮起 50% 至 100% 的光芒 🌖。
FULL_MOON 月亮完全被照亮。
WANING_GIBBOUS 北半球的月亮左側有 50% 至 100% 的面積受到照亮 🌖，南半球的月亮右側有 50% 至 100% 的面積受到照亮 🌔。
LAST_QUARTER 北半球的月球左側有 50.1% 的面積受到照亮 🌗，南半球的月球右側有 50.1% 的面積受到照亮 🌓。
WANING_CRESCENT 北半球的月亮左側有 0% 至 50% 的部分會亮起 🌘，南半球則為右側 🌒。

降水率

代表特定位置的一組降水量值。

欄位
probability

PrecipitationProbability

降雨機率 (值介於 0 到 100)。
snow_qpf

QuantitativePrecipitationForecast

一段時間內累積的雪量，以等量的液態水測量。注意：QPF 是定量降水預報的縮寫 (詳情請參閱「定量降水預報」定義)。
qpf

QuantitativePrecipitationForecast

一段時間內累積的降雨量，以等量的液態水測量。注意：QPF 是定量降水預報的縮寫 (詳情請參閱「定量降水預報」定義)。

PrecipitationProbability

代表指定位置的降雨機率。

欄位
type

PrecipitationType

指出降水類型的代碼。
percent

int32

降水機率，範圍為 0 到 100。

PrecipitationType

代表指定地點的降水類型。

列舉
PRECIPITATION_TYPE_UNSPECIFIED 未指定降水類型。
NONE 不會降水。
SNOW 降雪。
RAIN 降雨。
LIGHT_RAIN 小雨。
HEAVY_RAIN 大雨。
RAIN_AND_SNOW 降雨和降雪。
SLEET 雨夾雪。
FREEZING_RAIN 凍雨。

PublicAlerts

代表災害示警。

欄位
alert_id

string

這項快訊的專屬 ID。
alert_title

LocalizedText

快訊的本地化標題。
event_type

WeatherEventType

天氣事件類型。
area_name

string

發布警報的區域名稱。
instruction[]

string

發布商建議的指示。請注意，雖然這個欄位應經過本地化，但我們無法保證一定會本地化。
safety_recommendations[]

SafetyRecommendation

向使用者提供安全建議，這些建議可由發布者或其他機構提供。
timezone_offset

string

快訊所在位置與世界標準時間的時區偏移量。值的格式為以「s」結尾的字串，例如 「-14400s」表示比世界標準時間慢 4 小時。
start_time

Timestamp

活動開始時間。
expiration_time

Timestamp

活動的到期時間。
data_source

DataSource

發出快訊的發布者詳細資料。
polygon

string

發布快訊的區域，以 GeoJSON 格式表示。

GeoJSON 資料必須採用 RFC 7946 格式，並代表多邊形 (單一連續區域) 或多重多邊形 (多個不同區域)。

範例：

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

MultiPolygon GeoJson 字串範例如下：

{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

官方機構發布的最新警報說明文字。請注意，雖然這個欄位應經過本地化，但我們無法保證一定會本地化。
severity

Severity

快訊的嚴重程度。
certainty

Certainty

快訊的確定度。
urgency

Urgency

快訊的緊急程度。

發布商

快訊發布者。

列舉
PUBLISHER_UNSPECIFIED 未指定發布者。
AUSTRALIA_ACT_ESA 澳洲首都特區
AUSTRALIA_NSW_RFS 新南威爾斯
AUSTRALIA_QLD_QFES 昆士蘭
AUSTRALIA_SA_CFS 南澳洲
METEO_ALARM_AT Meteoalarm / EUMETNET Austria
METEO_ALARM_BS 波士尼亞
BRAZIL_CENAD 巴西災害機構
BRAZIL_INMET 巴西氣象局
UK_ENV_AGENCY 英國
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaria
METEO_ALARM_CR 克羅埃西亞
METEO_ALARM_CY 賽普勒斯
METEO_ALARM_CS 捷克
METEO_ALARM_DK 丹麥
EC_INAMHI 厄瓜多
METEO_ALARM_FI Meteoalarm / EUMETNET Finland
METEO_ALARM_FR 法國
DE_DWD 德國
METEO_ALARM_GB Meteoalarm / 歐洲氣象網英國
METEO_ALARM_GR 希臘
METEO_ALARM_HU 匈牙利
METEO_ALARM_IS 冰島
METEO_ALARM_IE 愛爾蘭
METEO_ALARM_IT 義大利
JM_JMS 牙買加
JMA 日本
METEO_ALARM_NL Meteoalarm / EUMETNET Netherlands
METEO_ALARM_LV 拉脫維亞
METEO_ALARM_LT 立陶宛
METEO_ALARM_LU 盧森堡
MEXICO_CIRES 墨西哥墨西哥 CIRES
NZ_GEONET 紐西蘭 GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / 歐洲氣象網北馬其頓
METEO_ALARM_NO 挪威
PHILIPPINES_PAGASA 菲律賓
METEO_ALARM_PL Meteoalarm / EUMETNET Poland
METEO_ALARM_PT 葡萄牙
METEO_ALARM_RO 羅馬尼亞
METEO_ALARM_RS 塞爾維亞
SG_MSS 新加坡
METEO_ALARM_SK Meteoalarm / 歐洲氣象網斯洛伐克
METEO_ALARM_SI 斯洛維尼亞
SB_MET 索羅門群島
METEO_ALARM_ES Meteoalarm / EUMETNET Spain
METEO_ALARM_SE 瑞典
METEO_ALARM_CH 瑞士
TAIWAN_NCDR 台灣
NOAA 美國國家海洋和大氣管理局 (NOAA)
WCATWC 美國國家海嘯預警中心

QuantitativePrecipitationForecast

代表特定區域在特定時間內累積的預期降水量 (參考資料：https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast)，通常簡稱為 QPF。

欄位
unit

Unit

用來測量累積降水量的單位代碼。
quantity

float

一段時間內累積的降水量，以等量的液態水測量。

單位

代表用來測量累積降水量的單位。

列舉
UNIT_UNSPECIFIED 未指定降水單位。
MILLIMETERS 降水量以公釐為單位。
INCHES 降雨量以英吋為單位。

SafetyRecommendation

代表安全建議。

欄位
directive

string

給使用者的指示。請注意，雖然這個欄位應經過本地化，但我們無法保證一定會本地化。
subtext

string

指令的選用副文字，可包含使用者的額外背景資訊。請注意，雖然這個欄位應經過本地化，但我們無法保證一定會本地化。

嚴重性

表示快訊訊息主題事件嚴重程度的代碼。

列舉
SEVERITY_UNKNOWN 嚴重程度不明。
EXTREME 生命或財產受到極大威脅。
SEVERE 生命或財產受到重大威脅。
MODERATE 生命或財產可能受到威脅。
MINOR 生命或財產受到輕微威脅。

SpeedUnit

代表用於測量速度的單位。

列舉
SPEED_UNIT_UNSPECIFIED 未指定速度單位。
KILOMETERS_PER_HOUR 速度的測量單位為每小時公里數。
MILES_PER_HOUR 速度的測量單位為英里/小時。

SunEvents

代表與太陽相關的事件 (例如日出、日落)。

欄位
sunrise_time

Timestamp

太陽升起的時間。

注意：在某些特殊情況下 (例如北極圈以北)，當天可能沒有日出時間。在這些情況下，這個欄位會保持未設定狀態。
sunset_time

Timestamp

太陽下山的時間。

注意：在某些特殊情況下 (例如北極圈以北)，一天可能沒有日落時間。在這些情況下，這個欄位會保持未設定狀態。

溫度

代表溫度值。

欄位
unit

TemperatureUnit

用來測量溫度值的單位代碼。
degrees

float

指定單位的溫度值 (以度為單位)。

TemperatureUnit

代表用於測量溫度的單位。

列舉
TEMPERATURE_UNIT_UNSPECIFIED 未指定溫度單位。
CELSIUS 溫度單位為攝氏。
FAHRENHEIT 溫度單位為華氏。

UnitsSystem

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

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

急迫性

表示快訊訊息主題事件緊急程度的代碼。

列舉
URGENCY_UNKNOWN 緊急程度不明。
IMMEDIATE 應立即採取回應措施。
EXPECTED 應盡快採取相應行動 (在接下來的一小時內)。
FUTURE 應在不久的將來採取相應行動。
PAST 您無須再採取任何行動。

顯示設定

代表能見度條件，也就是可辨識物體的距離。

欄位
unit

Unit

代表用於測量距離的單位。
distance

float

以指定單位表示的能見度距離。

單位

代表用於測量可見距離的單位。

列舉
UNIT_UNSPECIFIED 未指定曝光單位。
KILOMETERS 能見度以公里為單位。
MILES 能見度以英里為單位。

WeatherCondition

代表特定時間範圍內特定地點的天氣狀況。

免責事項：天氣圖示和狀況代碼可能會變更。Google 可能會視需要推出新代碼和圖示，或更新現有代碼和圖示。建議您定期參閱這份文件，掌握最新資訊。

欄位
icon_base_uri

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

LocalizedText

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

Type

天氣狀況類型。

類型

在預報元素的環境中標示天氣狀況類型。

列舉
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 大雷雨。

WeatherEventType

天氣事件類型。

列舉
WEATHER_EVENT_TYPE_UNSPECIFIED 未指定的氣象事件類型。
ACID_RAIN 酸雨事件。
AFTERSHOCK 餘震事件。
AVALANCHE 雪崩事件。
BLIZZARD 暴風雪事件。
BLOWING_SNOW 高吹雪事件。
BUSHFIRE 林火事件。
COASTAL_FLOOD 沿海地區發生洪水。
COASTAL_HAZARD 海岸災害事件。
COLD 冷事件。
CYCLONE 氣旋事件。
DROUGHT 乾旱事件。
DUST_STORM 沙塵暴事件。
EARTHQUAKE 地震事件。
EXTRATROPICAL_CYCLONE 溫帶氣旋事件。
FIRE 火災事件。
FIRE_WEATHER 火災天氣事件。
FLASH_FLOOD 暴洪事件。
FLOOD 洪水事件。
FOG 起霧事件。
FREEZING 凍結事件。
FREEZING_AIR_TEMPERATURE 氣溫驟降事件。
FREEZING_DRIZZLE 凍毛雨事件。
FREEZING_RAIN_EVENT 凍雨事件。
FROST 結霜事件。
GALE 大風事件。
GLAZE Glaze 事件。
HAIL 冰雹事件。
HAZARDOUS_SEAS 危險海相事件。
HEAT 熱浪事件。
HUMIDITY 濕度事件。
HURRICANE 颶風事件。
ICE_STORM 冰暴事件。
INDUSTRIAL_FIRE 工業火災事件。
LAKE_EFFECT_SNOW 大湖效應降雪事件。
LANDSLIDE 山崩事件。
MONSOON 季風事件。
MUDDY_FLOOD 泥水洪水事件。
OUTFLOW 外流事件。
RADIATION 輻射事件。
RAIN_EVENT 下雨。
RIVER_FLOODING 河水氾濫事件。
SEVERE_THUNDERSTORM_WARNING 嚴重雷雨警報事件。
SNOWSQUALL 雪颮事件。
SNOW_EVENT 下雪。
STORM 暴風雨事件。
STORM_SURGE 風暴湧浪事件。
THUNDER 雷電事件。
THUNDERSTORM 雷雨事件。
TORNADO 龍捲風事件。
TORNADO_WARNING 龍捲風警報事件。
TROPICAL_CYCLONE 熱帶氣旋事件。
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES 熱帶氣旋警報和觀測事件。
TROPICAL_DISTURBANCE 熱帶擾動事件。
TROPICAL_STORM 熱帶風暴事件。
TSUNAMI 海嘯事件。
TYPHOON 颱風事件。
VOLCANIC_ASH 火山灰事件。
VOLCANIC_ERUPTION 火山爆發事件。
WILDFIRE 野火事件。
WIND 風事件。
WIND_CHILL 風寒效應事件。
WIND_WAVE 風浪事件。
WINTER_STORM 冬季暴風活動。

風速

代表一組風力屬性。

欄位
direction

WindDirection

風向，即風吹來的角度。
speed

WindSpeed

風速。
gust

WindSpeed

陣風 (風速突然增加)。

WindDirection

代表風的來源方向。

欄位
cardinal

CardinalDirection

代表風向的方位代碼。
degrees

int32

風向 (以度為單位，值介於 0 到 360 之間)。

WindSpeed

代表風速。

欄位
unit

SpeedUnit

代表風速測量單位的代碼。
value

float

風速值。