Method: publicAlerts.lookup

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

HTTP 要求

GET https://weather.googleapis.com/v1/publicAlerts:lookup

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
location

object (LatLng)

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

integer

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

string

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

string

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

要求主體

要求主體必須為空白。

回應主體

publicAlerts.lookup RPC 的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
欄位
weatherAlerts[]

object (PublicAlerts)

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

string

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

string

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

授權範圍

需要下列 OAuth 範圍：

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

PublicAlerts

代表災害示警。

JSON 表示法 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
欄位
alertId

string

這項快訊的專屬 ID。
alertTitle

object (LocalizedText)

快訊的本地化標題。
eventType

enum (WeatherEventType)

天氣事件類型。
areaName

string

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

string

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

object (SafetyRecommendation)

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

string

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

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"。
expirationTime

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"。
dataSource

object (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

enum (Severity)

快訊的嚴重程度。
certainty

enum (Certainty)

快訊的確定度。
urgency

enum (Urgency)

快訊的緊急程度。

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 冬季暴風活動。

嚴重性

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

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

確定度

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

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

急迫性

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

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

SafetyRecommendation

代表安全建議。

JSON 表示法 
{
  "directive": string,
  "subtext": string
}
欄位
directive

string

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

string

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

DataSource

代表資料來源的連結。

JSON 表示法 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
欄位
publisher

enum (Publisher)

快訊發布者。
name

string

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

string

主管機關網站的網址。

發布商

快訊發布者。

列舉
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 美國國家海嘯預警中心