次の方法で共有


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

JsonFormat

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

api-version
query True

string

Azure Maps API のバージョン番号。

query
query True

number[]

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

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

details
query

string

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

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

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 とスコープに対するアクセス制御が可能なオブジェクトを介してアプリケーションをモデル化するためのソリューションを提供します。

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 を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。

型: 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"
        }
      ]
    }
  ]
}

定義

名前 説明
AlertArea

影響を受ける地域内で発令された悪天候警報に関する情報。 同じ場所に対して複数のアラートがアクティブな場合、アラートは API 応答内で priority 順に返され、優先度が最も高いアラートが応答の先頭に返されます。

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

JsonFormat

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

LatestStatus

現在のエリアのアラートの最新のステータス。

LatestStatusKeyword

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

SevereWeatherAlert

悪天候警報に関する情報。

SevereWeatherAlertDescription

悪天候警報の説明。

SevereWeatherAlertsResult

このオブジェクトは、Get Severe Weather Alerts 呼び出しが成功したときに返されます。

AlertArea

影響を受ける地域内で発令された悪天候警報に関する情報。 同じ場所に対して複数のアラートがアクティブな場合、アラートは API 応答内で priority 順に返され、優先度が最も高いアラートが応答の先頭に返されます。

名前 説明
alertDetails

string

アラートに関連する完全な詳細。 もしそうなら返品 details=True。 このフィールドは、発行プロバイダーによって常に選択した言語で返され、Azure Maps はプロバイダーによって作成されたもののみを返します。 一部の国/地域では、母国語と英語を提供している場合がありますのでご注意ください。 言語パラメータはこのフィールドには適用されません。

alertDetailsLanguageCode

string

alertDetailsの言語。 このフィールドは、 alertDetails の言語が要求された言語パラメータと異なる可能性があることを指摘するのに役立ちます。 もしそうなら返品 details=True。 言語コードは、ISO 639-1 Alpha-2 コードから派生しています。

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

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

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

エラー オブジェクト。

JsonFormat

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

説明
json

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

LatestStatus

現在のエリアのアラートの最新のステータス。

名前 説明
english

LatestStatusKeyword

アラートの最新のステータス キーワード (英語 (en-US)。

localized

string

アラートの最新のステータスキーワード (指定した言語)。 デフォルトでは、英語 (en-US) で返されます。

LatestStatusKeyword

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

説明
Cancel

アラートが最初にスケジュールされた有効期限より前にキャンセルされたことを示します。

Continue

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

Correct

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

Expire

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

Extend

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

New

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

Update

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

Upgrade

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

SevereWeatherAlert

悪天候警報に関する情報。

名前 説明
alertAreas

AlertArea[]

影響を受ける地域に固有のアラートに関する情報。

alertId

integer (int32)

気象警報の一意の数値識別子。

category

string

アラートのカテゴリ。

class

string

アラートの分類。 このフィールドはすべての国で使用できるわけではないため、常に返されるわけではありません。

countryCode

string

2 文字の ISO 3166-1 Alpha-2 国コード (例: "US")。

description

SevereWeatherAlertDescription

アラートの説明。

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

SevereWeatherAlert[]

クエリされた場所のすべての悪天候警報のリスト。