天気に関するアラートを受け取る

publicAlerts エンドポイントは、信頼できる国内および国際機関が発行した特定の気象イベント アラートの詳細を提供します。これらのアラートは、生命を救う可能性のある重要な情報を提供します。

このエンドポイントは、指定された緯度と経度でリアルタイムに発生している天気アラートを返します。サポートされている気象イベントは次のとおりです。

• 降水量: 雨、雪、雹、干ばつなど
• 極端な温度: 寒さ、暑さ、凍結、霜、風冷え、湿度
• 風と嵐のイベント: ブリザード、ハリケーン、竜巻、熱帯低気圧、雷雨など
• 視界不良: 霧、砂嵐、吹雪
• 水関連の危険: 洪水、津波、高潮、海岸 危険区域など
• 地球物理学的事象と地質学的事象: 地震、地滑り、火山活動
• 火災: 山火事、火災気象など

サポートされている気象イベントの完全なリストについては、気象イベントのタイプをご覧ください。

注意: 天気アラートは複雑な場合があり、異なるソース間で一貫した基準、形式、ルールが必ずしも適用されるとは限りません。Google はデータの整合性とタイムリーな可用性を確保するよう努めていますが、コンテンツ、品質、更新頻度は信頼できるソースに依存しており、そのソースから更新が発行されるたびに変更される可能性があります。Google は、天気アラートが更新されることや、プロバイダのデータに関連する問題が特定の期間内に解決されることを保証するものではありません。

アラートには、データソースから利用可能な情報に応じて、ローカライズされた説明が含まれる場合と含まれない場合があります。データソースの制限により、情報はそのまま（未加工のコンテンツ）で提供されます。天気アラートのソースについて詳しくは、データソースをご覧ください。

この API は、特定の天気アラートに関する次の情報を返します。

• アラートに関連付けられている気象イベントの種類
• 影響を受けた地域のリストと、その地域の地理的境界を定義する座標
• 気象現象の概要を 1 文で説明します。
• 重大度、確実性、緊急度のレベル
• 対象ユーザー向けの行動推奨手順の説明
• 安全に関する推奨事項
• アラートの開始時刻と終了時刻
• 発行機関の名前とウェブサイト

API Explorer を使用すると、ライブ リクエストを行って、API と API オプションを理解できます。

試してみる

天気アラートのリクエストについて

天気アラート情報をリクエストするには、次の URL に HTTP GET リクエストを送信します。

https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE

リクエスト URL パラメータに、場所の緯度と経度の座標を含めます。

注: 言語コード パラメータを含めることは省略可能で、アラートのタイトルのみが翻訳されます。天気アラートのデータはパートナー機関からそのまま（未加工のコンテンツ）提供されるため、指示や安全に関する推奨事項は、機関が公開した元の言語で返されます。詳細については、レスポンスの翻訳の動作をご覧ください。

天気アラートの回答について

Weather API は、レスポンスの本文で次のフィールドを返します。

フィールド	タイプ	説明	必須または省略可
alertId	文字列	アラート ID。この情報は、データ プロバイダのウェブサイトでも確認できます。	必須
alertTitle	文字列	天気イベントを説明するアラートのタイトル。 注: リクエストに言語コード パラメータが含まれている場合、この文字列のみが翻訳されます。	必須
eventType	列挙型	アラートに関連付けられている気象イベントのタイプ。 サポートされている気象イベントの完全なリストについては、気象イベントのタイプをご覧ください。	必須
areaName	文字列	アラートの影響を受ける地域名。リクエストされた場所が含まれます。	必須
polygon	文字列	アラートの閉じた次元領域を定義する座標。	省略可
description	文字列	指定された言語でイベントの説明を要約した短いフレーズ（例: 「竜巻警報」）。	省略可
severity	列挙型	アラートの重大度レベル: 極めて重大: 生命や財産に関わる極めて重大な脅威 重大: 命や財産に関わる重大な脅威 中: 生命や財産が危険にさらされる可能性がある 軽微: 生命や財産に対する既知の脅威がほとんどないか、まったくない 不明: 重大度不明	省略可
certainty	列挙型	アラートの確実性のレベル: 確認済み: 発生した、または発生中であると判断された 可能性が非常に高い: 発生した可能性が非常に高い、または発生中である 可能性が高い: 発生した、または発生中である可能性が高い（p > ~50%） 可能性あり: 発生した可能性はあるが、発生した可能性は低いか、継続中の可能性は低い（p <= ~50%） 可能性が低い: 発生する可能性は低い（p ~ 0） 不明: 確実性が不明	省略可
urgency	列挙型	アラートの緊急度: 緊急: 応答アクションは直ちに実行すべきです 期待されること: 応答アクションはまもなく（1 時間以内）実行されるべきです 今後: 近い将来にレスポンス アクションを実施すべきです 過去: 対応は不要になりました 不明: 緊急度不明	省略可
instruction	文字列	対象ユーザー向けのレスポンシブ アクションの手順の説明。	省略可
safetyRecommendations	文字列	行政機関のコードに基づく安全に関する推奨事項。最上位のディレクティブと、追加情報を含むサブテキストが含まれます。	省略可
timezoneOffset	文字列	イベントのタイムゾーン オフセット（+/-HH:MM 形式）。	必須
startTime	DateTime	アラート メッセージ内の情報の有効なエポック日時（UTC 時間）。	省略可
expirationTime	DateTime	アラートが終了する予定のエポック日時（UTC）。期間が未定のイベントの場合は null になることがあります。その場合、見出しにはイベントが「有効」であることが示されます。	省略可
dataSource	列挙型	発行元、名前、URL などの機関の詳細。	必須
regionCode	列挙型	リクエストされた場所の地域コード。	省略可

注: リクエストされた場所にアクティブなアラートがない場合、または元のプロバイダの必須フィールドが欠落している場合、レスポンス本文には regionCode フィールドのみが含まれます。元のプロバイダのオプション フィールドが欠落している場合、オプション フィールドはレスポンスの本文から省略されます。

データソース

天気アラート エンドポイントは、次の表に記載されているプロバイダが公開したデータを返します。リクエストで指定された緯度と経度の座標に基づいて、レスポンスの本文には適切な地方自治体のデータが表示されます。

フィードに含まれるプロバイダは、Google の災害情報に関するガイドラインに準拠しています。Google はプロバイダのリストを随時更新する場合があります。

国	代理店
オーストラリア	ACT 緊急サービス局（ACT Emergency Services Agency、ACT ESA）
	ニュー サウス ウェールズ州地方消防局（New South Wales Rural Fire Service、NSW RFS）
	南オーストラリア州消防局（South Australian Country Fire Service、SA CFS）
	タスマニア州消防局（Tasmania Fire Service、TFS）
	クイーンズランド州火災・緊急サービス（Queensland Fire and Emergency Services、QFES）
オーストリア	GeoSphere オーストリア（GeoSphere Austria）（MeteoAlarm 経由）
ベルギー	ベルギー王立気象研究所（Royal Meteorological Institute of Belgium）（MeteoAlarm 経由）
ボスニア ヘルツェゴビナ	連邦水文気象研究所（FHMZ: Federal Hydro-meteorological Institute）（MeteoAlarm 経由）
ブルガリア	国家気象・水文研究所（National Institute of Meteorology & Hydrology）（MeteoAlarm 経由）
ブラジル	国家災害リスク管理センター（Centro Nacional de Gerenciamento de Riscos e Desastres、CENAD）
	国立気象研究所（Instituto Nacional de Meteorologia、INMET）
コロンビア	国家災害リスク管理局（Unidad Nacional para la Gestión del Riesgo de Desastres、UNGRD）
コートジボワール	空港・気象台開発・運営会社（Société d'Exploitation et de Développement Aéroportuaire, Aéronautique et Météorologique）
クロアチア	クロアチア気象水文局（Croatian Meteorological and Hydrological Service）（MeteoAlarm 経由）
キプロス	気象庁（Department of Meteorology）（MeteoAlarm 経由）
チェコ	チェコ気象庁（Czech Hydrometeorological Institute）（MeteoAlarm 経由）
デンマーク	デンマーク気象研究所（Danish Meteorological Institute）（MeteoAlarm 経由）
エクアドル	国立水文気象研究所（Instituto Nacional de Meteorología e Hidrología）
エストニア	気候省（Ministry of Climate）（MeteoAlarm 経由）
フィンランド	フィンランド気象研究所（Finnish Meteorological Institute）（MeteoAlarm 経由）
フランス	フランス気象局（Météo-France）（MeteoAlarm 経由）
ドイツ	DWD - ドイツ気象局（The German Weather Service）
ギリシャ	ギリシャ国立気象局（Hellenic National Meteorological Service）（MeteoAlarm 経由）
ギニア	国立気象庁（Agence Nationale de la Météorologie）
ハンガリー	HungaroMet 非営利株式会社（HungaroMet Nonprofit Zrt）（MeteoAlarm 経由）
アイスランド	アイスランド気象庁（Icelandic Meteorological Office）（MeteoAlarm 経由）
アイルランド	アイルランド気象局（Met Eirann）（MeteoAlarm 経由）
イタリア	イタリア気象局（Italian Meteorological Service）（MeteoAlarm 経由）
ジャマイカ	ジャマイカ気象局（Meteorological Service of Jamaica）
日本	気象庁（JMA）
ラトビア	ラトビア環境地質気象センター（Latvian Environment, Geology and Meteorology Centre）（MeteoAlarm 経由）
リトアニア	リトアニア水文気象局（Lithuanian Hydrometeorological Service）（MeteoAlarm 経由）
ルクセンブルク	MeteoLux（MeteoAlarm 経由）
マダガスカル	マダガスカル気象庁（Météo Madagascar）
メキシコ	地震観測登録センター（Centro de Instrumentación y Registro Sísmico A.C.、CIRES）
オランダ	オランダ王立気象研究所（Royal Netherlands Meteorological Institute）（MeteoAlarm 経由）
北マケドニア	国立水文気象局（National Hydrometeorological Service）（MeteoAlarm 経由）
ノルウェー	ノルウェー気象研究所（Norwegian Meteorological Institute）（MeteoAlarm 経由）
ニュージーランド	ニュージーランド地質核科学研究所（GNS Science、GeoNet）
	MetService
フィリピン	フィリピン大気地球物理天文局（Philippine Atmospheric, Geophysical & Astronomical Services Administration、PAGASA）
ポーランド	気象・水管理研究所（Institute of Meteorology and Water Management）（MeteoAlarm 経由）
ポルトガル	ポルトガル海洋大気研究所（Portuguese Institute for Sea and Atmosphere）（MeteoAlarm 経由）
ルーマニア	国立気象局（National Meteorological Administration）（MeteoAlarm 経由）
セルビア	セルビア共和国水文気象研究所（Republic Hydrometeorological Institute of Serbia）（MeteoAlarm 経由）
シンガポール	シンガポール気象局
スロバキア	スロバキア水文気象研究所（Slovak Hydrometeorological Institute）（MeteoAlarm 経由）
スロベニア	スロベニア水文気象研究所（Hydrometeorological Institute of Slovenia）（MeteoAlarm 経由）
ソロモン諸島	ソロモン諸島気象局（Solomon Islands Meteorological Services）
韓国	韓国気象庁
スペイン	スペイン気象庁（State Meteorological Agency）（MeteoAlarm 経由）
スウェーデン	スウェーデン気象水文研究所（Swedish Meteorological and Hydrological Institute）（MeteoAlarm 経由）
スイス	連邦気象気候庁 MeteoSwiss（Federal Office of Meteorology and Climatology MeteoSwiss）（MeteoAlarm 経由）
台湾	国立減災科学技術センター（National Science and Technology Center for Disaster Reduction、NCDR）
タイ	タイ気象局（Thai Meteorological Department）
イギリス	英国気象庁（Met Office）（MeteoAlarm 経由）
	英国環境庁（UK Environment Agency）
米国	米国津波警報センター（National Tsunami Warning Center）
	米国国立気象局（US National Weather Service）
ベトナム	国立水文気象予測センター

アトリビューション

データが表示されるすべてのディスプレイで、顧客アプリケーションは dataSource フィールドを使用して元のソースへの帰属表示を含める必要があります。

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

帰属表示には、データソースのフルネーム（name フィールドで指定）と、authorityUri フィールドで指定された URL を使用したデータソースへのハイパーリンク（「国立気象局」など）を含める必要があります。

気象イベントの種類

次の天気イベント タイプがサポートされています。

気象イベントの種類
ACID_RAIN AVALANCHE BLIZZARD BLOWING_SNOW COASTAL_FLOOD COASTAL_HAZARD COLD CYCLONE DROUGHT EXTRATROPICAL_CYCLONE FIRE_WEATHER FLASH_FLOOD FLOOD FOG FREEZING FREEZING_AIR_TEMPERATURE FREEZING_DRIZZLE FREEZING_RAIN FROST GALE GLAZE HAIL HAZARDOUS_SEAS HEAT HUMIDITY HURRICANE ICE_STORM LAKE_EFFECT_SNOW MONSOON MUDDY_FLOOD OUTFLOW RAIN	RIVER_FLOODING SEVERE_THUNDERSTORM_WARNING SNOW SNOWSQUALL STORM STORM_SURGE THUNDER THUNDERSTORM TORNADO TORNADO_WARNING TROPICAL_CYCLONE TROPICAL_CYCLONE_WARNINGS_AND_WATCHES TROPICAL_DISTURBANCE TROPICAL_STORM TYPHOON WIND WIND_CHILL WIND_WAVE WINTER_STORM WILDFIRE BUSHFIRE FIRE LANDSLIDE EARTHQUAKE DUST_STORM AFTERSHOCK TSUNAMI VOLCANIC_ASH VOLCANIC_ERUPTION RADIATION

レスポンスの変換動作

Google は alertTitle フィールドの翻訳のみを提供します。eventType、areaName、instruction、safetyRecommendations などの他のフィールドも、元のデータソースの言語サポートに応じて翻訳される場合がありますが、Google はこれらのフィールドの独立した翻訳を提供することはできません。

リクエストに含まれる languageCode パラメータに基づいて、alertTitle フィールドには次の動作が想定されます。

• サポートされている languageCode: リクエストされた languageCode が提供され、サポートされている場合、リクエストされた言語でレスポンスが返されます。
• サポートされていない languageCode: リクエストされた languageCode がサポートされておらず、それに近い代替が見つからない場合、エンドポイントはデフォルトで英語でレスポンスを返します。
• languageCode が指定されていない場合: エンドポイントはデフォルトで英語のレスポンスを返します。

気象警報のリクエストの例

次の例では、ノースカロライナ州の町の天気アラート情報をリクエストしています。

curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635&location.longitude=-78.3168047&languageCode=en"

レスポンス本文は次のとおりです。

{
  "weatherAlerts": [
    {
      "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1",
      "alertTitle": {
        "text": "Flash Flood Warning",
        "languageCode": "en"
      },
      "eventType": "FLASH_FLOOD",
      "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC",
      "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],
        [-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000],
        [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000],
        [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000],
        [-78.350000,35.940000],[-78.450000,35.820000]]]}",
      "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for...
        \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina...
        \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina...
        \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen.
        \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding.
        Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas,
        highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include...
        \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.",
      "severity": "SEVERE",
      "certainty": "LIKELY",
      "urgency": "IMMEDIATE",
      "instruction": [
        "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles."
      ],
      "safetyRecommendations": [
        {
          "directive": "Build an emergency kit and make a family communications plan.",
          "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building 
            an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan."
        },
        {
          "directive": "Be aware that flash flooding can occur. ",
          "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move."
        },
        ...
      ],
      "timezoneOffset": "-14400s",
      "startTime": "2025-08-06T18:24:00Z",
      "expirationTime": "2025-08-06T21:30:00Z",
      "dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }
    }
  ],
  "regionCode": "US"
}

試してみよう:

API Explorer を使用すると、サンプル リクエストを作成して、API と API オプションを理解できます。

1. ページの右側にある API アイコン api を選択します。

2. 必要に応じてリクエスト パラメータを編集します。

3. [実行] ボタンを選択します。ダイアログで、リクエストの送信に使用するアカウントを選択します。

4. API Explorer パネルで、全画面アイコン fullscreen を選択して API Explorer ウィンドウを拡大します。