次の方法で共有

Weather - Get Quarter Day Forecast

  • リファレンス
サービス:
Maps
API バージョン:
1.1

を使用して、次の 1、5、10、または 15 日間の Quarter-Day 予測を取得します。

Get Quarter-Day Forecast API は、特定の場所の次の 1、5、10、または 15 日間の詳細な天気予報を四半期別に返す HTTP GET 要求です。 応答データは、1 日の四半期 (午前、午後、夕方、夜間) によって表示されます。 温度、湿度、風、降水量、UV インデックスなどの詳細が返されます。

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query={query}
省略可能なパラメーターを含む: 
GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}

URI パラメーター

名前 / 必須 型 説明
format
 path True

JsonFormat

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

string

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

number[]

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

integer

クエスト日の予測応答が返される日数を指定します。 サポートされる値は次のとおりです。

  • 1 - 翌日の予測データを返します。 既定で返されます。
  • 5 - 今後 5 日間の予測データを返します。
  • 10 - 今後 10 日間の予測データを返します。
  • 15 - 今後 15 日間の予測データを返します。
language
 query

string

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

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

WeatherDataUnit

メトリック単位または帝国単位のいずれかでデータを返すように指定します。 既定値はメトリックです。

要求ヘッダー

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

string

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

応答

名前 型 説明
200 OK

QuarterDayForecastResult

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 リソース の List SAS 操作から作成される共有アクセス署名トークンです。

このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンに対するきめ細かい制御が許可されます。 言い換えると、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できます。

公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定のリストを構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。

型: apiKey
/: header

例

Successfully retrieve detailed weather forecast by a given location

要求のサンプル

GET https://atlas.microsoft.com/weather/forecast/quarterDay/json?api-version=1.1&query=47.632346,-122.138874&duration=1

応答のサンプル

状態コード:
200 
{
  "forecasts": [
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T07:00:00-08:00",
      "quarter": 0,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 6.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.1,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 7.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 11.2,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7.5,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 90,
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 192,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 2,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 55,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.6,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T13:00:00-08:00",
      "quarter": 1,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Mostly cloudy with a shower in spots",
      "temperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 13.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 11.3,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 14.7,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 76,
      "wind": {
        "direction": {
          "degrees": 296,
          "localizedDescription": "WNW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 96,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 50,
      "thunderstormProbability": 20,
      "totalLiquid": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0.3,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-14T19:00:00-08:00",
      "quarter": 2,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "phrase": "Cloudy",
      "temperature": {
        "minimum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 10.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 8.5,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.8,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 81,
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 10,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 93,
      "hasPrecipitation": false,
      "precipitationProbability": 25,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T00:00:00-08:00",
      "effectiveDate": "2019-11-15T01:00:00-08:00",
      "quarter": 3,
      "iconCode": 12,
      "iconPhrase": "Showers",
      "phrase": "Cloudy with a little rain",
      "temperature": {
        "minimum": {
          "value": 8.9,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 9.9,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": 6.2,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 8.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 84,
      "wind": {
        "direction": {
          "degrees": 164,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "direction": {
          "degrees": 165,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 14.8,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "visibility": {
        "value": 9,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "hasPrecipitation": true,
      "precipitationType": "Rain",
      "precipitationIntensity": "Light",
      "precipitationProbability": 59,
      "thunderstormProbability": 0,
      "totalLiquid": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 1.4,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

定義

名前 説明
DayQuarter

1 日の四半期。
ErrorAdditionalInfo

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

エラーの詳細。
ErrorResponse

エラー応答
IconCode

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

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

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

表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。
WeatherDataUnit

メトリック単位または帝国単位のいずれかでデータを返すように指定します。 既定値はメトリックです。
WeatherUnit

気象に関連する特定の単位の特定の値。
WeatherUnitRange

返される温度値。
WindDetails

速度と方向を含む風の詳細が返されます。
WindDirection

風向

DayQuarter

1 日の四半期。

名前 型 説明
0

Integer

1

Integer

2

Integer

3

Integer

ErrorAdditionalInfo

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

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細です。
message

string

エラー メッセージ。
target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 型 説明
error

ErrorDetail

error オブジェクト。

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

JsonFormat

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

名前 型 説明
json

string

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

PrecipitationType

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

名前 型 説明
Ice

string

凍雨
Mix

string

ミックス
Rain

string

雨
Snow

string

雪

QuarterDayForecast

名前 型 説明
cloudCover

integer

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

string

予測の日付 (例: 2019-10-27T00:00:00)
dewPoint

WeatherUnit

指定した単位の露点温度。 露点温度とは、飽和状態に達するために空気を冷却する必要がある温度です。
effectiveDate

string

ISO 8601 形式で表示される予測四半期の開始日時 (2019-10-27T19:39:57-08:00 など)。
hasPrecipitation

boolean

降水の有無を示します。 True は降水の存在を示し、false は降水量がないことを示します。
ice

WeatherUnit

凍雨
iconCode

IconCode

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

string

アイコンの語句の説明。 指定した言語で表示されます。 たとえば、"Sunny" などです。
phrase

string

四半期の短い要約語句の概要。
precipitationIntensity

string

強度の説明。
precipitationProbability

integer

降水の確率を表す割合。 たとえば、'20' です。
precipitationType

PrecipitationType

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

DayQuarter

1 日の四半期。
rain

WeatherUnit

雨
realFeelTemperature

WeatherUnitRange

四半期の RealFeel™ 温度値。
relativeHumidity

integer

湿度とは、空気中に存在する水蒸気の量を、同じ温度での飽和に必要な量の割合で表したものです。
snow

WeatherUnit

雪
temperature

WeatherUnitRange

四半期の温度値。
thunderstormProbability

integer

雷雨の確率を表す割合。 たとえば、'10' です。
totalLiquid

WeatherUnit

予測期間中の降水量に相当する合計液体。
visibility

WeatherUnit

指定した単位での可視性。 オブジェクトまたはライトを明確に識別できる距離の測定値。
wind

WindDetails

速度と方向を含む風の詳細が返されます。
windGust

WindDetails

風の突風。 風の突風は、風の速度の急激な、短い増加です。

QuarterDayForecastResult

名前 型 説明
forecasts

QuarterDayForecast[]

応答の各四半期の予測データ。

UnitType

表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

名前 型 説明
0

Integer

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

3

Integer

31

Integer

4

Integer

5

Integer

6

Integer

7

Integer

8

Integer

9

Integer

WeatherDataUnit

メトリック単位または帝国単位のいずれかでデータを返すように指定します。 既定値はメトリックです。

名前 型 説明
imperial

string

帝国単位でデータを返します。 帝国システムの単位の例としては、華氏とマイルがあります。
metric

string

メトリック単位でデータを返します。 メトリック システムの単位の例としては、摂氏とキロメートルがあります。

WeatherUnit

気象に関連する特定の単位の特定の値。

名前 型 説明
unit

string

戻り値の単位の型。
unitType

UnitType

表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。
value

number

丸められた値。

WeatherUnitRange

返される温度値。

名前 型 説明
maximum

WeatherUnit

期間の最高温度
minimum

WeatherUnit

期間の最低温度。

WindDetails

速度と方向を含む風の詳細が返されます。

名前 型 説明
direction

WindDirection

風向
speed

WeatherUnit

指定した単位の風の速度。

WindDirection

風向

名前 型 説明
degrees

integer

方位角の風向き。真北から始まり、時計回りの方向に続きます。 北は 0 度、東は 90 度、南は 180 度、西は 270 度です。 指定できる値は 0 から 359 です。
localizedDescription

string

指定した言語の方向の省略形。