Weather - Get Minute Forecast

1、5、15 分の間隔で次の 120 分の分単位の予測を取得するには、 を使用します。

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

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query={query}&interval={interval}&language={language}

URI パラメーター

名前 / 必須 説明
format
path True

JsonFormat

応答の目的の形式。 サポートされているのは json 形式のみです。

api-version
query True

string

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

query
query True

number[]

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

interval
query

integer

返される天気予報の時間間隔を分単位で指定します。 サポートされている値は次のとおりです。

  • 1 - 1 分間隔の予測を取得します。 既定で返されます。
  • 5 - 5 分間の予測を取得します。
  • 15 - 15 分間隔の予測を取得します。
language
query

string

検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。

詳細については、「 サポートされている言語 」を参照してください。

要求ヘッダー

名前 必須 説明
x-ms-client-id

string

Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 これは Azure Maps アカウントの一意の ID を表し、Azure Maps 管理プレーン アカウント API から取得できます。 Azure Maps で Microsoft Entra ID セキュリティを使用するには、ガイダンスについては、次 の記事を 参照してください。

応答

名前 説明
200 OK

MinuteForecastResult

OK

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

メモ

  • このセキュリティ定義 では 、 ヘッダーを x-ms-client-id 使用して、アプリケーションがアクセスを要求している 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 を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。

型: 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 で Azure Maps アカウントを作成 するとき、または PowerShell、CLI、Azure SDK、または REST API を使用するときにプロビジョニングされる共有キーです。

このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。

公開されているアプリケーションの場合、キーを安全に格納できるように 、機密クライアント アプリケーション のアプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。

型: apiKey
/: query

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を使用して、Azure 管理プレーンを介して Azure Maps リソース の SAS の一覧表示操作から作成される共有アクセス署名トークンです。

このトークンを使用すると、すべてのアプリケーションが 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

応答のサンプル

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

定義

名前 説明
ColorValue
ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

ForecastInterval
IconCode

を表示 iconPhraseする画像を表す数値。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

IntervalSummary
JsonFormat

応答の目的の形式。 サポートされているのは json 形式のみです。

MinuteForecastResult
MinuteForecastSummary

予測期間全体の語句の概要。

PrecipitationType

降水量の種類を指定します ("Rain" "Snow" "Ice" または "Mix")。 dbz が 0 の場合、応答に precipitationType は存在しません。

ColorValue

名前 説明
blue

integer

RGB 値の青成分

green

integer

RGB 値の緑のコンポーネント。

hex

string

16 進数の色の値。

red

integer

RGB 値の赤のコンポーネント。

ErrorAdditionalInfo

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

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

error オブジェクト。

ForecastInterval

名前 説明
cloudCover

integer

クラウド カバーを表す割合。

color

ColorValue

dBZ にマップされるフル スペクトルカラー (Z に対するデシベル)。 dbz が 0 の場合、応答に色は存在しません。

dbz

number

予測される降水量の強度を表す単位。

iconCode

IconCode

を表示 iconPhraseする画像を表す数値。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

minute

integer

間隔の最初の分。

precipitationType

PrecipitationType

降水量の種類を指定します ("Rain" "Snow" "Ice" または "Mix")。 dbz が 0 の場合、応答に precipitationType は存在しません。

shortPhrase

string

間隔の降水条件を記述する短い語句。

simplifiedColor

ColorValue

降水量の種類としきい値にマップされるバンドの色。 dbz が 0 の場合、応答には存在しません。

startTime

string

ISO 8601 形式の間隔の開始日時 (2019-10-27T19:39:57-08:00 など)。

threshold

string

しきい値を指定するキー。 precipitationType と共に、 を使用して simplifiedColor を決定できます。 dbz が 0 の場合、応答には存在しません。

IconCode

を表示 iconPhraseする画像を表す数値。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

名前 説明
1

Integer

10

Integer

11

Integer

12

Integer

13

Integer

14

Integer

15

Integer

16

Integer

17

Integer

18

Integer

19

Integer

2

Integer

20

Integer

21

Integer

22

Integer

23

Integer

24

Integer

25

Integer

26

Integer

27

Integer

28

Integer

29

Integer

3

Integer

30

Integer

31

Integer

32

Integer

33

Integer

34

Integer

35

Integer

36

Integer

37

Integer

38

Integer

39

Integer

4

Integer

40

Integer

41

Integer

42

Integer

43

Integer

44

Integer

5

Integer

6

Integer

7

Integer

8

Integer

9

Integer

IntervalSummary

名前 説明
briefPhrase

string

簡単な概要語句。 フレーズの長さは約 60 文字です。

endMinute

integer

概要が適用される最後の 1 分。

iconCode

IconCode

を表示 iconPhraseする画像を表す数値。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

longPhrase

string

長い要約語句。 語句の長さは 60 文字以上です。

shortPhrase

string

短い要約語句。 フレーズの長さは約 25 文字です。

startMinute

integer

概要が適用される最初の 1 分。

totalMinutes

integer

概要が適用される分数。

JsonFormat

応答の目的の形式。 サポートされているのは json 形式のみです。

名前 説明
json

string

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

MinuteForecastResult

名前 説明
intervalSummaries

IntervalSummary[]

予測の各間隔の概要情報。 [概要] では、降水量が開始および停止する可能性のある各間隔が分割されます。

intervals

ForecastInterval[]

予測の各間隔の予測データ。

summary

MinuteForecastSummary

予測期間全体の語句の概要。

MinuteForecastSummary

予測期間全体の語句の概要。

名前 説明
briefPhrase

string

次の 120 分間の概要語句。 フレーズの長さは約 60 文字です。

briefPhrase60

string

次の 60 分間の概要語句。 フレーズの長さは約 60 文字です。

iconCode

IconCode

を表示 iconPhraseする画像を表す数値。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

longPhrase

string

次の 120 分間の長いサマリー フレーズ。 語句の長さは 60 文字以上です。

shortPhrase

string

次の 120 分間の短い要約語句。 フレーズの長さは約 25 文字です。

PrecipitationType

降水量の種類を指定します ("Rain" "Snow" "Ice" または "Mix")。 dbz が 0 の場合、応答に precipitationType は存在しません。

名前 説明
Ice

string

凍雨

Mix

string

ミックス

Rain

string

Snow

string