Method: publicAlerts.lookup

指定した場所の公共の気象警報を返します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
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

このアラートの固有識別子。
alertTitle

object (LocalizedText)

アラートのローカライズされたタイトル。
eventType

enum (WeatherEventType)

気象イベントのタイプ。
areaName

string

アラートが発行される地域の名前。
instruction[]

string

パブリッシャーが推奨する手順。このフィールドはローカライズされるべきですが、ローカライズされることが保証されているわけではありません。
safetyRecommendations[]

object (SafetyRecommendation)

ユーザーに対する安全に関する推奨事項の指示。パブリッシャーまたはその他の機関から提供される場合があります。
timezoneOffset

string

アラートの場所の UTC からのタイムゾーン オフセット。値は「s」で終わる文字列としてフォーマットされます（例: UTC より 4 時間遅れている場合は「-14400s」。
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 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 応答アクションはすぐに（1 時間以内）実行すべきです。
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

当局のウェブサイトの URL。

パブリッシャー

アラートのパブリッシャー。

列挙型
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 / EUMETNET 英国
METEO_ALARM_GR ギリシャ
METEO_ALARM_HU ハンガリー
METEO_ALARM_IS アイスランド
METEO_ALARM_IE アイルランド
METEO_ALARM_IT イタリア
JM_JMS ジャマイカ
JMA 日本
METEO_ALARM_NL Meteoalarm / EUMETNET オランダ
METEO_ALARM_LV ラトビア
METEO_ALARM_LT リトアニア
METEO_ALARM_LU ルクセンブルク
MEXICO_CIRES メキシコ メキシコ CIRES
NZ_GEONET ニュージーランド ニュージーランド GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET 北マケドニア
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 / EUMETNET Slovakia
METEO_ALARM_SI スロベニア
SB_MET ソロモン諸島
METEO_ALARM_ES Meteoalarm / EUMETNET Spain
METEO_ALARM_SE スウェーデン
METEO_ALARM_CH スイス
TAIWAN_NCDR 台湾
NOAA 米国海洋大気庁
WCATWC 米国津波警報センター