次の方法で共有


Weather - Get Daily Historical Normals

特定の場所の過去の毎日の平均気温、降水量、冷却/暖房度の日情報などの気候データを取得するには、 を使用します。

Get Daily Historical Normalsこの API は、特定の座標位置でのその日の過去の毎日の正常温度、降水量、冷却/加熱度の日情報などの気候データを返す HTTP GET 要求です。 過去の法線は、特定の場所の気温と降水量の 30 年の平均です。 気候学の標準的なプラクティスと同様に、30 年の平均は 1991 年から 2020 年をカバーし、このデータは 10 年間使用され、2030 年にリセットされます。 一般に、履歴データは、場所に応じて、過去 5 年から 40 年以上前まで利用できる場合があります。

GET https://atlas.microsoft.com/weather/historical/normals/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}
GET https://atlas.microsoft.com/weather/historical/normals/daily/json?api-version=1.1&query={query}&startDate={startDate}&endDate={endDate}&unit={unit}

URI パラメーター

名前 / 必須 説明
format
path True

JsonFormat

応答の目的の形式。 サポートされているのは json 形式のみです。

api-version
query True

string

Azure Maps API のバージョン番号。

endDate
query True

string

date

ISO 8601 形式の終了日 (2019-10-28 など)。 サポートされる日付範囲は 1 から 31 カレンダー日であるため、startDate と endDate を指定してください。これは、最大 31 日を超えないようにしてください (つまり、startDate=2012-01-01&endDate=2012-01-31)。

query
query True

number[]

緯度の後に経度 (例: "47.641268,-122.125679" など) で構成されるコンマ区切り文字列として指定された該当するクエリ。

startDate
query True

string

date

ISO 8601 形式の開始日 (2019-10-27 など)。 サポートされる日付範囲は 1 から 31 カレンダー日であるため、startDate と endDate を指定してください。これは、最大 31 日を超えないようにしてください (つまり、startDate=2012-01-01&endDate=2012-01-31)。

unit
query

WeatherDataUnit

メトリック単位またはインペリアル単位のいずれかでデータを返すように指定します。 既定値はメトリックです。

要求ヘッダー

名前 必須 説明
x-ms-client-id

string

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

応答

名前 説明
200 OK

DailyHistoricalNormalsResult

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 を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。

型: 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 リソース の SAS の一覧表示操作から作成される共有アクセス署名トークンです。

このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンをきめ細かく制御できます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。

公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定の一覧を構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。

型: apiKey
/: header

Successful Daily Historical Normals Request

要求のサンプル

GET https://atlas.microsoft.com/weather/historical/normals/daily/json?api-version=1.1&query=39.952583,-75.165222&startDate=2012-01-20&endDate=2012-01-22

応答のサンプル

{
  "results": [
    {
      "date": "2012-01-20T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 4.4,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -3.7,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": 0.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 18,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 2.5,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2012-01-21T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 4.5,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -3.7,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": 0.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 18,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 2.5,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2012-01-22T00:00:00-04:00",
      "temperature": {
        "maximum": {
          "value": 4.5,
          "unit": "C",
          "unitType": 17
        },
        "minimum": {
          "value": -3.7,
          "unit": "C",
          "unitType": 17
        },
        "average": {
          "value": 0.4,
          "unit": "C",
          "unitType": 17
        }
      },
      "degreeDaySummary": {
        "heating": {
          "value": 18,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "precipitation": {
        "value": 2.3,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

定義

名前 説明
DailyHistoricalNormals
DailyHistoricalNormalsResult
DegreeDaySummary
ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

JsonFormat

応答の目的の形式。 サポートされているのは json 形式のみです。

UnitType

表示される単位の種類に関連付けられている数値 ID 値。 単位変換に使用できます。 詳細については、「 Azure Maps の Weather サービス 」を参照してください。

WeatherDataUnit

メトリック単位またはインペリアル単位のいずれかでデータを返すように指定します。 既定値はメトリックです。

WeatherUnit

天気に関連する特定の単位の特定の値。

WeatherUnitMaxMinAvg

返される温度値。

DailyHistoricalNormals

名前 説明
date

string

ISO 8601 形式で表示されている現在の観測値の日付と時刻 (例: 2019-10-27T19:39:57-08:00)。

degreeDaySummary

DegreeDaySummary

加熱または冷却度の日情報の概要

precipitation

WeatherUnit

落下した沈殿量(液体換算)

temperature

WeatherUnitMaxMinAvg

温度の値。

DailyHistoricalNormalsResult

名前 説明
nextLink

string

は、返される機能の次のページへのリンクです。 最後のページの場合は、このフィールドはありません。

results

DailyHistoricalNormals[]

要求された各日の履歴法線。

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 オブジェクト。

JsonFormat

応答の目的の形式。 サポートされているのは json 形式のみです。

名前 説明
json

string

JavaScript オブジェクト表記データ交換形式

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

丸められた値。

WeatherUnitMaxMinAvg

返される温度値。

名前 説明
average

WeatherUnit

期間の平均温度。

maximum

WeatherUnit

期間の最大温度。

minimum

WeatherUnit

期間の最小温度。