Weather - Get Daily Forecast

Service:: Maps

API バージョン:: 1.1

今後 1 日、5 日、10 日、15 日、25 日、または 45 日間の詳細な天気予報を毎日取得するために使用します。
Get Daily Forecast API は、特定の座標位置の次の 1、5、10、15、25、または 45 日間の日ごとの気温や風などの詳細な天気予報を返す HTTP GET リクエストです。この応答には、気温、風、降水量、大気質、UV 指数などの詳細が含まれます。詳細については、「毎日の天気予報データを要求する」を参照してください。

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}

省略可能なパラメーターを含む:

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}

URI パラメーター

Name	/	必須	型	説明
endpoint	path	True	string (uri)	Azure Mapsサービスのホストネーム。 Azureパブリッククラウドには`https://atlas.microsoft.com`を使いましょう。特定のAzure Maps地理やソブリンクラウドをターゲットにする場合は、Azure Maps地理的範囲を参照してください。
format	path	True	JsonFormat	応答の目的の形式。 `json` 形式のみがサポートされています。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。
query	query	True	number[]	緯度の後に経度 (例: "47.641268,-122.125679") で構成されるコンマ区切り文字列として指定された該当するクエリ。気象情報は、通常、陸上の場所、陸地に囲まれた水域、および海岸線から約 50 海里以内の海域で利用できます。
duration	query		integer (int32)	日単位の予測応答が返される日数を指定します。使用可能な値は次のとおりです `1` - 翌日の予報データを返します。既定で返されます。 `5` - 今後 5 日間の予測データを返します。 `10` - 今後 10 日間の予測データを返します。 `25` - 今後 25 日間の予測データを返します。 `45` - 今後 45 日間の予測データを返します。
language	query		string	検索結果を返す言語。サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。詳細については、サポートされている言語のを参照してください。
unit	query		WeatherDataUnit	メートル法の単位またはインペリアル単位でデータを返すように指定します。デフォルト値は metric です。

要求ヘッダー

Name	必須	型	説明
x-ms-client-id		string	Microsoft Entra IDセキュリティモデルで使用されることを意図したアカウントを示します。このAzure Mapsアカウントの一意IDは、Azure Maps管理プレーンのアカウントAPIから取得できます。 Azure MapsにおけるMicrosoft Entra IDセキュリティの使用についての詳細は、Azure Mapsの認証管理Manage certificationをご覧ください。

応答

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

Note

このセキュリティ定義使用して、アプリケーションがアクセスを要求している 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

スコープ

Name	説明
https://atlas.microsoft.com/.default

subscription-key

これは、Azure portal で、または PowerShell、CLI、Azure SDK、または REST API を使用して Azure Maps アカウントを作成場合にプロビジョニングされる共有キーです。

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

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

型: apiKey
/: header

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

{
  "forecasts": [
    {
      "airAndPollen": [
        {
          "name": "AirQuality",
          "type": "Ozone",
          "category": "Good",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Grass",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Mold",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Ragweed",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Tree",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "UVIndex",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        }
      ],
      "date": "2019-11-13T21:00:00-08:00",
      "day": {
        "cloudCover": 100,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationIntensity": "Light",
        "precipitationProbability": 75,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "rainProbability": 75,
        "shortPhrase": "Cloudy with a few showers",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 20,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 16.7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 48.2
          }
        }
      },
      "degreeDaySummary": {
        "cooling": {
          "unit": "C",
          "unitType": 17,
          "value": 0
        },
        "heating": {
          "unit": "C",
          "unitType": 17,
          "value": 15
        }
      },
      "hoursOfSun": 1.1,
      "night": {
        "cloudCover": 98,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationIntensity": "Light",
        "precipitationProbability": 65,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "rainProbability": 64,
        "shortPhrase": "Breezy early; cloudy",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 0,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 20.4
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 42.6
          }
        }
      },
      "realFeelTemperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "realFeelTemperatureShade": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.6
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "sources": [
        "AccuWeather"
      ],
      "temperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 5.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": 0.8
        }
      }
    }
  ],
  "summary": {
    "category": "rain",
    "endDate": "2019-11-17T15:00:00-08:00",
    "phrase": "Rain Sunday evening",
    "severity": 5,
    "startDate": "2019-11-17T09:00:00-08:00"
  }
}

定義

Name	説明
AirAndPollen	`DailyForecast.airAndPollen`の1つの項目は、その日の花粉、大気質、または紫外線指数の指標を記述しています。 `name`プロパティは、エントリがどの種類の指標を表すかを決定します: 花粉:`name`は樹木、草、ブタクサ、またはカビです。 `value`予測金額を示し、低から高`category` / `categoryValue`順に評価します。大気質:`name`大気質`type`であり、測定対象の汚染物質(PM2.5、PM10、O3、NO2、SO2、またはCOのいずれか)を識別します。 `category` / `categoryValue` 大気質を「良好」から「危険」まで評価してください。 UV指数:`name`UVIndexです。 `value` はUV指数(0から11+)であり、 `category` / `categoryValue` 曝露リスクを低から極限まで評価します。 `category` は指示器の定性ラベルであり、 `categoryValue` は1-6の評価に合わせられます。ここで1 は最も安全な状態、 6 は最も危険な状態を示します。
DailyForecast	指定された場所での1暦日の予報は、`DailyForecastResult`の`forecasts`配列で1日1エントリーとして返されました。日中の最高・最低気温範囲、RealFeelの範囲(規則的および日陰)、予想日照時間、暖房・冷房度と日中の合計、大気質、花粉、紫外線指数の指標、そして昼夜の各詳細ブロック(降水量、風、雲量など)が含まれます。 `sources`配列は、予測に貢献するデータ提供者を一覧にします。
DailyForecastDetail	半日分の予報詳細。同じ形は `DailyForecast.day` (日の出から日没)と `DailyForecast.night` (日没から次の日の出まで)の両方に使われているため、以下の「この期間」は特定の昼間または夜の部分を指し、24時間の完全な日を指すことはありません。予報アイコンやフレーズ、降水量の種類・強度・確率、積水量、降水時間、風、雲量が含まれます。
DailyForecastResult	回答は「Get Daily Forecast」操作から返送され、指定された場所の日ごとの天気予報を提供しました。要求されたウィンドウの支配的な条件と深刻さを説明するトップレベル `summary`と、1日に1つの`DailyForecast`エントリを持つ`forecasts`配列を含みます。応募数はリクエストされた `duration` (1日、5日、10日、15日、25日、または45日、25日と45日はS1 SKUが必要です)に合致します。
DailyForecastSummary	要求された日次予報ウィンドウの一部または全期間にわたる支配的な気象条件の概要です。要約されたウィンドウは、例えば重要な気象(例えば嵐のシステム)が期間の一部にしか予想されない場合など、完全なリクエストよりも狭く、 `startDate` と `endDate`で区切られます。条件自体は、自由形式の `phrase`、1語または2語の `category` ラベル、数値 `severity` 評価の両方として説明されています。
DegreeDaySummary	建物の暖房または冷房のエネルギー需要を推定するために使われる、1日の暖房および冷房度日の合計。各値は、要求で指定された温度単位で、その日の平均気温が 65°F(18°C) 基準線とどれだけ異なるかを示します。基準線以下の度数は `heating`、それ以上の度数は `cooling`に寄与します。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。
IconCode	どのアイコンを表示するかを示す数値の天候コードです。この列挙の各値は、晴れ、雲、雷雨などのAzure Maps天気アイコンに対応し、人間が読み取れる返`iconPhrase`と組み合わされます。同じコードは、現在、時間ごとの、日次、四半日、分単位の応答に現れることがあり、アプリケーションはすべての気象サービスで一貫したアイコンセットを表示できます。コードの完全なリスト、それらがマッピングするアイコン、例の画像については、Azure Mapsの気象サービスをご覧ください。
JsonFormat	応答の目的の形式。 `json` 形式のみがサポートされています。
LocalSource	`DailyForecastDetail.localSource`の予報を提供するために使用された地元の気象データ提供者に関する情報。プロバイダー(`id`、`name`)を特定し、プロバイダーのネイティブ`weatherCode`を公開することで、アプリケーションがデフォルトのAzure Mapsアイコンの代わりにプロバイダー独自のアイコンセットを表示できるようにします。
PrecipitationType	降水のタイプを指定します。有効な値は雨、雪、氷、または混合です。このプロパティは、dBZ が 0 より大きい場合の応答に含まれます。
UnitType	表示されるユニットの種類に関連する整数値。たとえば、摂氏の場合は 17、華氏の場合は 18 です。単位の翻訳に使用できます。詳細については、Azure Maps<>>の
WeatherDataUnit	メートル法か数数単位かを表示し、デフォルトはメートル法を指定します。例えば次が挙げられます。メートル法:ミリメートル(mm)、メートル(m)、キロメートル(km)、摂氏(C) インペリアル:インチ(イン)、フット(フィート)、マイル(mi)、華氏(F)
WeatherValue	気温、露点、風速などの気象関連指標の値は、単位URIパラメータで指定されたメートル法またはインペリアル単位で示されます。詳細は「Azure Mapsの気象サービス」の「ユニットタイプ」をご覧ください。
WeatherValueRange	指定された期間の最高および最低気温を、要求で指定された単位に基づき、摂氏(°C)または華氏(°F)で測定します。
WindDetails	請求で指定された単位に応じて、キロメートル毎時(km/h)やマイル毎時(mph)などの単位で測られる予報風速を提供します。また、真北から時計回りに進む方位角で測る風向きも示します。北は0°、東は90°、南は180°、西は270°に対応します。可能な値は0°から359°の範囲です。
WindDirection	方位角での風向きや風向きの局所的な略称を含む風向きの詳細を提供します。

AirAndPollen

Object

DailyForecast.airAndPollenの1つの項目は、その日の花粉、大気質、または紫外線指数の指標を記述しています。 nameプロパティは、エントリがどの種類の指標を表すかを決定します:

花粉:nameは樹木、草、ブタクサ、またはカビです。 value予測金額を示し、低から高category / categoryValue順に評価します。
大気質:name大気質typeであり、測定対象の汚染物質(PM2.5、PM10、O3、NO2、SO2、またはCOのいずれか)を識別します。 category / categoryValue 大気質を 「良好 」から 「危険」まで評価してください。
UV指数:nameUVIndexです。 value はUV指数(0から11+)であり、 category / categoryValue 曝露リスクを低から極限まで評価します。

category は指示器の定性ラベルであり、 categoryValue は1-6の評価に合わせられます 。ここで1 は最も安全な状態、 6 は最も危険な状態を示します。

Name	型	説明
category	string	指示器の短い質的ラベルで、リクエストで指定された言語で返されます。可能な値は `name`によって異なります。花粉:低、中、高、または非常に高い。大気質:良好、中程度、敏感なグループにとって不健康、不健康、非常に不健康、または危険。紫外線指数: 低、中程度、高、非常に高、または極端。
categoryValue	integer (int32)	1から6までの数値評価は `category`と組み合わさっており、 1 は最も安全な状況、 6 は最も危険な状態を示します。局所化された `category` ラベルの代わりに、安定的で言語に依存しない数値値が必要な場合はこれを用いてください。
name	string	このエントリがどの指標を表すかを特定します。花粉源の名前(樹木、草、ブタクサ、カビ)、大気質 (この `type` 場合は汚染物質を特定)、またはUVIndexのいずれかです。
type	string	`name`が大気質(AirQuality)の場合、測定される特定の汚染物質です PM2.5、PM10、O3(オゾン)、NO2(二酸化窒素)、SO2(二酸化硫黄)、または一酸化炭素(CO)のいずれかです。花粉やUV指数の記録は返送されません。
value	integer (int32)	この指標の数値測定。ユニットは `name`に依存します: 花粉については、予測される花粉カウントです。大気質については、汚染物質に応じた単位で汚染物質濃度を示します。粒子状物質は通常マイクログラム毎立方メートル(μg/m³)、オゾンなどのガスは億分の一(ppb)です。 UVインデックスの場合、0から11+までのインデックス値です。大気質と紫外線指数はそれぞれ指数なので、単位のない数値として報告されます。

DailyForecast

Object

指定された場所での1暦日の予報は、DailyForecastResultのforecasts配列で1日1エントリーとして返されました。日中の最高・最低気温範囲、RealFeelの範囲(規則的および日陰)、予想日照時間、暖房・冷房度と日中の合計、大気質、花粉、紫外線指数の指標、そして昼夜の各詳細ブロック(降水量、風、雲量など)が含まれます。 sources配列は、予測に貢献するデータ提供者を一覧にします。

Name	型	説明
airAndPollen	AirAndPollen[]	その日の予測大気質、花粉、紫外線指数の指標です。各エントリーは名前(例えばTree、Grass、Wogweed、Mold、AirQuality、UVIndex)、数値、そして質的な`category`(Low、Moderate、High、Good、Unhealthy、Hazardousなど)を報告し、申請書に潜在的な健康リスクをフラグ付けできます。
date	string (date-time)	この予報は ISO 8601 形式(`yyyy-mm-ddThh:mm:ss-hh:mm`)でカバーするカレンダー日付です。例えば、 2025-04-29T07:00:00-07:00です。
day	DailyForecastDetail	日中の詳細な天気予報で、気温、降水量、風、雲量、その他の重要な要素が含まれます。
degreeDaySummary	DegreeDaySummary	建物の気候制御に必要なエネルギー需要を推定するために使われる、1日の暖房・冷房・日数の合計。
hoursOfSun	number (float)	日中の予想日照時間数は、屋外活動の計画や日中の総合的な状況の把握に役立ちます。
night	DailyForecastDetail	夜間の詳細な天気予報で、気温、降水、風、雲量、その他の重要な要素が含まれます。
realFeelTemperature	WeatherValueRange	リクエストで指定された単位に応じて、その日の最高および最低リアルフィール™温度値(摂氏(°C)または華氏(°F)で示します。 AccuWeatherによって開発されたRealFeelは、気温と湿度、風、雲の被覆、日照強度などの要素を組み合わせて、実際の天気の感覚を示します。詳細については、「AccuWeather RealFeelの温度とは何か?」をご覧ください。
realFeelTemperatureShade	WeatherValueRange	日陰の場所における1日のRealFeel™最高・最低温度値は、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で示されます。 `realFeelTemperature`に似ていますが、直射日光の暖かさを排除しているため、日陰での天気の感覚をより正確に感じられます。
sources	string[]	この日の予報に貢献したデータ提供者たち。
temperature	WeatherValueRange	その日の最高気温と最低気温の予測は、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で示されます。

DailyForecastDetail

Object

半日分の予報詳細。同じ形は DailyForecast.day (日の出から日没)と DailyForecast.night (日没から次の日の出まで)の両方に使われているため、以下の「この期間」は特定の昼間または夜の部分を指し、24時間の完全な日を指すことはありません。予報アイコンやフレーズ、降水量の種類・強度・確率、積水量、降水時間、風、雲量が含まれます。

Name	型	説明
cloudCover	integer (int32)	この期間中の空の雲に覆われる割合は、 0 (晴空)から 100 (完全に曇り空)までです。 NULL である可能性があります。
hasPrecipitation	boolean	`true` この期間中に降水(雨、雪、みぞれ、ひょう)が予想される場合;それ以外の場合は `false` 。
hoursOfIce	number (float)	この期間に氷の形成が予想される合計時間。
hoursOfPrecipitation	number (float)	この期間中に降水(雨、雪、みぞれ、雹)が予想される合計時間数。
hoursOfRain	number (float)	この期間の雨が予想される合計時間数。
hoursOfSnow	number (float)	この期間の雪が予想される総時間数。
ice	WeatherValue	この期間中に予想される氷の蓄積量は、要求で指定された単位によってミリメートル(mm)またはインチ(in)単位で示されます。
iceProbability	integer (int32)	この期間中に氷が発生する確率は0から100までのパーセンテージで表され、 0 は氷の発生可能性が全くなく、 100 は確実な氷の状態を示します。
iconCode	IconCode	数値は、この期間の予報された気象条件に対応する画像を表し、 `iconPhrase` プロパティで表されます。数値はAzure Mapsの天気アイコンに対応しており、完全なリストについては「Azure Mapsの気象サービス」をご覧ください。 NULL である可能性があります。
iconPhrase	string	アイコンを説明する短いフレーズで、リクエストで指定された言語で返されます。例えば、サニー。
localSource	LocalSource	この期間に使用されたアイコンコードと気象コードが選ばれた地域の気象データ提供者に関する情報。
longPhrase	string	この期間のより長く説明的なフレーズが、リクエストで指定された言語で返されました。 Azure Mapsはこのフレーズを100文字未満に抑えようとしていますが、言語や気象によっては文字列が長くなることがあります。
precipitationIntensity	string	この期間の降水強度の簡潔な定性的記述です。例えば、軽度、中程度、または重度です。リクエストで指定された言語で返され、 `hasPrecipitation` が `true`された場合にのみ返されます。
precipitationProbability	integer (int32)	この期間中に降水が降る確率は0から100までのパーセンテージで表されます。0は降水の可能性が全くなく、 100 は降水が確実であることを示します。
precipitationType	PrecipitationType	この期間に予想される主な降水の種類は、雨、雪、氷、または混合のいずれかです。 `true` `hasPrecipitation`が終わった場合にのみ返品されます。
rain	WeatherValue	この期間に予想される降雨量は、要求で指定された単位によってミリメートル(mm)またはインチ(in)で示されます。
rainProbability	integer (int32)	この期間中の降雨確率は0から100までのパーセンテージで表され、 0 は降る可能性が全くなく、 100 は確実な降雨です。
shortPhrase	string	この期間の予測を説明する短いフレーズを、リクエストで指定された言語で返します。 Azure Mapsはこのフレーズを30文字以内に抑えようとしていますが、言語や天候によっては長い文字列になることもあります。
snow	WeatherValue	この期間中に予想される積雪量は、請求で指定された単位によってセンチメートル(cm)またはインチ(in)で計です。
snowProbability	integer (int32)	この期間中の雪の確率は0から100までのパーセンテージで表され、 0 は雪の可能性がゼロ、 100 は確実な雪です。
thunderstormProbability	integer (int32)	この期間中の雷雨の確率は0から100までのパーセンテージで表され、 0 は雷雨の可能性がゼロ、 100 は雷雨が確実に起こることを意味します。
totalLiquid	WeatherValue	この期間中に予想される液体降水量(雨水や、雪や氷の液体換算量を加えたもの)は、要求で指定された単位に応じてミリメートル(mm)またはインチ(in)で示されます。
wind	WindDetails	この期間の予報風速と風向き。風速は、請求で指定された単位によって、キロメートル毎時(km/h)またはマイル毎時(mph)で表されます。風向きは方位角で測定され、0°(真北)から359°まで、時計回りに動きます。東は90°、南は180°、西は270°です。
windGust	WindDetails	この期間中の予想される最大短時間風速と風向。突風は突然で、短時間の風速増加であり、航空、セーリング、凧揚げなどの活動に重要なものです。速度は請求で指定された単位によってキロメートル毎時(km/h)またはマイル毎時(mph)で表され、方向も `wind`と同じ方位角の慣習を用いています。

DailyForecastResult

Object

回答は「Get Daily Forecast」操作から返送され、指定された場所の日ごとの天気予報を提供しました。要求されたウィンドウの支配的な条件と深刻さを説明するトップレベル summaryと、1日に1つのDailyForecastエントリを持つforecasts配列を含みます。応募数はリクエストされた duration (1日、5日、10日、15日、25日、または45日、25日と45日はS1 SKUが必要です)に合致します。

Name 型説明

forecasts

Name	型	説明
forecasts	DailyForecast[]	1日ごとの天気予報は、時系列順で、リクエストされた `duration`に1日1回ずつ記載されています。各エントリーは、その日の最高・最低気温、RealFeel範囲、日照時間、暖房・冷却度と日の合計、空気と花粉の指数、昼夜の個別の詳細ブロック(降水量、風、雲量など)、そして予報に寄与するデータソースを報告する `DailyForecast` です。
summary	DailyForecastSummary	要求された予報ウィンドウにおける支配的な気象条件の概要です。要約はウィンドウの一部しかカバーできない場合があります例えば、嵐のような重要な天候がその期間全体ではなく、一部に予告される場合などです。

DailyForecast[]

1日ごとの天気予報は、時系列順で、リクエストされた durationに1日1回ずつ記載されています。各エントリーは、その日の最高・最低気温、RealFeel範囲、日照時間、暖房・冷却度と日の合計、空気と花粉の指数、昼夜の個別の詳細ブロック(降水量、風、雲量など)、そして予報に寄与するデータソースを報告する DailyForecast です。

summary

DailyForecastSummary

要求された予報ウィンドウにおける支配的な気象条件の概要です。要約はウィンドウの一部しかカバーできない場合があります

例えば、嵐のような重要な天候がその期間全体ではなく、一部に予告される場合などです。

DailyForecastSummary

Object

要求された日次予報ウィンドウの一部または全期間にわたる支配的な気象条件の概要です。要約されたウィンドウは、例えば重要な気象(例えば嵐のシステム)が期間の一部にしか予想されない場合など、完全なリクエストよりも狭く、 startDate と endDateで区切られます。条件自体は、自由形式の phrase、1語または2語の category ラベル、数値 severity 評価の両方として説明されています。

Name	型	説明
category	string	要約された窓の支配的な気象条件を1語または2語で分類したラベル(例: 晴れ、部分的に曇り、雨、雪)。
endDate	string (date-time)	この要約でカバーされているウィンドウの終わり( RFC 3339 形式)は、例えば 2019-10-29T07:00:00-08:00です。要約されたイベントがその期間より先に終了する場合、その時間は要求された予報ウィンドウの終わりより早い場合もあります。
phrase	string	要約されたウィンドウの支配的な気象条件の簡潔で自由なテキスト要約が、リクエストで指定された言語で返されました。例えば、火曜日から木曜日まではにわか雨が予想されます。
severity	integer (int32)	要約された気象イベントの数値による深刻度評価。数字が小さいほど( 0を除く)は重症度が高いことを示します: 0: 不明 1: 重要性 2:メジャー 3:中庸 4:マイナー 5:ミニマル 6: 重要性 7:情報提供
startDate	string (date-time)	この要約でカバーされているウィンドウの開始点( RFC 3339 形式)は、例えば 2019-10-27T19:39:57-08:00です。要約されたイベントが途中で始まる場合は、要求された予報ウィンドウの開始より遅くなることがあります。

DegreeDaySummary

Object

建物の暖房または冷房のエネルギー需要を推定するために使われる、1日の暖房および冷房度日の合計。各値は、要求で指定された温度単位で、その日の平均気温が 65°F(18°C) 基準線とどれだけ異なるかを示します。基準線以下の度数は heating、それ以上の度数は coolingに寄与します。

Name	型	説明
cooling	WeatherValue	冷却度日数(CDD) - その日の平均気温が65°F(18°C) の基準線を超えて上昇する度数。値が高いほど冷却需要が大きいことを示します。請求で指定された単位に応じて、摂氏(°C)または華氏(°F)で報告されます。
heating	WeatherValue	暖房度日数(HDD)- その日の平均気温が65°F(18°C)の基準線を下回る度数。値が高いほど加熱需要が大きいことを示します。請求で指定された単位に応じて、摂氏(°C)または華氏(°F)で報告されます。

ErrorAdditionalInfo

Object

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

Name	型	説明
info		追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

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

ErrorResponse

Object

すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。

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

IconCode

列挙

どのアイコンを表示するかを示す数値の天候コードです。この列挙の各値は、晴れ、雲、雷雨などのAzure Maps天気アイコンに対応し、人間が読み取れる返iconPhraseと組み合わされます。同じコードは、現在、時間ごとの、日次、四半日、分単位の応答に現れることがあり、アプリケーションはすべての気象サービスで一貫したアイコンセットを表示できます。

コードの完全なリスト、それらがマッピングするアイコン、例の画像については、Azure Mapsの気象サービスをご覧ください。

値	説明
1	Sunny
2	晴れ一時曇り
3	晴れ時々曇り
4	晴れたり曇ったり
5	薄晴れ
6	ほとんど曇り
7	Cloudy
8	どんよりした (曇り)
11	Fog
12	Showers
13	曇り一時小雨
14	晴れ時々小雨
15	Thunderstorms
16	曇り一時雷雨
17	晴れ時々雷雨
18	Rain
19	Flurries
20	曇り一時にわか雨
21	晴れ時々にわか雨
22	Snow
23	曇り一時雪
24	氷
25	Sleet
26	雨氷
29	雨と雪
30	Hot
31	寒い
32	Windy
33	透明
34	ほぼ晴れ
35	時々曇り
36	晴れたり曇ったり
37	薄月夜
38	ほとんど曇り
39	曇り時々小雨
40	曇り一時小雨
41	曇りときどき雷雨
42	曇り一時雷雨
43	曇り一時にわか雨
44	曇り一時雪

JsonFormat

列挙

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

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

LocalSource

Object

DailyForecastDetail.localSourceの予報を提供するために使用された地元の気象データ提供者に関する情報。プロバイダー(id、name)を特定し、プロバイダーのネイティブweatherCodeを公開することで、アプリケーションがデフォルトのAzure Mapsアイコンの代わりにプロバイダー独自のアイコンセットを表示できるようにします。

Name	型	説明
id	integer (int32)	ローカルデータプロバイダーを一意に識別する数値識別子です。
name	string	利用可能な場合、リクエストで指定された言語で返されるローカルデータプロバイダーの名前;それ以外の場合は英語またはプロバイダーが提供した言語で返されます。
weatherCode	string	この予報のプロバイダーネイティブな天気コードで、プロバイダー自身のアイコンセットにマッピングするのに適しており、デフォルトのAzure Maps `iconCode`ではありません。

PrecipitationType

列挙

降水のタイプを指定します。有効な値は雨、雪、氷、または混合です。このプロパティは、dBZ が 0 より大きい場合の応答に含まれます。

値	説明
Ice	氷
Mix	Mix
Rain	Rain
Snow	Snow

UnitType

列挙

表示されるユニットの種類に関連する整数値。たとえば、摂氏の場合は 17、華氏の場合は 18 です。単位の翻訳に使用できます。詳細については、Azure Maps<>>の

値	説明
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	測定
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	Celsius
18	Fahrenheit
19	kelvin
20	percent
21	float
22	整数
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

列挙

メートル法か数数単位かを表示し、デフォルトはメートル法を指定します。例えば次が挙げられます。

メートル法:ミリメートル(mm)、メートル(m)、キロメートル(km)、摂氏(C)
インペリアル:インチ(イン)、フット(フィート)、マイル(mi)、華氏(F)

値	説明
imperial	温度を表すのは華氏(F)、距離を示すマイル(mi)などのインペリアル単位でデータを返します。
metric	温度は摂氏 (C)、距離はキロメートル (km) などのメートル単位を使用してデータを返します。

WeatherValue

Object

気温、露点、風速などの気象関連指標の値は、単位URIパラメータで指定されたメートル法またはインペリアル単位で示されます。詳細は「Azure Mapsの気象サービス」の「ユニットタイプ」をご覧ください。

Name	型	説明
unit	string	返還値に使われる単位、例えば「C」はCelsius、「F」は華氏(F)です。
unitType	UnitType	単位の種類を表す整数です。例えば、0はフィート、1はインチ、2はマイルです。完全なリストについては、「Azure MapsのWeather services」記事のユニットタイプをご覧ください。
value	number (float)	測定値は指定された単位で表されます。

WeatherValueRange

Object

指定された期間の最高および最低気温を、要求で指定された単位に基づき、摂氏(°C)または華氏(°F)で測定します。

Name	型	説明
maximum	WeatherValue	指定された時間枠の最高温度を、要求で指定された単位に基づき、摂氏(°C)または華氏(°F)で測定します。
minimum	WeatherValue	指定された時間枠の最低温度を、要求で指定された単位に基づき、摂氏(°C)または華氏(°F)で測定します。

WindDetails

Object

請求で指定された単位に応じて、キロメートル毎時(km/h)やマイル毎時(mph)などの単位で測られる予報風速を提供します。また、真北から時計回りに進む方位角で測る風向きも示します。北は0°、東は90°、南は180°、西は270°に対応します。可能な値は0°から359°の範囲です。

Name	型	説明
direction	WindDirection	風向きは真北(0°)から時計回りに進む方位角で測定されます。東は90°、南は180°、西は270°に対応します。可能な値は0°から359°の範囲です。この性質は風向きを表す整数を返します。
speed	WeatherValue	期待風速は、請求で指定された単位によってキロメートル毎時(km/h)またはマイル毎時(mph)で測定されます。

WindDirection

Object

方位角での風向きや風向きの局所的な略称を含む風向きの詳細を提供します。

Name	型	説明
degrees	integer (int32)	風向きは真北から時計回りに進む方位角で測定されます。北は0度、東は90度、南は180度、西は270度に対応します。可能な値は0度から359度までの範囲です。
localizedDescription	string	風向きの局所的な略称で、リクエストで指定された言語で返されます。例えば、北は `N` 、東は `E` 、南は `S` 、西は `W` です。