Weather - Get Daily Forecast

リファレンス

サービス:: Maps

API バージョン:: 1.1

次の 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	JsonFormat	応答の目的の形式。サポートされているのは `json` 形式のみです。
api-version	query	True	string	Azure Maps API のバージョン番号。
query	query	True	number[]	緯度の後に経度 (例: "47.641268,-122.125679" など) で構成されるコンマ区切り文字列として指定された該当するクエリ。
duration	query		integer	1 日の予測応答が返される日数を指定します。使用可能な値は次のとおりです。 `1` - 翌日の予測データを返します。既定で返されます。 `5` - 今後 5 日間の予測データを返します。 `10` - 今後 10 日間の予測データを返します。 `25` - 今後 25 日間の予測データを返します。 S1 SKU でのみ使用できます。 `45` - 今後 45 日間の予測データを返します。 S1 SKU でのみ使用できます。
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	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 とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。

メモ

このセキュリティ定義では、ヘッダーを使用して、 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 プラットフォームの概要」を参照してください。

型: 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 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 の Weather サービス」を参照してください。
JsonFormat	応答の目的の形式。サポートされているのは `json` 形式のみです。
LocalSource	ローカル気象データプロバイダー情報。
PrecipitationType	降水の種類を指定します ("Rain" "Snow" "Ice" または "Mix")。 dbz が 0 の場合、応答に precipitationType は存在しません。
UnitType	表示される単位の種類に関連付けられている数値 ID 値。単位変換に使用できます。詳細については、「 Azure Maps の Weather サービス」を参照してください。
WeatherDataUnit	メトリック単位または帝国単位のいずれかでデータを返すように指定します。既定値はメトリックです。
WeatherUnit	気象に関連する特定の単位の特定の値。
WeatherUnitRange	返される温度値。
WindDetails	速度と方向を含む風の詳細が返されます。
WindDirection	風向

AirAndPollen

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

DailyForecast

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

DailyForecastResult

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

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	WeatherUnit	凍雨
iceProbability	integer	氷の確率を表す割合。たとえば、'30' です。
iconCode	IconCode	を表示 `iconPhrase`するイメージを表す数値。詳細については、「 Azure Maps の Weather サービス」を参照してください。
iconPhrase	string	アイコンの語句の説明。指定した言語で表示されます。たとえば、"Sunny" などです。
localSource	LocalSource	ローカル気象データプロバイダー情報。
longPhrase	string	指定された言語での予測の語句の説明。 Azure Maps では、このフレーズの長さが 100 文字以下に保たれますが、一部の言語/気象イベントでは、フレーズの長さが長くなり、100 文字を超える場合があります。
precipitationIntensity	string	強度の説明。
precipitationProbability	integer	降水の確率を表す割合。たとえば、'20' です。
precipitationType	PrecipitationType	降水の種類を指定します ("Rain" "Snow" "Ice" または "Mix")。 dbz が 0 の場合、応答に precipitationType は存在しません。
rain	WeatherUnit	雨
rainProbability	integer	雨の確率を表す割合。たとえば、'40' です。
shortPhrase	string	指定された言語での予測の語句の説明。 Azure Maps では、このフレーズの長さが 30 文字以下に保たれますが、一部の言語/気象イベントでは、フレーズの長さが長くなり、30 文字を超える場合があります。
snow	WeatherUnit	雪
snowProbability	integer	雪の確率を表す割合。たとえば、'30' です。
thunderstormProbability	integer	雷雨の確率を表す割合。たとえば、'80' です。
totalLiquid	WeatherUnit	予測期間中の降水量に相当する合計液体。
wind	WindDetails	速度と方向を含む風の詳細が返されます。
windGust	WindDetails	風の突風。風の突風は、風の速度の急激な、短い増加です。

DegreeDaySummary

名前	型	説明
cooling	WeatherUnit	平均温度が 65 度 F/ 18°C を超える度数。
heating	WeatherUnit	平均温度が 65 度 F/ 18°C 未満の度数。

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 オブジェクト表記データ交換形式

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 の 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	指定した言語の方向の省略形。

次の方法で共有