Weather - Get Daily Forecast

リファレンス

サービス:: Maps

API バージョン:: 1.1

今後 1 日、5 日、10 日、15 日、25 日、または 45 日間の詳細な天気予報を毎日取得するために使用します。

Get Daily Forecast API は、特定の座標位置の次の 1、5、10、15、25、または 45 日間の日ごとの気温や風などの詳細な天気予報を返す HTTP GET リクエストです。この応答には、気温、風、降水量、大気質、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	JsonFormat	応答の目的の形式。 `json` 形式のみがサポートされています。
api-version	query	True	string	Azure Maps API のバージョン番号。
query	query	True	number[]	緯度の後に経度 (例: "47.641268,-122.125679") で構成されるコンマ区切り文字列として指定された該当するクエリ。気象情報は、通常、陸上の場所、陸地に囲まれた水域、および海岸線から約 50 海里以内の海域で利用できます。
duration	query		integer	日単位の予測応答が返される日数を指定します。使用可能な値は次のとおりです `1` - 翌日の予報データを返します。既定で返されます。 `5` - 今後 5 日間の予測データを返します。 `10` - 今後 10 日間の予測データを返します。 `25` - 今後 25 日間の予測データを返します。 S1 SKU でのみ使用できます。 `45` - 今後 45 日間の予測データを返します。 S1 SKU でのみ使用できます。
language	query		string	検索結果を返す言語。サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。詳細については、サポートされている言語のを参照してください。
unit	query		WeatherDataUnit	メートル法の単位またはインペリアル単位でデータを返すように指定します。デフォルト値は metric です。

要求ヘッダー

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

応答

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

注記

このセキュリティ定義使用して、アプリケーションがアクセスを要求している 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 プラットフォームの概要」を参照してください。

型: 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 detailed daily weather forecast for a given coordinate location

要求のサンプル

HTTP

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

応答のサンプル

状態コード:: 200

{
  "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"
      ]
    }
  ]
}

定義

名前	説明
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary	要求された期間の主な条件の概要。サマリーは期間の一部しかカバーできないことに注意してください。
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
IconCode	`iconPhrase`を表示するイメージを表す数値。詳細については、「 Azure Maps の天気サービス」を参照してください。
JsonFormat	応答の目的の形式。 `json` 形式のみがサポートされています。
LocalSource	地域の気象データプロバイダー情報。
PrecipitationType	降水の種類を指定します (「雨」、「雪」、「氷」、または「混合」)。 dbz が 0 の場合、応答に precipitationType は存在しません。
UnitType	表示されているユニットのタイプに関連付けられた数値 ID 値。単位の翻訳に使用できます。詳細については、「 Azure Maps の天気サービス」を参照してください。
WeatherDataUnit	メートル法の単位またはインペリアル単位でデータを返すように指定します。デフォルト値は metric です。
WeatherUnit	天候に関連する特定のユニットの特定の値。
WeatherUnitRange	返された温度値。
WindDetails	速度と方向を含む風の詳細が返されます。
WindDirection	風向

AirAndPollen

Object

名前	型	説明
category	string	大気質または汚染タイプのカテゴリ。たとえば、低、高、良好、中程度、不健康、危険です。
categoryValue	integer (int32)	大気質または汚染のカテゴリに関連付けられた値。これらの値の範囲は 1 から 6 です。 1は良好な状態を意味し、6は危険な状態を意味します。
name	string	花粉または汚染物質の名前。たとえば、草、カビ、雑草、空気の質、樹木、UVインデックスなどです。
type	string	空気の質のためだけに存在します。例としては、オゾンや粒子汚染などがあります。
value	integer (int32)	上記の指定されたタイプの値。カビ、草、雑草、樹木に関連する値は、立方メートルあたりの部品数単位です。空気の質とUVはどちらも指標であるため、単位がありません。

DailyForecast

Object

名前	型	説明
airAndPollen	AirAndPollen[]	空気の質
date	string (date-time)	ISO 8601 形式で表示された現在の観測の日時 (例: 2019-10-27T19:39:57-08:00)。
day	DayOrNight	日予報詳細
degreeDaySummary	DegreeDaySummary	Heating Degree Day または Cooling Degree Day 情報の平均温度の概要
hoursOfSun	number (float)	日照時間。
night	DayOrNight	夜間予報詳細
realFeelTemperature	WeatherUnitRange	RealFeel™ Temperatureが戻されます。
realFeelTemperatureShade	WeatherUnitRange	RealFeel™ Temperatureが戻されます。日陰で実際に感じる温度について説明します。
sources	string[]	予測データのソース。
temperature	WeatherUnitRange	その日の気温の値。

DailyForecastResult

Object

名前	型	説明
forecasts	DailyForecast[]	要求された各日の予測データ。
summary	DailyForecastSummary	要求された期間の主な条件の概要。サマリーは期間の一部しかカバーできないことに注意してください。

DailyForecastSummary

Object

要求された期間の主な条件の概要。サマリーは期間の一部しかカバーできないことに注意してください。

名前	型	説明
category	string	フレーズを要約するための1つまたは2つの単語。
endDate	string (date-time)	サマリー期間が終了する日時 (ISO 8601 形式 (例: 2019-10-27T19:39:57-08:00)。
phrase	string	日次予報の要約フレーズ。指定した言語で表示されます。
severity	integer (int32)	深刻さ
startDate	string (date-time)	サマリーが有効である日時は、ISO 8601 形式 (例: 2019-10-27T19:39:57-08:00) で表示されます。

DayOrNight

Object

名前	型	説明
cloudCover	integer (int32)	雲量を表すパーセント。
hasPrecipitation	boolean	降水量の有無を示します。 True は降水量の存在を示し、false は降水量がないことを示します。
hoursOfIce	number (float)	氷の時間。
hoursOfPrecipitation	number (float)	降水量
hoursOfRain	number (float)	雨が降る時間。
hoursOfSnow	number (float)	雪が降る時間。
ice	WeatherUnit	凍雨
iceProbability	integer (int32)	氷の確率を表すパーセント。たとえば、「30」のように入力します。
iconCode	IconCode (int32)	`iconPhrase`を表示するイメージを表す数値。詳細については、「 Azure Maps の天気サービス」を参照してください。
iconPhrase	string	アイコンのフレーズの説明。指定した言語で表示されます。たとえば、「サニー」などです。
localSource	LocalSource	地域の気象データプロバイダー情報。
longPhrase	string	指定した言語での予測のフレーズの説明。 Azure Maps では、このフレーズの長さを 100 文字未満に抑えようとしますが、一部の言語や気象イベントでは、フレーズの長さが長くなり、100 文字を超える場合があります。
precipitationIntensity	string	強度の説明。
precipitationProbability	integer (int32)	降水確率を表すパーセント。たとえば、「20」のように入力します。
precipitationType	PrecipitationType	降水の種類を指定します (「雨」、「雪」、「氷」、または「混合」)。 dbz が 0 の場合、応答に precipitationType は存在しません。
rain	WeatherUnit	雨
rainProbability	integer (int32)	降水確率を表すパーセント。たとえば、「40」です。
shortPhrase	string	指定した言語での予測のフレーズの説明。 Azure Maps では、このフレーズの長さを 30 文字未満に抑えようとしますが、言語や気象イベントによっては、フレーズの長さが長くなり、30 文字を超える場合があります。
snow	WeatherUnit	雪
snowProbability	integer (int32)	雪の確率を表すパーセント。たとえば、「30」のように入力します。
thunderstormProbability	integer (int32)	雷雨の確率を表すパーセント。たとえば、「80」です。
totalLiquid	WeatherUnit	予測期間中の降水量に相当する液体の合計。
wind	WindDetails	速度と方向を含む風の詳細が返されます。
windGust	WindDetails	突風。突風は、風の速度が突然、短時間増加することです。

DegreeDaySummary

Object

名前	型	説明
cooling	WeatherUnit	平均温度が65°F / 18°Cを超える度の数。
heating	WeatherUnit	平均温度が華氏65度/摂氏18度を下回る度数。

ErrorAdditionalInfo

Object

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

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラーメッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラーオブジェクト。

IconCode

列挙

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

値	説明
1	晴れ
10
11	霧
12	小雨
13	曇り一時小雨
14	晴れ時々小雨
15	雷雨
16	曇り一時雷雨
17	晴れ時々雷雨
18	雨
19	にわか雨
2	晴れ一時曇り
20	曇り一時にわか雨
21	晴れ時々にわか雨
22	雪
23	曇り一時雪
24	凍雨
25	みぞれ
26	雨氷
27
28
29	雨と雪
3	晴れ時々曇り
30	暑い
31	寒い
32	風が強い
33	透明
34	ほぼ晴れ
35	時々曇り
36	断続的な雲(夜)
37	薄月夜
38	曇り (夜)
39	曇り時々小雨
4	晴れたり曇ったり
40	曇り時々にわか雨(夜)
41	曇りときどき雷雨
42	曇り、雷雨(夜間)
43	曇り時々ちらつき(夜)
44	曇り、雪(夜)
5	薄晴れ
6	ほとんど曇り
7	曇り
8	どんよりした (曇り)
9

JsonFormat

列挙

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

値	説明
json	JavaScript オブジェクト表記データ交換形式をする

LocalSource

Object

地域の気象データプロバイダー情報。

名前	型	説明
id	integer (int32)	ローカルデータプロバイダーに固有の数値識別子。
name	string	ローカル・データ・プロバイダの名前。名前は、URL の言語コードで指定された言語で表示されます (使用可能な場合)。それ以外の場合、[名前] は英語または名前が指定された言語で表示されます。
weatherCode	string	地域のデータプロバイダーによって提供される天気コード。この天気コードを使用すると、Azure Maps のアイコンではなく、ローカルデータプロバイダーによって提供されるアイコンと予報を一致させることができます。

PrecipitationType

列挙

降水の種類を指定します (「雨」、「雪」、「氷」、または「混合」)。 dbz が 0 の場合、応答に precipitationType は存在しません。

値	説明
Ice	凍雨
Mix	混ぜる
Rain	雨
Snow	雪

UnitType

列挙

表示されているユニットのタイプに関連付けられた数値 ID 値。単位の翻訳に使用できます。詳細については、「 Azure Maps の天気サービス」を参照してください。

値	説明
0	フィート
1	インチ
10	メートル毎秒
11	ヘクトパスカル
12	水銀柱インチ
13	キロパスカル
14	ミリバール
15	水銀柱ミリメートル
16	ポンド/平方インチ
17	摂氏
18	ファラハイト
19	ケルビン
2	マイル
20	パーセント
21	フロート
22	整数 (integer)
3	ミリメートル
31	空気1立方メートルあたりのマイクログラム
4	センチメートル
5	メートル
6	キロメートル
7	キロメートル毎時
8	ノット
9	時速マイル

WeatherDataUnit

列挙

メートル法の単位またはインペリアル単位でデータを返すように指定します。デフォルト値は metric です。

値	説明
imperial	インペリアル単位でデータを返します。インペリアルシステムのいくつかの例は、華氏とマイルです。
metric	メートル単位でデータを返します。メートル法の単位の例としては、摂氏とキロメートルがあります。

WeatherUnit

Object

天候に関連する特定のユニットの特定の値。

名前	型	説明
unit	string	戻り値の単位のタイプ。
unitType	UnitType (int32)	表示されているユニットのタイプに関連付けられた数値 ID 値。単位の翻訳に使用できます。詳細については、「 Azure Maps の天気サービス」を参照してください。
value	number (float)	丸められた値。

WeatherUnitRange

Object

返された温度値。

名前	型	説明
maximum	WeatherUnit	その期間の最高気温
minimum	WeatherUnit	その時間帯の最低気温。

WindDetails

Object

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

名前	型	説明
direction	WindDirection	風向
speed	WeatherUnit	指定された単位での風速。

WindDirection

Object

風向

名前	型	説明
degrees	integer (int32)	方位角の風向は、真北から始まり、時計回りに続きます。北は 0 度、東は 90 度、南は 180 度、西は 270 度です。可能な値は 0 から 359 です。
localizedDescription	string	指定した言語での方向の省略形。

次の方法で共有

Weather - Get Daily Forecast

URI パラメーター

要求ヘッダー

応答

セキュリティ

AADToken

注記

スコープ

subscription-key

SAS Token

例

Successfully retrieve detailed daily weather forecast for a given coordinate location

要求のサンプル

応答のサンプル

定義

AirAndPollen

DailyForecast

DailyForecastResult

DailyForecastSummary

DayOrNight

DegreeDaySummary

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

LocalSource

PrecipitationType

UnitType

WeatherDataUnit

WeatherUnit

WeatherUnitRange

WindDetails

WindDirection