Weather - Get Current Conditions

リファレンス

サービス:: Maps

API バージョン:: 1.1

現在の気象条件を取得するために使用します。

Get Current Conditions API は、特定の座標位置の降水量、気温、風などの詳細な現在の気象条件を返す HTTP GET リクエストです。また、特定の場所での過去 6 時間または 24 時間の観測値も取得できます。応答で返される基本情報には、観測日時、気象条件の簡単な説明、気象アイコン、降水量インジケーターフラグ、温度などの詳細が含まれます。 RealFeel™ TemperatureやUVインデックスなどの追加の詳細も返されます。詳細については、「リアルタイムの気象データのリクエスト」を参照してください

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}

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

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&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 海里以内の海域で利用できます。
details	query		string	現在の状況の完全な詳細を返します。使用可能な値は次のとおりです `true` - 完全な詳細を返します。デフォルトでは、すべての詳細が返されます。 `false` - 観測日時、天気フレーズ、アイコンコード、降水量インジケーターフラグ、気温など、現在の状態データの切り捨てられたバージョンを返します。
duration	query		integer	返された気象条件の時間枠。デフォルトでは、最新の気象条件が返されます。既定値は 0 です。サポートされる値は次のとおりです。 `0` - 最新の気象条件を返します。 `6` - 過去6時間の気象条件を返します。 `24` - 過去24時間の気象条件を返します。
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	CurrentConditionsResult	[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 current weather conditions for a given coordinate ___location

要求のサンプル

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

応答のサンプル

状態コード:: 200

{
  "results": [
    {
      "dateTime": "2019-11-14T15:08:00-08:00",
      "phrase": "Cloudy",
      "iconCode": 7,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 13.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 75,
      "dewPoint": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4.9,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 95,
      "ceiling": {
        "value": 4359,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1014.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "pastTwentyFourHourTemperatureDeparture": {
        "value": 1.8,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 16.1,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 13.9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 11.4,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0.5,
          "unit": "mm",
          "unitType": 3
        },
        "past3Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past6Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past9Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past12Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past18Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past24Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "past6Hours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "past12Hours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "past24Hours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

定義

名前	説明
CurrentConditions
CurrentConditionsResult
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
IconCode	`iconPhrase`を表示するイメージを表す数値。詳細については、「 Azure Maps の天気サービス」を参照してください。
JsonFormat	応答の目的の形式。 `json` 形式のみがサポートされています。
PastHoursTemperature	過去数時間にわたる温度変動の概要。
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	表示されているユニットのタイプに関連付けられた数値 ID 値。単位の翻訳に使用できます。詳細については、「 Azure Maps の天気サービス」を参照してください。
WeatherDataUnit	メートル法の単位またはインペリアル単位でデータを返すように指定します。デフォルト値は metric です。
WeatherUnit	天候に関連する特定のユニットの特定の値。
WindDetails	速度と方向を含む風の詳細が返されます。
WindDirection	風向

CurrentConditions

Object

名前	型	説明
apparentTemperature	WeatherUnit	指定された単位での気温、相対湿度、風速の組み合わせによって引き起こされる体感的な屋外温度。
ceiling	WeatherUnit	指定された単位の雲の天井。天井は、最も低い雲の基部の高さの測定値です。
cloudCover	integer (int32)	雲量を表すパーセント。
dateTime	string (date-time)	ISO 8601 形式で表示された現在の観測の日時 (例: 2019-10-27T19:39:57-08:00)。
dewPoint	WeatherUnit	指定された単位での露点温度。露点温度は、飽和状態に達するために空気を冷却する必要がある温度です。
hasPrecipitation	boolean	降水量の有無を示します。 True は降水量の存在を示し、false は降水量がないことを示します。
iconCode	IconCode (int32)	`iconPhrase`を表示するイメージを表す数値。詳細については、「 Azure Maps の天気サービス」を参照してください。
isDayTime	boolean	時刻を示します。 True は '昼'、'、false は '夜' を示します。
obstructionsToVisibility	string	視界が制限される原因。使用可能な値: A = 激しい雷雨/雹 BD = 吹き飛ばす粉塵 BN = 吹く砂 BS=吹雪 D = ダスト F = 霧 GF = 地上の霧 HZ = ヘイズ I = 氷 IC = 氷の結晶 IF = 氷の霧 IP = 氷のペレット IPW = 氷のペレットシャワー K = 煙 L = 霧雨 R = 雨 RS = 雨/雪 RW = レインシャワー S = 雪 SG = 雪顆粒 SP = スノーペレット SW = にわか雪 T = 雷雨 UP = 未定義の降水量 ZL = 凍結霧雨 ZR = 凍えるような雨 + = 重い - =軽い
pastTwentyFourHourTemperatureDeparture	WeatherUnit	指定された単位で24時間前に観測された温度からの出発。
phrase	string	現在の気象条件のフレーズの説明。指定した言語で表示されます。
precipitationSummary	PrecipitationSummary	過去 24 時間の降水量の概要。
pressure	WeatherUnit	指定された単位での大気圧。
pressureTendency	PressureTendency	大気圧の変化。
realFeelTemperature	WeatherUnit	RealFeel™ Temperatureが戻されます。
realFeelTemperatureShade	WeatherUnit	RealFeel™ Temperatureが戻されます。日陰で実際に感じる温度について説明します。
relativeHumidity	integer (int32)	相対湿度は、空気中に存在する水蒸気の量であり、同じ温度で飽和するために必要な量のパーセンテージで表されます。
temperature	WeatherUnit	温度が戻されます。
temperatureSummary	TemperatureSummary	過去 6 時間、12 時間、24 時間の温度変動の概要。
uvIndex	integer (int32)	太陽からの紫外線の強度の測定。サポートされる値は次のとおりです。 `0-2` - 太陽の紫外線や一般の人による危険性が低い。 `3-5` - 保護されていない日光への曝露による危害のリスクは中程度です。 `6-7` - 保護されていない日光への曝露による危害のリスクが高い。 `8-10` - 保護されていない日光への曝露による危害のリスクが非常に高い。 `11+` - 保護されていない日光への曝露による危害の極端なリスク。
uvIndexPhrase	string	`uvIndex`に関連付けられたフレーズ。
visibility	WeatherUnit	指定した単位での可視性。物体や光を明確に識別できる距離の尺度。
wetBulbTemperature	WeatherUnit	空気が飽和するまで一定の圧力で水を蒸発させることにより、空気を冷却できる温度。
wind	WindDetails	速度と方向を含む風の詳細が返されます。
windChillTemperature	WeatherUnit	風による露出した肌の体感温度。
windGust	WindDetails	突風。突風は、風の速度が突然、短時間増加することです。

CurrentConditionsResult

Object

名前	型	説明
results	CurrentConditions[]	詳細な現在の気象条件。

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

PastHoursTemperature

Object

過去数時間にわたる温度変動の概要。

名前	型	説明
maximum	WeatherUnit	最大
minimum	WeatherUnit	最低限

PrecipitationSummary

Object

名前	型	説明
past12Hours	WeatherUnit	過去 12 時間に降った降水量 (液量換算)。
past18Hours	WeatherUnit	過去 18 時間に降水量 (液体換算) の量。
past24Hours	WeatherUnit	過去 24 時間に降水量 (液体換算) の量。
past3Hours	WeatherUnit	過去 3 時間に降水量 (液体換算) の量。
past6Hours	WeatherUnit	過去 6 時間に降った降水量 (液体換算)。メートル法とインペリアル値が含まれます。
past9Hours	WeatherUnit	過去 9 時間に降水量 (液体換算) の量。
pastHour	WeatherUnit	過去 1 時間に降った降水量 (液体換算) の量。

PressureTendency

Object

名前	型	説明
code	string	言語に関係なく圧力傾向コード。 f =下降、s =安定、r =上昇のいずれか。
localizedDescription	string	特定の言語での圧力傾向の説明

TemperatureSummary

Object

名前	型	説明
past12Hours	PastHoursTemperature	過去 12 時間の温度変動の概要。
past24Hours	PastHoursTemperature	過去 24 時間の温度変動の概要。
past6Hours	PastHoursTemperature	過去 6 時間の温度変動の概要。

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)	丸められた値。

WindDetails

Object

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

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

WindDirection

Object

風向

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

次の方法で共有

Weather - Get Current Conditions

URI パラメーター

要求ヘッダー

応答

セキュリティ

AADToken

注記

スコープ

subscription-key

SAS Token

例

Successfully retrieve detailed current weather conditions for a given coordinate ___location

要求のサンプル

応答のサンプル

定義

CurrentConditions

CurrentConditionsResult

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

PastHoursTemperature

PrecipitationSummary

PressureTendency

TemperatureSummary

UnitType

WeatherDataUnit

WeatherUnit

WindDetails

WindDirection