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パブリッククラウドにはhttps://atlas.microsoft.comを使いましょう。 特定のAzure Maps地理やソブリンクラウドをターゲットにする場合は、Azure Maps地理的範囲を参照してください。

format
path True

JsonFormat

応答の目的の形式。 json 形式のみがサポートされています。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

query
query True

number[]

緯度の後に経度 (例: "47.641268,-122.125679") で構成されるコンマ区切り文字列として指定された該当するクエリ。

気象情報は、通常、陸上の場所、陸地に囲まれた水域、および海岸線から約 50 海里以内の海域で利用できます。

details
query

string

悪天候警報の詳細を返してください。 使用可能な値は次のとおりです

  • true - 完全な詳細を返します。 デフォルトでは、すべての詳細が返されます。
  • false - アラートの詳細 (alertDetails) のエリア固有の完全な説明を除外した、切り捨てられたバージョンのアラート データを返します。
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の認証管理Manage certificationをご覧ください。

応答

Name 型 説明
200 OK

SevereWeatherAlertsResult

要求は成功しました。

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

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 説明
AlertArea

1つの地理的地域は SevereWeatherAlert.alertAreas年に深刻な気象警報で記録として再確認されました。 各 AlertArea は影響地域を nameで識別し、警報が発動する開始・終了時刻(startTime、 endTime)、その地域の警報の最新状況(latestStatus)を報告し、アラートの短い表示可能な summary を表示します。 詳細を求めると、完全な警告テキストも返 alertDetailsされ、 alertDetailsLanguageCode は提供されている言語を明記します。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。

JsonFormat

応答の目的の形式。 json 形式のみがサポートされています。

LatestStatus

特定の地域での激しい気象警報の最新の状況は AlertArea.latestStatus日に報告されました。 同じステータスキーワード( New、 Continue、 Update、 Correct、 Extend、 Upgrade、 Cancel、または Expire のいずれか—完全なリストは「 LatestStatusKeyword 」を参照)が2回返されます。1回はリクエストで指定された言語に翻訳された(localized)、もう1回は英語(english)で、発信者は状態オン時に安定した言語に依存しない値を保ちつつ、エンドユーザーにローカライズされたラベルを表示できます。

LatestStatusKeyword

悪天候警報の現在の状態を説明するために使用される 8 つのキーワードの事前定義リスト。

SevereWeatherAlert

指定された場所で1回の深刻な気象警報が発動し、1 SevereWeatherAlertsResult.results年に記録として再発しました。 アラート自体のメタデータ(国、識別子、カテゴリー、重大度分類、優先度、発行元、免責事項)と、短くローカライズされた要約文句や英語の要約フレーズ、アラートがカバーする特定の地理的エリア、発動時間、警報の詳細を説明するdescriptionalertAreas配列を組み合わせています。 基礎となる警報は、公式の政府気象機関や世界の主要な気象警報提供者によって発行され、ハリケーン、雷雨、洪水、雷、熱波、森林火災などの現象をカバーしています。

SevereWeatherAlertDescription

SevereWeatherAlert.description日に激しい気象警報の短い要約が戻りました。 同じフレーズはリクエストで指定された言語に翻訳された(localized)、英語で翻訳されたもの(english)2回提供されます。これにより、発信者はエンドユーザーにローカライズされたラベルを表示しつつ、ログ、マッチング、またはフォールバック表示のために安定した言語に依存しない文字列を保持できます。

SevereWeatherAlertsResult

対応は「Get Severe Weather Alerts」作戦で、指定された場所で発動中のすべての深刻な気象警報を含みました。 警報はハリケーン、雷雨、洪水、雷、熱波、森林火災などの現象を対象としており、地元の気象当局が発表したものに限りません。 アラートが発動していない場合、 results 配列は空です。

AlertArea

1つの地理的地域は SevereWeatherAlert.alertAreas年に深刻な気象警報で記録として再確認されました。 各 AlertArea は影響地域を nameで識別し、警報が発動する開始・終了時刻(startTime、 endTime)、その地域の警報の最新状況(latestStatus)を報告し、アラートの短い表示可能な summary を表示します。 詳細を求めると、完全な警告テキストも返 alertDetailsされ、 alertDetailsLanguageCode は提供されている言語を明記します。

Name 型 説明
alertDetails

string

この地域のためにソースから発行された完全なフリーフォーム警報テキストで、完全な注意報を表示するのに適しています。 詳細を求めるリクエストがなければ返送しません。 テキストは発行提供者が提供した言語で返されますが、応答の他の部分で求められる言語とは異なる場合があります。コンパニオン alertDetailsLanguageCode はその言語を識別します。 一部の国や地域では母語と英語の両方を提供している場合があります。

alertDetailsLanguageCode

string

alertDetailsの言語は、ISO 639-1 Alpha-2言語コードとして、例えばカナダ英語の言語コードとしてen-CAされています。 回答の他の部分で求められている表現と異なる場合があります。 詳細を求めるリクエストがなければ返送しません。

endTime

string (date-time)

このエリアのアラートが終了または終了する日付と時間( RFC 3339 形式で示す)(yyyy-mm-ddThh:mm:ss-hh:mm)。 例えば、 2025-04-29T07:00:00-07:00です。 アラートが複数のタイムゾーンにまたがる場合、その値はリクエストで指定された座標の現地時刻を反映します。

latestStatus

LatestStatus

このエリアにおけるアラートの最新の状況(例:新規発出、継続中、またはキャンセルされたかなど)。 ローカライズされたフレーズとして、また言語に依存しない LatestStatusKeyword 値の両方で返されます。

name

string

この項目でアラートの影響を受けた地理的エリア名、例えば カークランド湖 - エングルハート。 この AlertArea が適用される時間、状況、詳細テキストが適用される特定の地域や地域を特定します。

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

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。

Name 型 説明
error

ErrorDetail

エラー オブジェクト。

JsonFormat

応答の目的の形式。 json 形式のみがサポートされています。

値 説明
json

JavaScript オブジェクト表記データ交換形式 を する

LatestStatus

特定の地域での激しい気象警報の最新の状況は AlertArea.latestStatus日に報告されました。 同じステータスキーワード( New、 Continue、 Update、 Correct、 Extend、 Upgrade、 Cancel、または Expire のいずれか—完全なリストは「 LatestStatusKeyword 」を参照)が2回返されます。1回はリクエストで指定された言語に翻訳された(localized)、もう1回は英語(english)で、発信者は状態オン時に安定した言語に依存しない値を保ちつつ、エンドユーザーにローカライズされたラベルを表示できます。

Name 型 説明
english

LatestStatusKeyword

英語のステータスキーワード(en-US)は、 LatestStatusKeyword (New、 Continue、 Update、 Correct、 Extend、 Upgrade、 Cancel、または Expire)によって定義された値の一つです。 要求された言語に関係なく常に英語で返送されるため、安定した言語に依存しないステータスチェックに適しています。

localized

string

ステータスキーワードはリクエストで指定された言語に翻訳されます。例えばフランス語の場合は Continu です。 リクエストに言語が指定されていなければ、これは englishと一致します。

LatestStatusKeyword

悪天候警報の現在の状態を説明するために使用される 8 つのキーワードの事前定義リスト。

値 説明
Cancel

アラートが予定の有効期限より早く解除されたことを示します。

Continue

アラートが最初の発行以降に更新されているが、 alertDetails、 startTime、 endTime、または classに変更が加えられていないことを示します。

Correct

以前のエラーを修正するためにアラートが変更されたことを示します。

Expire

アラートの有効期限が切れ、アクティブではなくなったことを示します。

Extend

アラートが最初の発行以降、期間、エリア、またはその両方で延長されたことを示します。

New

最初に発行されたときのアラートの状態。

Update

アラートが最初の発行以降に変更されたことを示します。

Upgrade

アラートが最初に発行されてから上位クラスまたはカテゴリに昇格されたことを示します。

SevereWeatherAlert

指定された場所で1回の深刻な気象警報が発動し、1 SevereWeatherAlertsResult.results年に記録として再発しました。 アラート自体のメタデータ(国、識別子、カテゴリー、重大度分類、優先度、発行元、免責事項)と、短くローカライズされた要約文句や英語の要約フレーズ、アラートがカバーする特定の地理的エリア、発動時間、警報の詳細を説明するdescriptionalertAreas配列を組み合わせています。 基礎となる警報は、公式の政府気象機関や世界の主要な気象警報提供者によって発行され、ハリケーン、雷雨、洪水、雷、熱波、森林火災などの現象をカバーしています。

Name 型 説明
alertAreas

AlertArea[]

警報の対象地域。 各 AlertArea は影響を受けた地域を名前で特定し、その地域の警報の開始・終了時刻、最新の警報状況、そして(詳細な要求が必要な場合には)警報の詳細テキスト全体を記載します。 警報は一つまたは複数の地域をカバーすることがあり、例えば、同じアドバイザリー内で複数の隣接地域に熱気警報が適用されることがあります。

alertId

integer (int32)

アラートの数値識別子で、発行するプロバイダー内で一意です。

category

string

気象現象ごとにアラートを分類する、言語に依存しない短いラベル(例: NON-PRECIPITATION、 PRECIPITATION、 THUNDERSTORM、 TROPICAL、 FIREなど)です。 正確な価値のセットは発行提供者によって異なります。

class

string

発行機関が提供する場合、提供者ごとのアラート分類(例えば警告クラスやアラートの種類)です。 すべての国で利用可能ではなく、省略される場合があります。

countryCode

string

警報が発令された国や地域を表す2文字の ISO 3166-1 Alpha-2国コード (例: US や CA)です。

description

SevereWeatherAlertDescription

アラートの短い要約フレーズ(例: 熱気警報 や 竜巻注意)は、リクエストで指定された言語(localized)と英語(english)の両方で返されます。

disclaimer

string

送信元からのアラート情報に関する免責事項、例えば遅延やデータ制限に関する注意書きなど。 存在する場合は、アラートと共に表示しなければなりません。 必ずしも返ってくるわけではない。

level

string

発行機関からアラートが提供された場合の深刻度。 正確な値のセットはプロバイダーごとに異なります。 すべての国で利用可能ではなく、省略される場合があります。

priority

integer (int32)

アラートの重要性は、発信国や地域内で、 1 が最も優先度が高く、数字が多いほど優先度が低いです。 正確な規模は提供者ごとに異なり、警報システムの進化に伴い変化することがあります。

source

string

警報を発令した機関名、例えば環境 省 や 米国国立気象局など。 警報は通常、公式の政府気象機関や主要な世界的な気象警報提供者によって発行されます。

sourceId

integer (int32)

sourceとペアリングされるソースプロバイダーの数値識別子。 プロバイダーの安定的で言語に依存しない検索に適しています。

SevereWeatherAlertDescription

SevereWeatherAlert.description日に激しい気象警報の短い要約が戻りました。 同じフレーズはリクエストで指定された言語に翻訳された(localized)、英語で翻訳されたもの(english)2回提供されます。これにより、発信者はエンドユーザーにローカライズされたラベルを表示しつつ、ログ、マッチング、またはフォールバック表示のために安定した言語に依存しない文字列を保持できます。

Name 型 説明
english

string

英語の要約表現(en-US)—例えば 「Heat Warning 」や 「Tornado Watch」などです。 要求された言語に関係なく必ず英語で返されるため、安定的で言語に依存しないラベルとして適しています。

localized

string

要約文は依頼書で指定された言語(例:フランス語の場合は Avis de chaleur )に翻訳されます。 リクエストに言語が指定されていなければ、これは englishと一致します。

SevereWeatherAlertsResult

対応は「Get Severe Weather Alerts」作戦で、指定された場所で発動中のすべての深刻な気象警報を含みました。 警報はハリケーン、雷雨、洪水、雷、熱波、森林火災などの現象を対象としており、地元の気象当局が発表したものに限りません。 アラートが発動していない場合、 results 配列は空です。

Name 型 説明
results

SevereWeatherAlert[]

指定された場所で発動中の激しい気象警報は、 priority 順に発動しています(優先度が高いものが最優先)。 アラートが発動していないときは空になります。