Weather - Get Minute Forecast

1 分、5 分、15 分間隔で次の 120 分間の分単位の予報を取得するために使用します。
Get Minute Forecast API は、特定の場所の今後 120 分間の分単位の予報を返す HTTP GET リクエストです。 ユーザーは、1 分、5 分、15 分の間隔で気象予測を要求できます。 応答には、降水の種類(雨、雪、またはその両方の混合を含む)、開始時間、降水強度値(dBZ)などの詳細が含まれます。 詳細については、「 分単位の天気予報データを要求する」を参照してください。

GET {endpoint}/weather/forecast/minute/json?api-version=1.1&query={query}

GET {endpoint}/weather/forecast/minute/json?api-version=1.1&query={query}&interval={interval}&language={language}

URI パラメーター

要求ヘッダー

応答

セキュリティ

AadToken

これらはMicrosoft Entra OAuth 2.0フローです。 Azureロールベースアクセス制御と組み合わせることで、Azure Maps REST APIへのアクセス制御に利用できます。 Azure ロールベースのアクセス制御は、1つ以上の Azure Maps リソースアカウントまたはサブリソースへのアクセスを指定するために使用されます。 Azure Maps REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。

シナリオを実装するには、認証の概念表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを介してアプリケーションをモデル化するためのソリューションを提供します。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

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 minute-by-minute forecasts for a given location

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

{
  "intervalSummaries": [
    {
      "briefPhrase": "Rain ending in %minute_value min",
      "endMinute": 24,
      "iconCode": 12,
      "longPhrase": "Rain ending in %minute_value min",
      "shortPhrase": "Rain ending in %minute_value min",
      "startMinute": 0,
      "totalMinutes": 25
    },
    {
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "endMinute": 119,
      "iconCode": 7,
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "startMinute": 25,
      "totalMinutes": 95
    }
  ],
  "intervals": [
    {
      "cloudCover": 100,
      "color": {
        "blue": 2,
        "green": 98,
        "hex": "#086202",
        "red": 8
      },
      "dbz": 23,
      "iconCode": 12,
      "minute": 0,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:18:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "color": {
        "blue": 9,
        "green": 133,
        "hex": "#208509",
        "red": 32
      },
      "dbz": 18,
      "iconCode": 12,
      "minute": 15,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:33:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 30,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T15:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 45,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:03:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 60,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:18:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 75,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:33:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 90,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 105,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T17:03:00-08:00"
    }
  ],
  "summary": {
    "briefPhrase": "Rain ending in 25 min",
    "briefPhrase60": "Rain ending in 25 min",
    "iconCode": 12,
    "longPhrase": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min"
  }
}

定義

ColorValue

RGBカラーは成分(red、 green、 blue)および十六進数(hex)形式で返されます。 分単位の予報で各区間をレーダースタイル表示に表示するために使用されます。dbzにマッピングされた全スペクトル色についてはForecastInterval.color、precipitationTypeおよびthresholdから派生した粗い色についてはForecastInterval.simplifiedColorを参照してください。 基となる色のマッピングについては、Azure Mapsの気象サービスをご覧ください。

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

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

ForecastInterval

分単位の予報内の単一の時間断片を表し、その区間における予想される気象条件を記述します。 各間隔は1分、5分、または15分で、要求される解像度に応じて、開始時刻、降水強度(dbz)、降水の種類と閾値、短い説明文、アイコンコード、雲の被覆、そしてレーダースタイルディスプレイで状況を視覚的に表現するための全スペクトル色と簡略化された色が含まれます。

IconCode

どのアイコンを表示するかを示す数値の天候コードです。 この列挙の各値は、晴れ、雲、雷雨などのAzure Maps天気アイコンに対応し、人間が読み取れる返iconPhraseと組み合わされます。 同じコードは、現在、時間ごとの、日次、四半日、分単位の応答に現れることがあり、アプリケーションはすべての気象サービスで一貫したアイコンセットを表示できます。

コードの完全なリスト、それらがマッピングするアイコン、例の画像については、Azure Mapsの気象サービスをご覧ください。

IntervalSummary

分単位の予報内の連続したウィンドウの天気見通しを記述します。通常は 、25分後に雨が終わる 、または 10分後に始まる軽い雪のような類似した条件の連続です。 各サマリーは予報開始時(startMinute、 endMinute、 totalMinutes)までの分単位のウィンドウを指定し、3つの長さ(短、簡潔、長)のフレーズ説明を提供し、利用可能なUIスペースに応じた適切な詳細レベルを表示できるようにし、代表的な天気アイコンの用に使う iconCode も含まれています。 MinuteForecastResultは、予測期間をカバーする1つ以上のIntervalSummary項目を返します。

JsonFormat

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

MinuteForecastResult

応答は「Get Minute Forecast」操作によって返され、指定された場所の今後120分間の降水見通しを要求された解像度(1分、5分、または15分)で提供しました。 応答は3層に分かれています。全体のフレーズ説明と期間中の代表アイコンを含む全体summary、連続した分を類似条件の長い区間(例:雨が25分で終わるなど)にまとめるintervalSummariesアレイ、そして降水強度(dbz)、降水量の種類、雲量、レーダースタイルの可視化に使われる色などの詳細な1分ごとの予報ポイントを含むintervalsアレイです。

MinuteForecastSummary

今後の分単位の降水見通しを説明するフレーズ要約を提供します。 複数のフレーズ長(短(~25文字)、簡短(~60文字)、長(60+文字)が含まれており、アプリケーションは利用可能なUI空間に最適な詳細レベルを表示できます。 iconCodeはその時代の象徴的な天気アイコンを示します。

PrecipitationType

降水のタイプを指定します。 有効な値は雨、雪、氷、または混合です。 このプロパティは、dBZ が 0 より大きい場合の応答に含まれます。