Weather - Get Severe Weather Alerts
特定の場所のハリケーン、雷雨、洪水、落雷、熱波、森林火災などの厳しい気象条件に関する情報を取得するために使用します。
悪天候現象は、私たちの日常生活や事業運営に大きな影響を与える可能性があります。 たとえば、熱帯低気圧、強風、洪水などの厳しい気象条件により、道路が閉鎖され、物流会社が車両のルート変更を余儀なくされ、目的地への到着が遅れたり、冷蔵食品のコールドチェーンが中断されたりする可能性があります。
Get Severe Weather Alerts API は、政府の公式気象機関と、世界から地域の主要な気象警報プロバイダーの両方から世界中で利用できる悪天候警報を返す HTTP GET リクエストです。 このサービスは、アラートの種類、カテゴリ、レベルなどの詳細、およびハリケーン、雷雨、落雷、熱波、森林火災など、要求された場所のアクティブな重大アラートに関する詳細な説明を返すことができます。 詳細については、「悪天候アラートをリクエストする」を参照してください
GET {endpoint}/weather/severe/alerts/json?api-version=1.1&query={query}
GET {endpoint}/weather/severe/alerts/json?api-version=1.1&query={query}&language={language}&details={details}
URI パラメーター
| Name | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Azure Mapsサービスのホストネーム。 Azureパブリッククラウドには |
|
format
|
path | True |
応答の目的の形式。
|
|
|
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
|
query
|
query | True |
number[] |
緯度の後に経度 (例: "47.641268,-122.125679") で構成されるコンマ区切り文字列として指定された該当するクエリ。 気象情報は、通常、陸上の場所、陸地に囲まれた水域、および海岸線から約 50 海里以内の海域で利用できます。 |
|
details
|
query |
string |
悪天候警報の詳細を返してください。 使用可能な値は次のとおりです
|
|
|
language
|
query |
string |
検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。 詳細については、サポートされている言語の を参照してください。 |
要求ヘッダー
| Name | 必須 | 型 | 説明 |
|---|---|---|---|
| x-ms-client-id |
string |
Microsoft Entra IDセキュリティモデルで使用されることを意図したアカウントを示します。 このAzure Mapsアカウントの一意IDは、Azure Maps管理プレーンのアカウントAPIから取得できます。
Azure MapsにおけるMicrosoft Entra IDセキュリティの使用についての詳細は、Azure Maps |
応答
| Name | 型 | 説明 |
|---|---|---|
| 200 OK |
要求は成功しました。 |
|
| Other Status Codes |
予期しないエラー応答。 |
セキュリティ
AadToken
これらはMicrosoft Entra OAuth 2.0フローです。 Azureロールベースアクセス制御と組み合わせることで、Azure Maps REST APIへのアクセス制御に利用できます。 Azure ロールベースのアクセス制御は、1つ以上の Azure Maps リソースアカウントまたはサブリソースへのアクセスを指定するために使用されます。 Azure Maps REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。
シナリオを実装するには、認証の概念表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを介してアプリケーションをモデル化するためのソリューションを提供します。
Note
- このセキュリティ定義 使用して、アプリケーションがアクセスを要求している Azure Maps リソースを示す必要があります。 これは、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
スコープ
| Name | 説明 |
|---|---|
| https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portal で、または PowerShell、CLI、Azure SDK、または REST API を使用して Azure Maps アカウント を作成 場合にプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。
パブリックに公開されているアプリケーションの場合は、キーを安全に格納できるように、機密クライアント アプリケーション アプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。
型:
apiKey
/:
header
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": [
{
"description": {
"english": "Heat Warning",
"localized": "Heat Warning"
},
"alertAreas": [
{
"name": "Kirkland Lake - Englehart",
"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",
"endTime": "2020-07-02T07:16:03+00:00",
"latestStatus": {
"english": "Continue",
"localized": "Continue"
},
"startTime": "2020-06-29T19:44:00+00:00",
"summary": "Heat Warning in effect until Thursday, 3:16 AM EDT. Source: Environment Canada"
}
],
"alertId": 242621,
"category": "NON-PRECIPITATION",
"countryCode": "CA",
"priority": 31,
"source": "Environment Canada",
"sourceId": 3
},
{
"description": {
"english": "Heat Warning",
"localized": "Heat Warning"
},
"alertAreas": [
{
"name": "Kirkland Lake - Englehart",
"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",
"endTime": "2020-07-02T01:25:59+00:00",
"latestStatus": {
"english": "New",
"localized": "New"
},
"startTime": "2020-07-01T09:25:59+00:00",
"summary": "Heat Warning in effect until 9:25 PM EDT. Source: Environment Canada"
}
],
"alertId": 242633,
"category": "NON-PRECIPITATION",
"countryCode": "CA",
"priority": 31,
"source": "Environment Canada",
"sourceId": 3
}
]
}
定義
| Name | 説明 |
|---|---|
|
Alert |
1つの地理的地域は |
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。 |
|
Json |
応答の目的の形式。
|
|
Latest |
特定の地域での激しい気象警報の最新の状況は |
|
Latest |
悪天候警報の現在の状態を説明するために使用される 8 つのキーワードの事前定義リスト。 |
|
Severe |
指定された場所で1回の深刻な気象警報が発動し、1 |
|
Severe |
|
|
Severe |
対応は「Get Severe Weather Alerts」作戦で、指定された場所で発動中のすべての深刻な気象警報を含みました。
警報はハリケーン、雷雨、洪水、雷、熱波、森林火災などの現象を対象としており、地元の気象当局が発表したものに限りません。 アラートが発動していない場合、 |
AlertArea
1つの地理的地域は SevereWeatherAlert.alertAreas年に深刻な気象警報で記録として再確認されました。 各 AlertArea は影響地域を nameで識別し、警報が発動する開始・終了時刻(startTime、 endTime)、その地域の警報の最新状況(latestStatus)を報告し、アラートの短い表示可能な summary を表示します。 詳細を求めると、完全な警告テキストも返 alertDetailsされ、 alertDetailsLanguageCode は提供されている言語を明記します。
| Name | 型 | 説明 |
|---|---|---|
| alertDetails |
string |
この地域のためにソースから発行された完全なフリーフォーム警報テキストで、完全な注意報を表示するのに適しています。 詳細を求めるリクエストがなければ返送しません。 テキストは発行提供者が提供した言語で返されますが、応答の他の部分で求められる言語とは異なる場合があります。コンパニオン |
| alertDetailsLanguageCode |
string |
|
| endTime |
string (date-time) |
このエリアのアラートが終了または終了する日付と時間( RFC 3339 形式で示す)(yyyy-mm-ddThh:mm:ss-hh:mm)。 例えば、 2025-04-29T07:00:00-07:00です。 アラートが複数のタイムゾーンにまたがる場合、その値はリクエストで指定された座標の現地時刻を反映します。 |
| latestStatus |
このエリアにおけるアラートの最新の状況(例:新規発出、継続中、またはキャンセルされたかなど)。
ローカライズされたフレーズとして、また言語に依存しない |
|
| name |
string |
この項目でアラートの影響を受けた地理的エリア名、例えば カークランド湖 - エングルハート。 この |
| startTime |
string (date-time) |
この地域の警報が開始される日付と時間( RFC 3339 形式、yyyy-mm-ddThh:mm:ss-hh:mm)です。 例えば、 2025-04-29T07:00:00-07:00です。 アラートが複数のタイムゾーンにまたがる場合、その値はリクエストで指定された座標の現地時刻を反映します。 |
| summary |
string |
この地域のアラートの簡潔で表示可能な概要で、発効期間と発信元の情報源も含めて示せます。 例えば、 熱気警報は木曜日午前3時16分(EDT)まで発令されています。出典:カナダ環境省。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| Name | 型 | 説明 |
|---|---|---|
| info |
追加情報。 |
|
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| Name | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。
| Name | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
JsonFormat
応答の目的の形式。
json 形式のみがサポートされています。
| 値 | 説明 |
|---|---|
| json |
JavaScript オブジェクト表記データ交換形式 を する |
LatestStatus
特定の地域での激しい気象警報の最新の状況は AlertArea.latestStatus日に報告されました。 同じステータスキーワード( New、 Continue、 Update、 Correct、 Extend、 Upgrade、 Cancel、または Expire のいずれか—完全なリストは「 LatestStatusKeyword 」を参照)が2回返されます。1回はリクエストで指定された言語に翻訳された(localized)、もう1回は英語(english)で、発信者は状態オン時に安定した言語に依存しない値を保ちつつ、エンドユーザーにローカライズされたラベルを表示できます。
| Name | 型 | 説明 |
|---|---|---|
| english |
英語のステータスキーワード(en-US)は、 |
|
| localized |
string |
ステータスキーワードはリクエストで指定された言語に翻訳されます。例えばフランス語の場合は Continu です。 リクエストに言語が指定されていなければ、これは |
LatestStatusKeyword
悪天候警報の現在の状態を説明するために使用される 8 つのキーワードの事前定義リスト。
| 値 | 説明 |
|---|---|
| Cancel |
アラートが予定の有効期限より早く解除されたことを示します。 |
| Continue |
アラートが最初の発行以降に更新されているが、 |
| Correct |
以前のエラーを修正するためにアラートが変更されたことを示します。 |
| Expire |
アラートの有効期限が切れ、アクティブではなくなったことを示します。 |
| Extend |
アラートが最初の発行以降、期間、エリア、またはその両方で延長されたことを示します。 |
| New |
最初に発行されたときのアラートの状態。 |
| Update |
アラートが最初の発行以降に変更されたことを示します。 |
| Upgrade |
アラートが最初に発行されてから上位クラスまたはカテゴリに昇格されたことを示します。 |
SevereWeatherAlert
指定された場所で1回の深刻な気象警報が発動し、1 SevereWeatherAlertsResult.results年に記録として再発しました。 アラート自体のメタデータ(国、識別子、カテゴリー、重大度分類、優先度、発行元、免責事項)と、短くローカライズされた要約文句や英語の要約フレーズ、アラートがカバーする特定の地理的エリア、発動時間、警報の詳細を説明するdescriptionalertAreas配列を組み合わせています。 基礎となる警報は、公式の政府気象機関や世界の主要な気象警報提供者によって発行され、ハリケーン、雷雨、洪水、雷、熱波、森林火災などの現象をカバーしています。
| Name | 型 | 説明 |
|---|---|---|
| alertAreas |
警報の対象地域。 各 |
|
| alertId |
integer (int32) |
アラートの数値識別子で、発行するプロバイダー内で一意です。 |
| category |
string |
気象現象ごとにアラートを分類する、言語に依存しない短いラベル(例: |
| class |
string |
発行機関が提供する場合、提供者ごとのアラート分類(例えば警告クラスやアラートの種類)です。 すべての国で利用可能ではなく、省略される場合があります。 |
| countryCode |
string |
警報が発令された国や地域を表す2文字の ISO 3166-1 Alpha-2国コード (例: |
| description |
アラートの短い要約フレーズ(例: 熱気警報 や 竜巻注意)は、リクエストで指定された言語( |
|
| disclaimer |
string |
送信元からのアラート情報に関する免責事項、例えば遅延やデータ制限に関する注意書きなど。 存在する場合は、アラートと共に表示しなければなりません。 必ずしも返ってくるわけではない。 |
| level |
string |
発行機関からアラートが提供された場合の深刻度。 正確な値のセットはプロバイダーごとに異なります。 すべての国で利用可能ではなく、省略される場合があります。 |
| priority |
integer (int32) |
アラートの重要性は、発信国や地域内で、 1 が最も優先度が高く、数字が多いほど優先度が低いです。 正確な規模は提供者ごとに異なり、警報システムの進化に伴い変化することがあります。 |
| source |
string |
警報を発令した機関名、例えば環境 省 や 米国国立気象局など。 警報は通常、公式の政府気象機関や主要な世界的な気象警報提供者によって発行されます。 |
| sourceId |
integer (int32) |
|
SevereWeatherAlertDescription
SevereWeatherAlert.description日に激しい気象警報の短い要約が戻りました。 同じフレーズはリクエストで指定された言語に翻訳された(localized)、英語で翻訳されたもの(english)2回提供されます。これにより、発信者はエンドユーザーにローカライズされたラベルを表示しつつ、ログ、マッチング、またはフォールバック表示のために安定した言語に依存しない文字列を保持できます。
| Name | 型 | 説明 |
|---|---|---|
| english |
string |
英語の要約表現(en-US)—例えば 「Heat Warning 」や 「Tornado Watch」などです。 要求された言語に関係なく必ず英語で返されるため、安定的で言語に依存しないラベルとして適しています。 |
| localized |
string |
要約文は依頼書で指定された言語(例:フランス語の場合は Avis de chaleur )に翻訳されます。 リクエストに言語が指定されていなければ、これは |
SevereWeatherAlertsResult
対応は「Get Severe Weather Alerts」作戦で、指定された場所で発動中のすべての深刻な気象警報を含みました。
警報はハリケーン、雷雨、洪水、雷、熱波、森林火災などの現象を対象としており、地元の気象当局が発表したものに限りません。 アラートが発動していない場合、 results 配列は空です。
| Name | 型 | 説明 |
|---|---|---|
| results |
指定された場所で発動中の激しい気象警報は、 |