Weather - Get Severe Weather Alerts
特定の場所のハリケーン、雷雨、洪水、落雷、熱波、森林火災などの厳しい気象条件に関する情報を取得するために使用します。
悪天候現象は、私たちの日常生活や事業運営に大きな影響を与える可能性があります。 たとえば、熱帯低気圧、強風、洪水などの厳しい気象条件により、道路が閉鎖され、物流会社が車両のルート変更を余儀なくされ、目的地への到着が遅れたり、冷蔵食品のコールドチェーンが中断されたりする可能性があります。
Get Severe Weather Alerts API は、政府の公式気象機関と、世界から地域の主要な気象警報プロバイダーの両方から世界中で利用できる悪天候警報を返す HTTP GET リクエストです。 このサービスは、アラートの種類、カテゴリ、レベルなどの詳細、およびハリケーン、雷雨、落雷、熱波、森林火災など、要求された場所のアクティブな重大アラートに関する詳細な説明を返すことができます。 詳細については、「悪天候アラートをリクエストする」を参照してください
GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}&language={language}&details={details}
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
format
|
path | True |
応答の目的の形式。
|
|
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
|
query
|
query | True |
number[] |
緯度の後に経度 (例: "47.641268,-122.125679") で構成されるコンマ区切り文字列として指定された該当するクエリ。 気象情報は、通常、陸上の場所、陸地に囲まれた水域、および海岸線から約 50 海里以内の海域で利用できます。 |
|
details
|
query |
string |
悪天候警報の詳細を返してください。 使用可能な値は次のとおりです
|
|
|
language
|
query |
string |
検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。 詳細については、サポートされている言語の を参照してください。 |
要求ヘッダー
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| x-ms-client-id |
string |
Microsoft Entra ID セキュリティ モデルでの使用を目的としたアカウントを示します。 Azure Maps アカウントのこの一意の ID は、 Azure Maps 管理プレーン アカウント API から取得できます。 Azure Maps で Microsoft Entra ID セキュリティを使用する方法の詳細については、「 Azure Maps での認証の管理」を参照してください。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
わかりました |
|
| Other Status Codes |
予期しないエラーが発生しました。 |
セキュリティ
AADToken
これらは、Microsoft Entra OAuth 2.0 フロー
シナリオを実装するには、 認証の概念を確認することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを介してアプリケーションをモデル化するためのソリューションを提供します。
Notes
- このセキュリティ定義では、 ヘッダーを使用して、アプリケーションがアクセスを要求している Azure Maps リソースを示す
x-ms-client-id。 これは、 Maps 管理 API から取得できます。
Authorization URL は、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、一意の承認 URL と Microsoft Entra ID 構成があります。
* Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を使用して、Azure 管理プレーン から構成されます。
* Azure Maps Web SDK を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。
- Microsoft ID プラットフォームの詳細については、「Microsoft ID プラットフォームの概要」を参照してください。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| 名前 | 説明 |
|---|---|
| https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portal で、または PowerShell、CLI、Azure SDK、または REST API を使用して Azure Maps アカウント を作成 場合にプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。
パブリックに公開されているアプリケーションの場合は、キーを安全に格納できるように、機密クライアント アプリケーション アプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。
型:
apiKey
/:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソース のリスト SAS 操作から作成される Shared Access Signature トークンです。
このトークンを使用すると、すべてのアプリケーションは、Azure ロールベースのアクセス制御と、特定のトークンに対する使用の有効期限、レート、およびリージョンに対するきめ細かな制御を使用してアクセスすることが承認されます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。
パブリックに公開されているアプリケーションの場合は、Map アカウント リソースの許可された配信元の特定の一覧を構成し、レンダリングの不正使用を制限し、SAS トークンを定期的に更新するように することをお勧めします。
型:
apiKey
/:
header
例
Successfully retrieve severe weather alerts
要求のサンプル
GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091
応答のサンプル
{
"results": [
{
"countryCode": "CA",
"alertId": 242621,
"description": {
"localized": "Heat Warning",
"english": "Heat Warning"
},
"category": "NON-PRECIPITATION",
"priority": 31,
"source": "Environment Canada",
"sourceId": 3,
"alertAreas": [
{
"name": "Kirkland Lake - Englehart",
"summary": "Heat Warning in effect until Thursday, 3:16 AM EDT. Source: Environment Canada",
"startTime": "2020-06-29T19:44:00+00:00",
"endTime": "2020-07-02T07:16:03+00:00",
"latestStatus": {
"localized": "Continue",
"english": "Continue"
},
"alertDetails": "\nA heat event continues through Thursday.\n\nDaytime high temperatures in the low thirties with overnight lows near 18 degrees Celsius are expected to continue until Thursday. Humidex values are expected to reach between 36 and 40 today. Cooler air will move into the region Thursday night. \n\nPlease refer to your public forecast for further details on expected temperatures.\n\nHot and humid air can also bring deteriorating air quality and can result in the air quality health index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nWatch for the effects of heat illness: swelling, rash, cramps, fainting, heat exhaustion, heat stroke and the worsening of some health conditions.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
"alertDetailsLanguageCode": "en-CA"
}
]
},
{
"countryCode": "CA",
"alertId": 242633,
"description": {
"localized": "Heat Warning",
"english": "Heat Warning"
},
"category": "NON-PRECIPITATION",
"priority": 31,
"source": "Environment Canada",
"sourceId": 3,
"alertAreas": [
{
"name": "Kirkland Lake - Englehart",
"summary": "Heat Warning in effect until 9:25 PM EDT. Source: Environment Canada",
"startTime": "2020-07-01T09:25:59+00:00",
"endTime": "2020-07-02T01:25:59+00:00",
"latestStatus": {
"localized": "New",
"english": "New"
},
"alertDetails": "\nA heat event is expected through Thursday. \n\nDaytime high temperatures in the low thirties on Wednesday and Thursday with overnight lows near 18 degrees Celsius are expected. This heat event may be extended into the weekend with daytime high temperatures near 30 degrees Celsius. \n\nPlease refer to your public forecast for further details on expected temperatures. \n\nHot and humid air can also bring deteriorating air quality and can result in the Air Quality Health Index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
"alertDetailsLanguageCode": "en-CA"
}
]
}
]
}
定義
| 名前 | 説明 |
|---|---|
|
Alert |
影響を受ける地域内で発令された悪天候警報に関する情報。 同じ場所に対して複数のアラートがアクティブな場合、アラートは API 応答内で |
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Json |
応答の目的の形式。
|
|
Latest |
現在のエリアのアラートの最新のステータス。 |
|
Latest |
悪天候警報の現在の状態を説明するために使用される 8 つのキーワードの事前定義リスト。 |
|
Severe |
悪天候警報に関する情報。 |
|
Severe |
悪天候警報の説明。 |
|
Severe |
このオブジェクトは、Get Severe Weather Alerts 呼び出しが成功したときに返されます。 |
AlertArea
影響を受ける地域内で発令された悪天候警報に関する情報。 同じ場所に対して複数のアラートがアクティブな場合、アラートは API 応答内で priority 順に返され、優先度が最も高いアラートが応答の先頭に返されます。
| 名前 | 型 | 説明 |
|---|---|---|
| alertDetails |
string |
アラートに関連する完全な詳細。 もしそうなら返品 |
| alertDetailsLanguageCode |
string |
|
| endTime |
string (date-time) |
アラートが終了した、または終了する日時は[ISO 8601](https://en.wikipedia.org/wiki/ISO_format (yyyy-mm-ddThh:mm:ss-hh:mm)で示されています。 例えば、 2025-04-29T07:00:00-07:00です。 アラートが複数のタイムゾーンにまたがる場合、応答は要求された座標に対応する現地時刻を提供します。 |
| latestStatus |
現在のエリアのアラートの最新のステータス。 |
|
| name |
string |
アラートの影響を受けるエリアの名前。 要求された場所は、アラート領域に該当します。 |
| startTime |
string (date-time) |
ISO 8601形式での警報開始日時、例えば2019-10-27T19:39:57-08:00などです。 アラートが複数のタイムゾーンにまたがる場合、応答で返される時刻は、要求された座標位置までのローカル時刻です。 |
| summary |
string |
返された領域のアラートを要約するテキスト。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| 名前 | 型 | 説明 |
|---|---|---|
| info |
object |
追加情報。 |
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細です。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
JsonFormat
応答の目的の形式。
json 形式のみがサポートされています。
| 値 | 説明 |
|---|---|
| json |
JavaScript オブジェクト表記データ交換形式 を する |
LatestStatus
現在のエリアのアラートの最新のステータス。
| 名前 | 型 | 説明 |
|---|---|---|
| english |
アラートの最新のステータス キーワード (英語 (en-US)。 |
|
| localized |
string |
アラートの最新のステータスキーワード (指定した言語)。 デフォルトでは、英語 (en-US) で返されます。 |
LatestStatusKeyword
悪天候警報の現在の状態を説明するために使用される 8 つのキーワードの事前定義リスト。
| 値 | 説明 |
|---|---|
| Cancel |
アラートが最初にスケジュールされた有効期限より前にキャンセルされたことを示します。 |
| Continue |
アラートが最初の発行以降に更新されているが、 |
| Correct |
以前のエラーを修正するためにアラートが変更されたことを示します。 |
| Expire |
アラートの有効期限が切れ、アクティブではなくなったことを示します。 |
| Extend |
アラートが最初の発行以降、期間、エリア、またはその両方で延長されたことを示します。 |
| New |
最初に発行されたときのアラートの状態。 |
| Update |
アラートが最初の発行以降に変更されたことを示します。 |
| Upgrade |
アラートが最初に発行されてから上位クラスまたはカテゴリに昇格されたことを示します。 |
SevereWeatherAlert
悪天候警報に関する情報。
| 名前 | 型 | 説明 |
|---|---|---|
| alertAreas |
影響を受ける地域に固有のアラートに関する情報。 |
|
| alertId |
integer (int32) |
気象警報の一意の数値識別子。 |
| category |
string |
アラートのカテゴリ。 |
| class |
string |
アラートの分類。 このフィールドはすべての国で使用できるわけではないため、常に返されるわけではありません。 |
| countryCode |
string |
2 文字の ISO 3166-1 Alpha-2 国コード (例: "US")。 |
| description |
アラートの説明。 |
|
| disclaimer |
string |
アラート情報のソースに関する免責事項。 このフィールドは常に使用できるわけではありません。 たとえば、免責事項には、遅延やアラームに関連する潜在的な問題に関する詳細が含まれる場合があります。 |
| level |
string |
アラートの重大度レベル。 このフィールドはすべての国で使用できるわけではないため、常に返されるわけではありません。 |
| priority |
integer (int32) |
発生した国/地域内での特定のアラートの重要度またはランク付け順序を示す数値。 数値が小さいほど、優先度が高いことを意味します。 たとえば、1 は最優先度です。 この数は国/地域によって異なり、各国/地域がアラート システムを進化させるにつれて、時間の経過とともに変化する可能性があります。 |
| source |
string |
アラート情報のプロバイダー。 デフォルトでは、ソースは英語 (en-US) で返されます。 警報は、政府の公式気象機関と主要な世界気象警報プロバイダーからのものです。 |
| sourceId |
integer (int32) |
アラート・データのソース・プロバイダー名に関連付けられた数値識別子。 |
SevereWeatherAlertDescription
悪天候警報の説明。
| 名前 | 型 | 説明 |
|---|---|---|
| english |
string |
英語でのアラートの説明 (en-US)。 |
| localized |
string |
指定された言語でのアラートの説明。 デフォルトでは、要求で言語パラメーターが指定されていない場合は、英語 (en-US) が返されます。 |
SevereWeatherAlertsResult
このオブジェクトは、Get Severe Weather Alerts 呼び出しが成功したときに返されます。
| 名前 | 型 | 説明 |
|---|---|---|
| results |
クエリされた場所のすべての悪天候警報のリスト。 |