Weather - Get Hourly Forecast

Service:
Maps
API バージョン:
1.1

最大24時間の詳細な時間ごとの天気予報、または最大10日間の日次天気予報を取得するために使用します。
Get Hourly Forecast API は、指定された座標位置に対して、次の 1、12、24 (1 日)、72 (3 日)、120 (5 日)、および 240 時間 (10 日) の時間単位の詳細な天気予報を要求する HTTP GETです。 この API は、温度、湿度、風、降水量、紫外線 (UV) 指数などの詳細を返します。 詳細については、「 時間ごとの天気予報データを要求する」を参照してください。

GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query={query}
省略可能なパラメーターを含む: 
GET {endpoint}/weather/forecast/hourly/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 - 次の 1 時間の予測データを返します。 既定値。
  • 12 - 次の12時間の時間ごとの予報を返します。
  • 24 - 次の24時間の時間ごとの予報を返します。
  • 72 - 次の 72 時間 (3 日間) の時間ごとの予報を返します。
  • 120 - 今後 120 時間 (5 日間) の時間ごとの予報を返します。
  • 240 - 今後 240 時間 (10 日間) の時間ごとの予報を返します。
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

HourlyForecastResult

要求は成功しました。
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 weather forecast by the hour

要求のサンプル

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

応答のサンプル

状態コード:
200 
{
  "forecasts": [
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 3901
      },
      "cloudCover": 100,
      "date": "2019-11-14T16:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": true,
      "precipitationProbability": 39,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 39,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 14.1
      },
      "relativeHumidity": 72,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.4
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.9
      },
      "wind": {
        "direction": {
          "degrees": 311,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.7
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 5.6
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4054
      },
      "cloudCover": 94,
      "date": "2019-11-14T17:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 34,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 34,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 12.8
      },
      "relativeHumidity": 73,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 12.5
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.2
      },
      "wind": {
        "direction": {
          "degrees": 281,
          "localizedDescription": "W"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 5.6
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4176
      },
      "cloudCover": 94,
      "date": "2019-11-14T18:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.4
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 29,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 29,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.3
      },
      "relativeHumidity": 77,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.3
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.5
      },
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4542
      },
      "cloudCover": 93,
      "date": "2019-11-14T19:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "relativeHumidity": 79,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.4
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "wind": {
        "direction": {
          "degrees": 169,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 11.1
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4389
      },
      "cloudCover": 92,
      "date": "2019-11-14T20:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "relativeHumidity": 80,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 11.1
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4481
      },
      "cloudCover": 91,
      "date": "2019-11-14T21:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.1
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4481
      },
      "cloudCover": 92,
      "date": "2019-11-14T22:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.2
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 84,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 3688
      },
      "cloudCover": 94,
      "date": "2019-11-14T23:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "wind": {
        "direction": {
          "degrees": 175,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 2926
      },
      "cloudCover": 97,
      "date": "2019-11-15T00:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "relativeHumidity": 81,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 176,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 2164
      },
      "cloudCover": 99,
      "date": "2019-11-15T01:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 21,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 21,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 81,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.9
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "wind": {
        "direction": {
          "degrees": 177,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 1737
      },
      "cloudCover": 100,
      "date": "2019-11-15T02:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 21,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 21,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 1311
      },
      "cloudCover": 100,
      "date": "2019-11-15T03:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 26,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 26,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "relativeHumidity": 83,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.7
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "wind": {
        "direction": {
          "degrees": 161,
          "localizedDescription": "SSE"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    }
  ]
}

定義

Name 説明
ErrorAdditionalInfo

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

エラーの詳細。
ErrorResponse

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

HourlyForecast天体は、日付と時刻、予想および知覚温度、露点などの時間ごとの気象情報を提供します。 風速と風向き、突風、相対湿度、視界、降水確率をカバーしています。 降水が予想されるかどうかを示し、その種類を指定します。 その他の特性には紫外線指数、雲被覆率、雲天井の高さがあります。 また、天候を表すアイコンコードやフレーズも付属しています。
HourlyForecastResult

回答は「Get Hourly Forecast」操作で返送され、指定された場所の時間ごとの天気予報が含まれていました。 返送されたHourlyForecastエントリー数は、要求された予報期間に一致しており、1、12、24、48、72、または96時間のいずれかです(HourlyDuration合同参照)。
IconCode

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

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

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

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

WeatherDataUnit

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

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

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

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

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

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

エラー オブジェクト。

HourlyForecast

Object

HourlyForecast天体は、日付と時刻、予想および知覚温度、露点などの時間ごとの気象情報を提供します。 風速と風向き、突風、相対湿度、視界、降水確率をカバーしています。 降水が予想されるかどうかを示し、その種類を指定します。 その他の特性には紫外線指数、雲被覆率、雲天井の高さがあります。 また、天候を表すアイコンコードやフレーズも付属しています。

Name 型 説明
ceiling

WeatherValue

地上から最も低い雲層の高さを、リクエストで指定された単位に基づいてフィートまたはメートルで測定します。 この測定は航空および気象予報において非常に重要です。
cloudCover

integer (int32)

指定された時間帯に雲に覆われた空の割合。 この値は0%(晴空)から100%(完全に曇り空)まで幅があります。 NULL である可能性があります。
date

string (date-time)

RFC 3339形式での予報の日付と時刻(yyyy-mm-ddThh:mm:ss±hh:mm)。 例えば、 2019-11-14T16:00:00-08:00です。
dewPoint

WeatherValue

空気が湿気や露で飽和し始める温度が形成されます。 単位によって華氏(°F)または摂氏(°C)で測定されます。 この値は湿度の理解に非常に重要で、露点が高いほど空気中の水分が増え、湿度が高く感じられます。
hasPrecipitation

boolean

指定された期間中に降水(雨、雪、みぞれ、雹)が予想されるかどうかを示すブール値です。 降水が予想される場合は真を返し、そうでなければ偽となります。
ice

WeatherValue

予報では、要求で指定された単位に応じて、1時間ごとの推定氷の蓄積量をミリメートル(mm)またはインチ(in)で測定します。
iceProbability

integer (int32)

指定された時間内に氷が形成される確率を示し、0から100までのパーセンテージで表します。 0は氷の形成の可能性がないことを意味し、100は氷の形成が確実であることを示します。 この情報は、凍結の可能性を評価するのに役立ちます。
iconCode

IconCode

iconPhraseを表示する画像に対応する数値です。 詳細については、Azure Maps<>>の

iconPhrase

string

特定の気象条件に対応する記述的な用語、例えば 晴れ。 iconCodeは、iconPhraseが説明した天候状況を視覚的に表現した画像を表す数値と組み合わされます。 詳細については、Azure Maps<>>の

isDaylight

boolean

指定された時間帯に日光時間かどうかを示すブール値です。 昼間なら真、そうでなければ偽を返します。
precipitationProbability

integer (int32)

指定された時間帯に降水確率を0から100までのパーセンテージで表します。 値が0なら降水の可能性がゼロ、100は降水が確実であることを示します。 これにより、雨や雪、その他の降水の可能性をユーザーが評価できます。
rain

WeatherValue

予報で毎時間予想される降雨量を、要求で指定された単位に応じてミリメートル(mm)またはインチ(in)で測定します。
rainProbability

integer (int32)

指定された期間中の降雨確率を0から100までのパーセンテージで示します。 0の値は雨の降りる可能性がゼロ、100は必ず降ることを意味します。
realFeelTemperature

WeatherValue

指定された時間のRealFeel™温度値を、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で測定します。 AccuWeatherが開発したこの指標は、湿度、風速、雲量、日照強度など十数の要素を取り入れ、実際に天気を感じる様子を包括的に測ることができます。

詳細については 、「AccuWeather RealFeelの温度とは何か?」をご覧ください。
relativeHumidity

integer (int32)

空気中に存在する水蒸気の量を、同じ温度で空気が保持できる最大水蒸気の割合で表します。 この値は空気がどれだけ湿気に満たされているかを示し、環境の快適さや湿度に影響を与えます。
snow

WeatherValue

指定された時間内に予想される積雪量を、要求で指定された単位に応じてミリメートル(mm)またはインチ(in)で測定します。
snowProbability

integer (int32)

指定された時間帯に降雪する確率を0から100までのパーセンテージで示します。 0は雪が降る可能性がゼロ、100は確実に雪が降ることを意味します。
temperature

WeatherValue

指定された時間の期待温度は、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で測定されます。
totalLiquid

WeatherValue

予報期間中の各時間に予想される液体降水量(例えば雨)を、要求で指定された単位に応じてミリメートル(mm)またはインチ(in)で測定します。
uvIndex

integer (int32)

予報期間中の各時間の紫外線(UV)指数を提供します。 この指数は予想される紫外線のレベルを示し、利用者が日光曝露の潜在的なリスクを理解するのに役立ちます。 サポートされる値は次のとおりです。

  • 0-2:太陽の紫外線や一般人からの危険性が低い。
  • 3-5:無防備な日光曝露による中程度の害のリスク。
  • 6-7:無防備な日光曝露による害のリスクが高い。
  • 8-10:無防備な日光曝露による非常に高い危害リスク。
  • 11+:無防備な日光曝露による極度の危険性。
uvIndexPhrase

string

低、中、高、非常に高いなどのUV放射レベルを示す記述的な表現を提供します。
visibility

WeatherValue

予報期間中の各時間で、要求で指定された単位に応じてキロメートル(km)またはマイル(mi)で測定可能な物体や光を明確に識別できる距離を返します。 これは、運転や航空などの活動において、どれだけ遠くまで見通せるかを示します。
wetBulbTemperature

WeatherValue

空気の塊が水分蒸発によって飽和状態(相対湿度100%)まで冷やされた場合の温度を返します。 この性質は熱ストレスや蒸発による冷却効果を理解する上で重要です。
wind

WindDetails

予想される風速と風向きを提供します。 風速は指定された単位に基づいて、キロメートル毎時(km/h)またはマイル毎時(mph)で測定されます。 風向きは方位角で測定され、0°(真北)から359°まで、時計回りに動く(東は90°、南は180°、西は270°)です。
windGust

WindDetails

予報期間中の各時間における予想される最大突風速を、指定された単位に基づいてキロメートル毎時(km/h)またはマイル毎時(mph)で測定します。 風向きは方位角で示され、0°(真北)から359°まで時計回りに動いています。 突風は風速が一時的に増加する現象であり、航空、セーリング、屋外イベントなどの活動に影響を与える短期的な変動を理解する上で重要です。

HourlyForecastResult

Object

回答は「Get Hourly Forecast」操作で返送され、指定された場所の時間ごとの天気予報が含まれていました。 返送されたHourlyForecastエントリー数は、要求された予報期間に一致しており、1、12、24、48、72、または96時間のいずれかです(HourlyDuration合同参照)。

Name 型 説明
forecasts

HourlyForecast[]

時間ごとの予報エントリーは、要求されたウィンドウの1時間ごとに1つずつ、時系列順に記載されています。 各エントリーには、その1時間の予想気温、RealFeel、露点、風、降水量(雨、雪、氷の確率と量)、雲の被覆、視界、紫外線指数、天井、その他の観測データが含まれています。 例えば、 12 の期間は 2019-11-14T16:00:00-08:00 から12件のエントリーを1時間ずつ順に進めていきます。

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

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)

測定値は指定された単位で表されます。

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 です。