Weather - Get Current Conditions
現在の気象条件を取得するために使用します。
Get Current Conditions API は、特定の座標位置の降水量、気温、風などの詳細な現在の気象条件を返す HTTP GET リクエストです。 また、特定の場所での過去 6 時間または 24 時間の観測値も取得できます。 応答で返される基本情報には、観測日時、気象条件の簡単な説明、気象アイコン、降水量インジケーター フラグ、温度などの詳細が含まれます。 RealFeel™ TemperatureやUVインデックスなどの追加の詳細も返されます。 詳細については、「リアルタイムの気象データのリクエスト」を参照してください
GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}
GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}
URI パラメーター
| Name | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Azure Mapsサービスのホストネーム。 Azureパブリッククラウドには |
|
format
|
path | True |
応答の目的の形式。
|
|
|
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
|
query
|
query | True |
number[] |
緯度の後に経度 (例: "47.641268,-122.125679") で構成されるコンマ区切り文字列として指定された該当するクエリ。 気象情報は、通常、陸上の場所、陸地に囲まれた水域、および海岸線から約 50 海里以内の海域で利用できます。 |
|
details
|
query |
string |
現在の状況の完全な詳細を返します。 使用可能な値は次のとおりです
|
|
|
duration
|
query |
integer (int32) |
返された気象条件の時間枠。 デフォルトでは、最新の気象条件が返されます。 既定値は 0 です。 サポートされる値は次のとおりです。
|
|
|
language
|
query |
string |
検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。 詳細については、サポートされている言語の を参照してください。 |
|
|
unit
|
query |
メートル法の単位またはインペリアル単位でデータを返すように指定します。 デフォルト値は metric です。 |
要求ヘッダー
| Name | 必須 | 型 | 説明 |
|---|---|---|---|
| x-ms-client-id |
string |
Microsoft Entra IDセキュリティモデルで使用されることを意図したアカウントを示します。 このAzure Mapsアカウントの一意IDは、Azure Maps管理プレーンのアカウントAPIから取得できます。
Azure MapsにおけるMicrosoft Entra IDセキュリティの使用についての詳細は、Azure Maps |
応答
| Name | 型 | 説明 |
|---|---|---|
| 200 OK |
要求は成功しました。 |
|
| Other Status Codes |
予期しないエラー応答。 |
セキュリティ
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 current weather conditions for a given coordinate location
要求のサンプル
GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679
応答のサンプル
{
"results": [
{
"apparentTemperature": {
"unit": "C",
"unitType": 17,
"value": 16.1
},
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4359
},
"cloudCover": 95,
"dateTime": "2019-11-14T15:08:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 9.2
},
"hasPrecipitation": false,
"iconCode": 7,
"isDayTime": true,
"obstructionsToVisibility": "",
"pastTwentyFourHourTemperatureDeparture": {
"unit": "C",
"unitType": 17,
"value": 1.8
},
"phrase": "Cloudy",
"precipitationSummary": {
"past12Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past18Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past24Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past3Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past6Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past9Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"pastHour": {
"unit": "mm",
"unitType": 3,
"value": 0.5
}
},
"pressure": {
"unit": "mb",
"unitType": 14,
"value": 1014.9
},
"pressureTendency": {
"code": "S",
"localizedDescription": "Steady"
},
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 13.6
},
"realFeelTemperatureShade": {
"unit": "C",
"unitType": 17,
"value": 13.6
},
"relativeHumidity": 75,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 13.7
},
"temperatureSummary": {
"past12Hours": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 13.7
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": 5.9
}
},
"past24Hours": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 13.7
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": 5.9
}
},
"past6Hours": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 13.7
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": 8.3
}
}
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 8
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 11.4
},
"wind": {
"direction": {
"degrees": 315,
"localizedDescription": "NW"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 3.6
}
},
"windChillTemperature": {
"unit": "C",
"unitType": 17,
"value": 13.9
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 4.9
}
}
}
]
}
定義
| Name | 説明 |
|---|---|
|
Current |
指定された場所の単一の気象観測で、現在の条件取得操作で返されます。 リクエストの |
|
Current |
「Get Current Conditions」操作によって返される応答で、指定された位置の1つ以上の現在の条件観測値が含まれています。 デフォルトでは現在の時刻に対する単一の観測が返されます。 |
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。 |
|
Icon |
どのアイコンを表示するかを示す数値の天候コードです。
この列挙の各値は、晴れ、雲、雷雨などのAzure Maps天気アイコンに対応し、人間が読み取れる返 コードの完全なリスト、それらがマッピングするアイコン、例の画像については、Azure Mapsの気象サービスをご覧ください。 |
|
Json |
応答の目的の形式。
|
|
Past |
|
|
Precipitation |
観測地点で落とされた液体換算の総降水量を、観測時刻で終了するロールウィンドウを経てのことです。
各値は「現在」から遡って測定した窓全体をカバーします。例えば、 |
|
Pressure |
最近の大気圧の傾向――気圧が上昇、下降、または安定しているか――は局所的なフレーズとして、また一文字のコードとして戻ってきました。 短期的な天候変化を予測するのに役立ちます。気圧が下がると天候悪化を示すことが多いですが、気圧が上昇すると状況が改善することを示します。 |
|
Temperature |
観察時間で観測された最高および最低気温は、窓を閉めて観測時間で終わる。 各値は「現在」から遡って測定した全ウィンドウをカバーします。例えば、 |
|
Unit |
表示されるユニットの種類に関連する整数値。
たとえば、摂氏の場合は 17、華氏の場合は 18 です。 単位の翻訳に使用できます。 詳細については、Azure Maps<>>の |
|
Weather |
メートル法か数数単位かを表示し、デフォルトはメートル法を指定します。 例えば次が挙げられます。
|
|
Weather |
気温、露点、風速などの気象関連指標の値は、単位URIパラメータで指定されたメートル法またはインペリアル単位で示されます。 詳細は「Azure Mapsの気象サービス」の「ユニットタイプ」をご覧ください。 |
|
Wind |
請求で指定された単位に応じて、キロメートル毎時(km/h)やマイル毎時(mph)などの単位で測られる予報風速を提供します。 また、真北から時計回りに進む方位角で測る風向きも示します。 北は0°、東は90°、南は180°、西は270°に対応します。 可能な値は0°から359°の範囲です。 |
|
Wind |
方位角での風向きや風向きの局所的な略称を含む風向きの詳細を提供します。 |
CurrentConditions
指定された場所の単一の気象観測で、現在の条件取得操作で返されます。 リクエストの durationによっては、この観測値は最新の(最も最近の)読み取り値か、直前の1時間ごとの観測のいずれかである場合があります。 デフォルトでは、観測日時、天候フレーズ、アイコンコード、降水量指示器、気温などの簡略化されたサブセットが返されます。 詳細を求める場合は、すべての物件が記載され、RealFeel、露点、風、視界、雲量、気圧、過去数時間の降水量や気温の合計などの測定値が記載されます。
| Name | 型 | 説明 |
|---|---|---|
| apparentTemperature |
観測時刻の見かけ温度、つまり空気が人間に実際にどのように感じられるか、空気温度、相対湿度、風速を考慮したものです。 請求で指定された単位に応じて、摂氏(°C)または華氏(°F)で測定されます。 |
|
| ceiling |
観測時刻の雲底、すなわち最も低い雲層の地上からの高さは、要求で指定された単位によってフィート(ft)またはメートル(m)で表されます。 航空にとって重要な点で、飛行の視認性や運用に影響を与えるからです。 |
|
| cloudCover |
integer (int32) |
観測時刻における空の雲に覆われている割合で、0(晴れ)から100(曇り)までです。 NULL である可能性があります。 |
| dateTime |
string (date-time) |
この観察の日付と時刻は RFC 3339 形式(yyyy-mm-ddThh:mm:ss-hh:mm)で示します。 例えば、 2025-04-29T07:00:00-07:00です。 |
| dewPoint |
観測時刻の露点 - 空気が飽和に達するために冷えなければならない温度(相対湿度の100%)。 請求で指定された単位に応じて、摂氏(°C)または華氏(°F)で測定されます。 露点が高いほど空気中の水分が増えています。 |
|
| hasPrecipitation |
boolean |
|
| iconCode |
この観測の代表的な天気アイコンコードと、 |
|
| isDayTime |
boolean |
|
| obstructionsToVisibility |
string |
霧、煙、霞、降水など、観測時に視界を低下させる支配的な要因を特定するコード。 運転や航空など、視界がはっきりと必要になる活動に適しています。 使用可能な値:
|
| pastTwentyFourHourTemperatureDeparture |
24時間前と比較した気温の変化で、請求で指定された単位に応じて摂氏(°C)または華氏(°F)で示されます。 正の値は同時に昨日より暖かい空気を示します。負の値は冷たくなったことを示します。 |
|
| phrase |
string |
観測時刻の天候条件を表す短い説明用語で、例えば晴 れ や 部分的に曇りです。
|
| precipitationSummary |
過去1、3、6、9、12、18、24時間のロールウィンドウによる観察地点での液体換算降水量の要約で、要求で指定された単位に応じてミリメートル(mm)またはインチ(in)で示します。 |
|
| pressure |
観測時刻の地上の大気(空気)圧力は、要求で指定された単位によってミリバール(mb)またはインチ(inHg)で示されます。 |
|
| pressureTendency |
最近の大気圧の傾向は、上昇、下降、または安定している。 短期的な天候変化を予測するのに役立ちます。気圧が下がると天候悪化を示すことが多いですが、気圧が上昇すると状況が改善することを示します。 |
|
| realFeelTemperature |
観測時刻のRealFeel™温度は、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で示されます。 AccuWeatherによって開発されたRealFeelは、気温と湿度、風、雲の被覆、日照強度などの要素を組み合わせて、実際の天気の感覚を示します。 詳細については 、「AccuWeather RealFeelの温度とは何か?」をご覧ください。 |
|
| realFeelTemperatureShade |
観察時間の日陰地域でのRealFeel™温度は、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で示されます。
|
|
| relativeHumidity |
integer (int32) |
観測時刻の相対湿度は、同じ温度で空気が保持できる最大水蒸気量の0から100のパーセンテージで表されます。 |
| temperature |
観測時刻の気温は、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で示されます。 |
|
| temperatureSummary |
過去6時間、12日、24時間のこの場所で観測された最高・最低気温の要約で、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で示されています。 |
|
| uvIndex |
integer (int32) |
観測時の紫外線(UV)指数は、無防備な日光曝露による害のリスクを示しています。 サポートされる値は次のとおりです。
|
| uvIndexPhrase |
string |
|
| visibility |
観測時刻における水平可視性、すなわち物体や光が明確に識別できる距離(請求で指定された単位によってキロメートル(km)またはマイル(mi)で示されます。 |
|
| wetBulbTemperature |
観測時刻の湿球温度 - 一定圧力で空気を蒸発させて飽和(相対湿度100%)まで冷却した場合の温度です。 請求で指定された単位に応じて、摂氏(°C)または華氏(°F)で測定されます。 熱ストレスや蒸発冷却の評価に有用です。 |
|
| wind |
観測時刻の風速と風向き。 速度は請求で指定された単位により、キロメートル毎時(km/h)またはマイル毎時(mph)で表されます。方向は真北から時計回りに測定した方位角(0°=N、90°=E、180°=南、270°=W)です。 |
|
| windChillTemperature |
観測時の体冷え温度 - 風と低温の影響で露出した肌に空気がどれだけ冷たく感じるか。 通常は実際の気温よりも低いです。 請求で指定された単位に応じて、摂氏(°C)または華氏(°F)で測定されます。 |
|
| windGust |
観測時刻における最大短時間突風速度と方向を、 |
CurrentConditionsResult
「Get Current Conditions」操作によって返される応答で、指定された位置の1つ以上の現在の条件観測値が含まれています。 デフォルトでは現在の時刻に対する単一の観測が返されます。 duration パラメータが6または24に設定されている場合、応答には過去1時間あたり1回の観測も含まれます。
| Name | 型 | 説明 |
|---|---|---|
| results |
現在の状況に関する観測は、最新のものから先に並んで時系列順に示します。 デフォルトでは単一のエントリー、つまり最新の観察
|
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| Name | 型 | 説明 |
|---|---|---|
| info |
追加情報。 |
|
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| Name | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。
| Name | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
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 オブジェクト表記データ交換形式 を する |
PastHoursTemperature
TemperatureSummaryのロールウィンドウのいずれかで観測される最高および最低気温(6時間、12時間、または24時間以降)は、要求で指定された単位に応じて摂氏(°C)または華氏(°F)で示されます。
| Name | 型 | 説明 |
|---|---|---|
| maximum |
この期間中に観測された最高気温。 |
|
| minimum |
この期間中に観測された最低気温です。 |
PrecipitationSummary
観測地点で落とされた液体換算の総降水量を、観測時刻で終了するロールウィンドウを経てのことです。
各値は「現在」から遡って測定した窓全体をカバーします。例えば、 past3Hours は直近3時間の連続合計であり、3時間目だけでなく、ウィンドウが重なり、長いウィンドウには短いウィンドウの降水量も含まれます。 雪や氷も溶けた(液体の)分の成分を寄与します。 請求で指定された単位に応じてミリメートル(mm)またはインチ(in)で報告されます。
| Name | 型 | 説明 |
|---|---|---|
| past12Hours |
過去12時間で降った液体換算降水量。 |
|
| past18Hours |
過去18時間で降った液体換算降水量。 |
|
| past24Hours |
過去24時間で降った液体換算降水量。 |
|
| past3Hours |
過去3時間で降った液体換算降水量。 |
|
| past6Hours |
過去6時間で降った液体換算降水量。 |
|
| past9Hours |
過去9時間で降った液体換算降水量。 |
|
| pastHour |
過去1時間で降った液体換算降水量。 |
PressureTendency
最近の大気圧の傾向――気圧が上昇、下降、または安定しているか――は局所的なフレーズとして、また一文字のコードとして戻ってきました。 短期的な天候変化を予測するのに役立ちます。気圧が下がると天候悪化を示すことが多いですが、気圧が上昇すると状況が改善することを示します。
| Name | 型 | 説明 |
|---|---|---|
| code |
string |
圧力傾向を表す言語に依存しない1文字コード: F = 落下、 S = 安定、 R = 上昇。 |
| localizedDescription |
string |
圧力傾向を表す短いフレーズ(例えば、 下降、 安定、 上昇 )が、リクエストで指定された言語で返されました。 |
TemperatureSummary
観察時間で観測された最高および最低気温は、窓を閉めて観測時間で終わる。 各値は「現在」から遡って測定した全ウィンドウをカバーします。例えば、 past12Hours は直近12時間の最高・最低値を報告しており、12時間目だけでなく、ウィンドウが重複し、長いウィンドウには短いウィンドウの温度も含まれます。 請求で指定された単位に応じて、摂氏(°C)または華氏(°F)で報告されます。
| Name | 型 | 説明 |
|---|---|---|
| past12Hours |
過去12時間で観測された最高気温と最低気温。 |
|
| past24Hours |
過去24時間で観測された最高気温と最低気温。 |
|
| past6Hours |
過去6時間で観測された最高気温と最低気温。 |
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
気温、露点、風速などの気象関連指標の値は、単位URIパラメータで指定されたメートル法またはインペリアル単位で示されます。 詳細は「Azure Mapsの気象サービス」の「ユニットタイプ」をご覧ください。
| Name | 型 | 説明 |
|---|---|---|
| unit |
string |
返還値に使われる単位、例えば「C」はCelsius、「F」は華氏(F)です。 |
| unitType |
単位の種類を表す整数です。 例えば、0はフィート、1はインチ、2はマイルです。 完全なリストについては、「Azure MapsのWeather services」記事のユニットタイプをご覧ください。 |
|
| value |
number (float) |
測定値は指定された単位で表されます。 |
WindDetails
請求で指定された単位に応じて、キロメートル毎時(km/h)やマイル毎時(mph)などの単位で測られる予報風速を提供します。 また、真北から時計回りに進む方位角で測る風向きも示します。 北は0°、東は90°、南は180°、西は270°に対応します。 可能な値は0°から359°の範囲です。
| Name | 型 | 説明 |
|---|---|---|
| direction |
風向きは真北(0°)から時計回りに進む方位角で測定されます。 東は90°、南は180°、西は270°に対応します。 可能な値は0°から359°の範囲です。 この性質は風向きを表す整数を返します。 |
|
| speed |
期待風速は、請求で指定された単位によってキロメートル毎時(km/h)またはマイル毎時(mph)で測定されます。 |
WindDirection
方位角での風向きや風向きの局所的な略称を含む風向きの詳細を提供します。
| Name | 型 | 説明 |
|---|---|---|
| degrees |
integer (int32) |
風向きは真北から時計回りに進む方位角で測定されます。 北は0度、東は90度、南は180度、西は270度に対応します。 可能な値は0度から359度までの範囲です。 |
| localizedDescription |
string |
風向きの局所的な略称で、リクエストで指定された言語で返されます。 例えば、北は |