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 |
列挙型 | アラートの確実性のレベル:
|
省略可 |
urgency |
列挙型 | アラートの緊急度のレベル:
|
省略可 |
instruction |
文字列 | 対象グループ向けに対応措置の手順の説明。 | 省略可 |
safetyRecommendations |
文字列 | 公的機関のコードに基づく安全に関する推奨事項。最上位の指示と、追加情報を含むサブテキストが含まれます。 | 省略可 |
timezoneOffset |
文字列 | イベントのタイムゾーン オフセット(+/-HH:MM 形式)。 | 必須 |
startTime |
DateTime | アラート メッセージ内の情報の有効なエポック日時(UTC 時間)。 | 省略可 |
expirationTime |
DateTime | アラートが終了すると予想されるエポック日時(UTC 時間)。無期限に続くイベントの場合は null になることがあります。その場合、見出しにはイベントが「有効」であることが示されます。 | 省略可 |
dataSource |
列挙型 | 発行元、名前、URL などの機関の詳細。 | 必須 |
regionCode |
列挙型 | リクエストされた場所の地域コード。 | 省略可 |
データソース
気象警報エンドポイントは、次の表に記載されているプロバイダが公開したデータを返します。リクエストで指定された緯度と経度の座標に基づいて、レスポンス本文には適切な地方自治体のデータが表示されます。
フィードに含まれるプロバイダは、Google の災害情報 のガイドラインに準拠しています。Google は、プロバイダのリストを随時更新する可能性があります。
アトリビューション
データが表示されるすべての画面で、お客様のアプリケーションは dataSource フィールドを使用して元のソースへのアトリビューションを含める必要があります。
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
アトリビューションには、データソースの完全な名前(
name フィールドに記載)と、
authorityUri フィールドに記載されている URL を使用したデータソースへのハイパーリンク(例: "National Weather
Service")を含める必要があります。
気象現象の種類
次の気象現象の種類がサポートされています。
| 気象現象の種類 | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
レスポンスの翻訳の動作
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 オプションに慣れることができます。
ページの右側にある API アイコン api を選択します。
必要に応じてリクエスト パラメータを編集します。
[実行] ボタンを選択します。ダイアログで、リクエストの送信に使用するアカウント を選択します。
API Explorer パネルで、全画面表示アイコン fullscreen を選択して API Explorer ウィンドウを開きます。