Weather - Get Daily Forecast
次の 1、5、10、15、25、または 45 日間の毎日の詳細な天気予報を取得するために使用します。
Get Daily Forecast
API は HTTP GET
要求であり、特定の座標位置の次の 1 日、5 日、10 日、15 日、25 日、または 45 日間の気温や風などの詳細な天気予報を返します。 この応答には、気温、風、降水量、大気質、UV 指数などの詳細が含まれます。 詳細については、「毎日の 天気予報データを要求する」を参照してください。
Gen1 S0 価格レベルを使用している場合は、次の 1 日、5 日、10 日、15 日間の毎日の予測を要求できます。 Gen1 S1 または Gen2 の価格レベルを使用している場合は、今後 25 日間と 45 日間の毎日の予測を要求することもできます。
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
format
|
path | True |
応答の目的の形式。 サポートされているのは |
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
query
|
query | True |
number[] |
緯度の後に経度 (例: "47.641268,-122.125679" など) で構成されるコンマ区切り文字列として指定された該当するクエリ。 |
duration
|
query |
integer |
1 日の予測応答が返される日数を指定します。 使用可能な値は次のとおりです。
|
|
language
|
query |
string |
検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。 詳細については、「 サポートされている言語 」を参照してください。 |
|
unit
|
query |
メトリック単位または帝国単位のいずれかでデータを返すように指定します。 既定値はメトリックです。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 Azure Maps アカウントの一意の ID を表し、Azure Maps管理プレーン アカウント API から取得できます。 Azure MapsでMicrosoft Entra IDセキュリティを使用するには、ガイダンスについては、次の記事を参照してください。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
予期しないエラーが発生しました。 |
セキュリティ
AADToken
これらは OAuth 2.0 フロー Microsoft Entraです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API をAzure Mapsするための 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 を使用すると、複数のユース ケースに対してアプリケーションを構成ベースで設定できます。
- Microsoft ID プラットフォームの詳細については、「Microsoft ID プラットフォームの概要」を参照してください。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portalでAzure Maps アカウントをCreateするとき、または PowerShell、CLI、Azure SDK、または REST API を使用してプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションですべての REST API にアクセスできます。 つまり、このキーは、発行先のアカウントのマスター キーとして使用できます。
公開されているアプリケーションの場合は、機密クライアント アプリケーション のアプローチを使用して、キーを安全に格納できるように、Azure Maps REST API にアクセスすることをお勧めします。
Type:
apiKey
In:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソースの List SAS 操作から作成される共有アクセス署名トークンです。
このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンに対するきめ細かい制御が許可されます。 言い換えると、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できます。
公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定のリストを構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。
Type:
apiKey
In:
header
例
Successfully retrieve detailed daily weather forecast for a given coordinate location
Sample Request
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5
Sample Response
{
"summary": {
"startDate": "2019-11-17T09:00:00-08:00",
"endDate": "2019-11-17T15:00:00-08:00",
"severity": 5,
"phrase": "Rain Sunday evening",
"category": "rain"
},
"forecasts": [
{
"date": "2019-11-13T21:00:00-08:00",
"temperature": {
"minimum": {
"value": 0.8,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 5.3,
"unit": "C",
"unitType": 17
}
},
"realFeelTemperature": {
"minimum": {
"value": -3.4,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 1.3,
"unit": "C",
"unitType": 17
}
},
"realFeelTemperatureShade": {
"minimum": {
"value": -3.4,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 1.6,
"unit": "C",
"unitType": 17
}
},
"hoursOfSun": 1.1,
"degreeDaySummary": {
"heating": {
"value": 15,
"unit": "C",
"unitType": 17
},
"cooling": {
"value": 0,
"unit": "C",
"unitType": 17
}
},
"airAndPollen": [
{
"name": "AirQuality",
"value": 0,
"category": "Good",
"categoryValue": 1,
"type": "Ozone"
},
{
"name": "Grass",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Mold",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Ragweed",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "Tree",
"value": 0,
"category": "Low",
"categoryValue": 1
},
{
"name": "UVIndex",
"value": 0,
"category": "Low",
"categoryValue": 1
}
],
"day": {
"iconCode": 12,
"iconPhrase": "Showers",
"hasPrecipitation": true,
"precipitationType": "Rain",
"precipitationIntensity": "Light",
"shortPhrase": "Cloudy with a few showers",
"longPhrase": "Cloudy with a couple of showers, mainly later",
"precipitationProbability": 75,
"thunderstormProbability": 20,
"rainProbability": 75,
"snowProbability": 40,
"iceProbability": 0,
"wind": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"value": 16.7,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"direction": {
"degrees": 160,
"localizedDescription": "SSE"
},
"speed": {
"value": 48.2,
"unit": "km/h",
"unitType": 7
}
},
"totalLiquid": {
"value": 6.1,
"unit": "mm",
"unitType": 3
},
"rain": {
"value": 6.1,
"unit": "mm",
"unitType": 3
},
"snow": {
"value": 0,
"unit": "cm",
"unitType": 4
},
"ice": {
"value": 0,
"unit": "mm",
"unitType": 3
},
"hoursOfPrecipitation": 3.5,
"hoursOfRain": 3.5,
"hoursOfSnow": 0,
"hoursOfIce": 0,
"cloudCover": 100
},
"night": {
"iconCode": 12,
"iconPhrase": "Showers",
"hasPrecipitation": true,
"precipitationType": "Rain",
"precipitationIntensity": "Light",
"shortPhrase": "Breezy early; cloudy",
"longPhrase": "Breezy this evening; otherwise, low clouds",
"precipitationProbability": 65,
"thunderstormProbability": 0,
"rainProbability": 64,
"snowProbability": 40,
"iceProbability": 0,
"wind": {
"direction": {
"degrees": 181,
"localizedDescription": "S"
},
"speed": {
"value": 20.4,
"unit": "km/h",
"unitType": 7
}
},
"windGust": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"value": 42.6,
"unit": "km/h",
"unitType": 7
}
},
"totalLiquid": {
"value": 4,
"unit": "mm",
"unitType": 3
},
"rain": {
"value": 4,
"unit": "mm",
"unitType": 3
},
"snow": {
"value": 0,
"unit": "cm",
"unitType": 4
},
"ice": {
"value": 0,
"unit": "mm",
"unitType": 3
},
"hoursOfPrecipitation": 2.5,
"hoursOfRain": 2.5,
"hoursOfSnow": 0,
"hoursOfIce": 0,
"cloudCover": 98
},
"sources": [
"AccuWeather"
]
}
]
}
定義
名前 | 説明 |
---|---|
Air |
|
Daily |
|
Daily |
|
Daily |
要求された期間のメイン条件の概要。 概要には、期間の一部のみを含めることができることに注意してください。 |
Day |
|
Degree |
|
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Icon |
を表示 |
Json |
応答の目的の形式。 サポートされているのは |
Local |
ローカル気象データ プロバイダー情報。 |
Precipitation |
降水の種類を指定します ("Rain" "Snow" "Ice" または "Mix")。 dbz が 0 の場合、応答に precipitationType は存在しません。 |
Unit |
表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「Azure Mapsの天気予報サービス」を参照してください。 |
Weather |
メトリック単位またはインペリアル単位のいずれかでデータを返すように指定します。 既定値はメトリックです。 |
Weather |
天気に関連する特定の単位の特定の値。 |
Weather |
返される温度値。 |
Wind |
速度と方向を含む風の詳細が返されます。 |
Wind |
風向 |
AirAndPollen
名前 | 型 | 説明 |
---|---|---|
category |
string |
大気質または汚染タイプの分類。 たとえば、低、高、良好、中、異常、危険です。 |
categoryValue |
integer |
大気質または汚染カテゴリに関連付けられている値。 これらの値の範囲は 1 ~ 6 です。 1は良い条件を意味し、6は危険な状態を意味する。 |
name |
string |
花粉または汚染物質の名前。 たとえば、草、カビ、草、空気の質、木、UV インデックスなどです。 |
type |
string |
空気質のためにだけ存在する。 例としては、オゾンおよび粒子汚染が挙げられる。 |
value |
integer |
上記の指定された型の値。 金型、草、草、草、木に関連する値は、立方メートルあたりの部品の単位です。 空気質とUVはどちらも指標であるため、単位なしです。 |
DailyForecast
名前 | 型 | 説明 |
---|---|---|
airAndPollen |
空気の質 |
|
date |
string |
ISO 8601 形式で表示されている現在の観測値の日付と時刻 (例: 2019-10-27T19:39:57-08:00)。 |
day |
日の予測の詳細 |
|
degreeDaySummary |
暖房度の日または冷却度の日情報の平均温度の概要 |
|
hoursOfSun |
number |
太陽の時間。 |
night |
夜間予測の詳細 |
|
realFeelTemperature |
RealFeel™ Temperature が返されます。 |
|
realFeelTemperatureShade |
RealFeel™ Temperature が返されます。 日陰での温度の実際の感じ方について説明します。 |
|
sources |
string[] |
予測データのソース。 |
temperature |
その日の温度値。 |
DailyForecastResult
名前 | 型 | 説明 |
---|---|---|
forecasts |
要求された各日のデータを予測します。 |
|
summary |
要求された期間のメイン条件の概要。 概要には、期間の一部のみを含めることができることに注意してください。 |
DailyForecastSummary
要求された期間のメイン条件の概要。 概要には、期間の一部のみを含めることができることに注意してください。
名前 | 型 | 説明 |
---|---|---|
category |
string |
語句を要約する 1 つまたは 2 つの単語。 |
endDate |
string |
サマリー期間が終了する日付と時刻 。ISO 8601 形式で表示されます (例: 2019-10-27T19:39:57-08:00)。 |
phrase |
string |
毎日の予測の概要語句。 指定した言語で表示されます。 |
severity |
integer |
severity |
startDate |
string |
概要が有効な日付と時刻。ISO 8601 形式で表示されます (例: 2019-10-27T19:39:57-08:00)。 |
DayOrNight
名前 | 型 | 説明 |
---|---|---|
cloudCover |
integer |
クラウド カバーを表す割合。 |
hasPrecipitation |
boolean |
降水量の有無を示します。 True は降水量の存在を示し、false は降水量がないことを示します。 |
hoursOfIce |
number |
氷の時間。 |
hoursOfPrecipitation |
number |
降水量の時間 |
hoursOfRain |
number |
雨の時間。 |
hoursOfSnow |
number |
雪の時間。 |
ice |
凍雨 |
|
iceProbability |
integer |
氷の確率を表す割合。 たとえば、'30' などです。 |
iconCode |
を表示 |
|
iconPhrase |
string |
アイコンの語句の説明。 指定した言語で表示されます。 たとえば、"Sunny" などです。 |
localSource |
ローカル気象データ プロバイダー情報。 |
|
longPhrase |
string |
指定した言語での予測の語句の説明。 Azure Mapsは、この語句の長さを 100 文字以下に抑えようとしますが、一部の言語/気象イベントでは、100 文字を超える長さの語句が発生する可能性があります。 |
precipitationIntensity |
string |
強度の説明。 |
precipitationProbability |
integer |
降水量の確率を表す割合。 たとえば、'20' などです。 |
precipitationType |
降水量の種類を指定します ("Rain" "Snow" "Ice" または "Mix")。 dbz が 0 の場合、応答に precipitationType は存在しません。 |
|
rain |
雨 |
|
rainProbability |
integer |
雨の確率を表す割合。 たとえば、'40' などです。 |
shortPhrase |
string |
指定した言語での予測の語句の説明。 Azure Mapsは、この語句の長さを 30 文字以下に抑えようとしますが、一部の言語/気象イベントでは、フレーズの長さが長くなり、30 文字を超える可能性があります。 |
snow |
雪 |
|
snowProbability |
integer |
雪の確率を表す割合。 たとえば、'30' などです。 |
thunderstormProbability |
integer |
雷雨の確率を表す割合。 たとえば、'80' などです。 |
totalLiquid |
予測期間中の降水量に相当する液体の合計。 |
|
wind |
速度と方向を含む風の詳細が返されます。 |
|
windGust |
風の突風。 突風は、風の速度の急激な、短い増加です。 |
DegreeDaySummary
名前 | 型 | 説明 |
---|---|---|
cooling |
平均温度が 65 度 F/ 18 度 C を超える度数。 |
|
heating |
平均温度が 65 度 F/ 18 度 C を下回る度数。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
IconCode
を表示 iconPhrase
するイメージを表す数値。 詳細については、「Azure Mapsの天気予報サービス」を参照してください。
名前 | 型 | 説明 |
---|---|---|
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 |
LocalSource
ローカル気象データ プロバイダー情報。
名前 | 型 | 説明 |
---|---|---|
id |
integer |
ローカル データ プロバイダーに固有の数値識別子。 |
name |
string |
ローカル データ プロバイダーの名前。 名前は、URL の言語コードで指定された言語 (使用可能な場合) で表示されます。 それ以外の場合、Name は英語または名前が指定された言語で表示されます。 |
weatherCode |
string |
ローカル データ プロバイダーによって提供される気象コード。 この天気予報コードを使用すると、Azure Mapsアイコンではなく、ローカル データ プロバイダーによって提供されるアイコンと予測を照合できます。 |
PrecipitationType
降水の種類を指定します ("Rain" "Snow" "Ice" または "Mix")。 dbz が 0 の場合、応答に precipitationType は存在しません。
名前 | 型 | 説明 |
---|---|---|
Ice |
string |
凍雨 |
Mix |
string |
ミックス |
Rain |
string |
雨 |
Snow |
string |
雪 |
UnitType
表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「Azure Mapsの天気予報サービス」を参照してください。
名前 | 型 | 説明 |
---|---|---|
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 |
表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「Azure Mapsの天気予報サービス」を参照してください。 |
|
value |
number |
丸められた値。 |
WeatherUnitRange
返される温度値。
名前 | 型 | 説明 |
---|---|---|
maximum |
期間の最高温度 |
|
minimum |
期間の最小温度。 |
WindDetails
速度と方向を含む風の詳細が返されます。
名前 | 型 | 説明 |
---|---|---|
direction |
風向 |
|
speed |
指定した単位の風の速度。 |
WindDirection
風向
名前 | 型 | 説明 |
---|---|---|
degrees |
integer |
方位角の風向き。真北から始まり、時計回りの方向に続きます。 北は 0 度、東は 90 度、南は 180 度、西は 270 度です。 指定できる値は 0 から 359 です。 |
localizedDescription |
string |
指定した言語の方向の省略形。 |