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

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

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

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

サポートされている気象現象の完全なリストについては、気象現象 の種類をご覧ください。

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

この 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 列挙型 リクエストされた場所の地域コード。 省略可

データソース

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

フィードに含まれるプロバイダは、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-FranceMeteoAlarm 経由)
ドイツ DWD - ドイツ気象局(The German Weather Service)
ガーナ 国立気象庁(Agence Nationale de la Météorologie)
ギリシャ ギリシャ国立気象局(Hellenic National Meteorological Service)(MeteoAlarm 経由)
ハンガリー 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 経由)
ルクセンブルク MeteoLuxMeteoAlarm 経由)
マダガスカル マダガスカル気象庁(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 経由)
シンガポール シンガポール気象局(Meteorological Service Singapore)
スロバキア スロバキア水文気象研究所(Slovak Hydrometeorological Institute)MeteoAlarm 経由)
スロベニア スロベニア水文気象研究所(Hydrometeorological Institute of Slovenia)MeteoAlarm 経由)
ソロモン諸島 ソロモン諸島気象局(Solomon Islands Meteorological Services)
韓国 韓国気象庁(Korea Meteorological Administration)
スペイン スペイン気象庁(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)
ベトナム 国立水文気象予測センター(National Center for Hydrometeorological Forecasting)

アトリビューション

データが表示されるすべての画面で、お客様のアプリケーションは dataSource フィールドを使用して元のソースへのアトリビューションを含める必要があります。

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

アトリビューションには、データソースの完全な名前( name フィールドに記載)と、 authorityUri フィールドに記載されている URL を使用したデータソースへのハイパーリンク(例: "National Weather Service")を含める必要があります。

気象現象の種類

次の気象現象の種類がサポートされています。

気象現象の種類
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 フィールドの翻訳のみを提供します。eventTypeareaNameinstructionsafetyRecommendations などの他のフィールドも、元のデータソースの言語サポートに応じて翻訳される場合がありますが、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 ウィンドウを開きます。