Weather - Get Current Conditions

用於獲取當前天氣狀況。
該 Get Current Conditions API 是一個 HTTP GET 請求,用於返回給定座標位置的詳細當前天氣狀況,例如降水、溫度和風。 此外,也可以擷取特定位置過去 6 或 24 小時的觀察資料。 回應返回的基本資訊包括觀測日期和時間、天氣狀況的簡要描述、天氣圖示、降水指示器標誌和溫度等詳細資訊。 還會返回其他詳細資訊,例如 RealFeel™ Temperature 和 UV index。 有關詳細資訊,請參閱 請求即時天氣數據

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 參數

名稱 位於 必要 類型 Description
endpoint
path True

string (uri)

Azure 地圖服務 服務的主機名稱。 Azure公有雲用 https://atlas.microsoft.com。 若要鎖定特定Azure 地圖服務地理或主權雲,請參見 Azure 地圖服務 地理範圍。

format
path True

JsonFormat

回應所需的格式。 僅支援 json 格式。

api-version
query True

string

minLength: 1

用於此作業的 API 版本。

query
query True

number[]

指定為逗號分隔字串的適用查詢,由緯度所組成,後面接著經度,例如 “47.641268,-122.125679”。

通常,天氣資訊適用於陸地上的位置、被陸地包圍的水體以及距離海岸線約 50 海裡以內的海洋區域。

details
query

string

返回當前條件的完整詳細資訊。 可用值為

  • true - 返回完整詳細資訊。 默認情況下,將返回所有詳細資訊。
  • false - 返回當前條件數據的截斷版本,其中包括觀測日期時間、天氣短語、圖標代碼、降水指示器標誌和溫度。
duration
query

integer (int32)

返回的天氣條件的時間範圍。 默認情況下,將返回最新的天氣狀況。 預設值為 0。 支援的值為:

  • 0 - 返回最新的天氣狀況。
  • 6 - 返回過去 6 小時的天氣狀況。
  • 24 - 返回過去 24 小時的天氣狀況。
language
query

string

應該傳回搜尋結果的語言。 應該是其中一個支援的 IETF 語言標記,不區分大小寫。 當特定欄位無法使用指定語言的數據時,會使用預設語言。

如需詳細資訊,請參閱 支援的語言。

unit
query

WeatherDataUnit

指定以公制單位或英制單位返回數據。 預設值為 metric。

要求標頭

名稱 必要 類型 Description
x-ms-client-id

string

表示該帳號用於 Microsoft Entra ID 安全模型。 這個Azure 地圖服務帳號的唯一 ID 可以從 Azure 地圖服務 管理平面的 Account API 取得。 欲了解更多在Azure 地圖服務中使用Microsoft Entra ID安全,請參見管理 Azure 地圖服務 認證。

回覆

名稱 類型 Description
200 OK

CurrentConditionsResult

要求已成功。

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

AadToken

這些是Microsoft Entra OAuth 2.0流。 當與 Azure 基於角色的存取 控制結合時,可以用來控制對 Azure 地圖服務 REST API 的存取。 Azure 角色基礎存取控制用於指定對一個或多個 Azure 地圖服務 資源帳號或子資源的存取權限。 任何使用者、群組或服務主體都可以透過內建角色或由一或多個 Azure 地圖服務 REST API 許可權所組成的自定義角色來授與存取權。

若要實作案例,建議您檢視 驗證概念。 總而言之,此安全性定義會透過能夠針對特定 API 和範圍進行訪問控制的物件,提供模型化應用程式的解決方案。

Note

  • 此安全性定義 需要 使用 x-ms-client-id 標頭來指出應用程式要求存取的 Azure 地圖服務資源。 這可以從 地圖管理 API取得。
  • Authorization URL 專屬於 Azure 公用雲端實例。 主權雲擁有獨特的授權網址和 Microsoft Entra ID 設定。
  • Azure 角色型訪問控制是從 azure 管理平面 設定, 透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API。
  • Azure 地圖服務 Web SDK 的使用,可讓您針對多個使用案例設定應用程式。
  • 如需Microsoft身分識別平臺的詳細資訊,請參閱 Microsoft 身分識別平臺概觀。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
https://atlas.microsoft.com/.default

subscription-key

這是當您 在 Azure 入口網站或使用 PowerShell、CLI、Azure SDK 或 REST API 建立 Azure 地圖服務帳戶時所佈建的共用密鑰。

使用此金鑰,任何應用程式都可以存取所有 REST API。 換句話說,此金鑰可用來做為帳戶中核發的主要密鑰。

針對公開的應用程式,我們建議使用 機密用戶端應用程式 方法來存取 Azure 地圖服務 REST API,以便安全地儲存您的密鑰。

類型: apiKey
位於: header

SAS Token

這是透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API,從 azure 地圖服務資源 列表 SAS 作業建立共用存取簽章令牌。

使用此令牌時,任何應用程式都有權使用 Azure 角色型訪問控制進行存取,並更精細地控制特定令牌的到期、速率和區域。 換句話說,SAS 令牌可用來讓應用程式以比共用密鑰更安全的方式控制存取。

對於公開的應用程式,我們建議在 對應帳戶資源上設定允許的來源特定清單, 以限制轉譯濫用,並定期更新 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
        }
      }
    }
  ]
}

定義

名稱 Description
CurrentConditions

針對指定地點的單一天氣觀測,透過「取得當前狀況」操作回傳。 根據請求 duration的性質,這個觀察值可能是最新(最新的)讀數,或是之前的每小時觀測之一。 預設會回傳簡化子集:觀測日期與時間、天氣短語、圖示代碼、降水指示器及溫度。 當請求要求提供完整細節時,所有房產都會被納入,並加入如真實感度、露點、風速、能見度、雲層覆蓋、氣壓,以及過去數小時的滾動降水和溫度摘要等測量數據。

CurrentConditionsResult

由「取得當前條件」操作回傳的回應,包含一個或多個指定位置的當前條件觀測值。 預設情況下,會回傳當前時間的單一觀測;當 duration 參數設為 6 或 24 時,回應也會包含該視窗內每小時一筆觀測。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

所有 Azure Resource Manager API 的常見錯誤回應,用於回傳失敗操作的錯誤細節。 (這也遵循 OData 錯誤回應格式。)。

IconCode

數字天氣條件代碼,用來標示要顯示哪個圖示。 此列舉中的每個值對應一個 Azure 地圖服務 天氣圖示(如晴天、陰天或雷雨),並與一個人類可iconPhrase讀的回報一對應。 相同的程式碼可以出現在當前、每小時、每日、季度及每分鐘的回應中,讓應用程式能在所有氣象服務中呈現一致的圖示。

關於完整的代碼清單、它們所對應的圖示以及範例影像,請參見 Azure 地圖服務 中的天氣服務。

JsonFormat

回應所需的格式。 僅支援 json 格式。

PastHoursTemperature

在某一捲起窗 TemperatureSummary 開啟期間(超過6、12或24小時)觀察到的最高與最低空氣溫度,單位為攝氏度(°C)或華氏(華氏度),視請求中指定的單位而定。

PrecipitationSummary

觀測點通過滾動窗戶,於觀測時間結束時所落下的總液體當量降水量。 每個值涵蓋從「現在」開始測量的整個窗戶——例如, past3Hours 是最近三小時的累計,而非僅第三小時——因此窗戶重疊,較長的窗戶包含較短窗戶報告的降水量。 雪和冰則貢獻了它們的融化(液態)等效物。 依請求中指定的單位,以毫米(mm)或英吋(in)為單位報告。

PressureTendency

大氣壓力的最新趨勢——無論是上升、下降還是穩定——以局部語句和單字母代碼的形式回歸。 有助於預測短期天氣變化;氣壓下降常代表天氣惡化,而氣壓上升通常表示條件改善。

TemperatureSummary

該地點在搖動窗戶上觀察到的最高與最低氣溫,結束於觀測時間。 每個值涵蓋從「現在」開始測量的整個視窗——例如,報告 past12Hours 最近12小時的最高與最低溫度,而非僅第12小時——因此視窗重疊,較長視窗則包含較短窗口的溫度報告。 依請求中指定的單位,以攝氏度(°C)或華氏度(°F)報告。

UnitType

與顯示單位類型相關的整數值。 例如,17 表示攝氏度,18 表示華氏度。 可用於單位轉換。 欲了解更多資訊,請參閱氣象服務Azure 地圖服務。

WeatherDataUnit

指定資料回傳為公制或英制單位,預設為公制。 例如:

  • 公制:毫米(mm)、公尺(m)、公里(km)、攝氏(C)
  • 英制:英吋(內)、英尺(ft)、英里(mi)、華氏(F)
WeatherValue

天氣相關指標的數值,如溫度、露點及風速,以公制或英制單位表示,並依單位 URI 參數指定。 欲了解更多資訊,請參閱《Azure 地圖服務 中的天氣服務》一文中的單元類型。

WindDetails

提供預報風速,單位為公里每小時(km/h)或英里每小時(mph),視申請中指定的單位而定。 同時標示以方位角測量的風向,從真北開始順時針移動。 北對應0°,東對應90°,南對應180°,西對應270°。 可能的數值範圍從0°到359°不等。

WindDirection

提供風向細節,包括方位角方向及風向的局部縮寫。

CurrentConditions

針對指定地點的單一天氣觀測,透過「取得當前狀況」操作回傳。 根據請求 duration的性質,這個觀察值可能是最新(最新的)讀數,或是之前的每小時觀測之一。 預設會回傳簡化子集:觀測日期與時間、天氣短語、圖示代碼、降水指示器及溫度。 當請求要求提供完整細節時,所有房產都會被納入,並加入如真實感度、露點、風速、能見度、雲層覆蓋、氣壓,以及過去數小時的滾動降水和溫度摘要等測量數據。

名稱 類型 Description
apparentTemperature

WeatherValue

觀測時間的表觀溫度——也就是人體對空氣的實際感受,考慮了空氣溫度、相對濕度和風速。 以攝氏度(°C)或華氏(°F)為單位測量,視請求中指定的單位而定。

ceiling

WeatherValue

觀測時間的雲頂——即最低雲層離地面高度——以英尺(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

WeatherValue

觀測時的露點——空氣必須冷卻至飽和的溫度(相對濕度100%)。 以攝氏度(°C)或華氏(°F)為單位測量,視請求中指定的單位而定。 較高的露點表示空氣中水分越多。

hasPrecipitation

boolean

true 若觀測時間有降水(雨、雪、冰雹或冰雹);否則 false。

iconCode

IconCode

代表性天氣圖示代碼, phrase 配合該屬性。 該數值對應於 Azure 地圖服務 的天氣圖示——完整列表請參見 Azure 地圖服務 中的天氣服務。 可能是 NULL。

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

WeatherValue

與24小時前相比,空氣溫度的變化,以攝氏度(°C)或華氏(華氏度)為單位,視申請中指定的單位而定。 正值表示空氣同時比昨天更暖;負值表示氣溫較冷。

phrase

string

一個簡短的描述術語,描述觀測時間的天氣狀況——例如晴 天 或 部分多雲。 與 iconCode配對,後者識別對應的天氣圖示。 欲了解更多資訊,請參閱氣象服務Azure 地圖服務。

precipitationSummary

PrecipitationSummary

過去1、3、6、9、12、18及24小時內,觀察點滾動窗內液體當量降水量摘要,單位為毫米(mm)或英吋(in),視請求中指定的單位而定。

pressure

WeatherValue

觀測時間地面的大氣(空氣)壓力,單位為毫巴(mb)或英吋汞柱(inHg),視請求中指定的單位而定。

pressureTendency

PressureTendency

大氣壓力的最新趨勢——上升、下降或穩定。 有助於預測短期天氣變化;氣壓下降常代表天氣惡化,而氣壓上升通常表示條件改善。

realFeelTemperature

WeatherValue

觀測時間的RealFeel™溫度,單位為攝氏度(°C)或華氏(華氏),視請求中指定的單位而定。 由AccuWeather開發的RealFeel結合了空氣溫度、濕度、風、雲層、陽光強度及其他因素,來反映天氣的真實感受。 欲了解更多資訊,請參閱 《AccuWeather RealFeel 溫度是什麼?》

realFeelTemperatureShade

WeatherValue

在遮蔭區域觀察時間的真實感覺™溫度,單位為攝氏度(°C)或華氏度(華氏),視請求中指定的單位而定。 像 realFeelTemperature,但排除了直射陽光的暖化效應,能更準確地感受到陰影下的天氣感覺。

relativeHumidity

integer (int32)

觀測時間的相對濕度,以空氣在相同溫度下可容納最大水蒸氣量的0到100百分比表示。

temperature

WeatherValue

觀測時間的空氣溫度,以攝氏度(°C)或華氏(華氏)為單位,視請求中指定的單位而定。

temperatureSummary

TemperatureSummary

過去6、12及24小時內,該地點在搖窗期間觀察到的最高與最低氣溫摘要,依請求中指定的單位,以攝氏度(°C)或華氏度(華氏)為單位。

uvIndex

integer (int32)

觀測時的紫外線(UV)指數,顯示未防護日曬造成的傷害風險。 支援的值為:

  • 0-2:對一般人來說,太陽紫外線的危險性低。
  • 3-5:中度風險為未防護日曬造成的傷害。
  • 6-7:未防護的陽光曝曬帶來的高傷害風險。
  • 8-10:未防護的陽光曝曬造成極高風險。
  • 11+:未防護日曬帶來的極大傷害風險。
uvIndexPhrase

string

一個簡短的描述標籤,例如uvIndex:低、中、高、非常高或極端。

visibility

WeatherValue

觀測時間的水平能見度——即物體或光線可清楚辨識的距離——以公里(km)或英里(mi)為單位,視請求中指定的單位而定。

wetBulbTemperature

WeatherValue

觀測時的濕球溫度——若空氣在恆壓下蒸發水分,冷卻至飽和(相對濕度100%)時,空氣會達到的溫度。 以攝氏度(°C)或華氏(°F)為單位測量,視請求中指定的單位而定。 對評估熱應力與蒸發冷卻非常有用。

wind

WindDetails

觀測時間的風速與風向。 速度以公里每小時(km/h)或英里每小時(mph)為單位,視請求中指定的單位而定;方向為方位角,從真北順時針測量(0° = N,90° = 東,180° = 南,270° = 西)。

windChillTemperature

WeatherValue

觀測時的風寒溫度——指風與低溫綜合作用,空氣在裸露皮膚上感受到的寒冷。 通常比實際空氣溫度還低。 以攝氏度(°C)或華氏(°F)為單位測量,視請求中指定的單位而定。

windGust

WindDetails

觀測時間下,使用相同的單位與方位約定 wind,最大短突風速與陣風方向。 陣風是風速短暫的突升,可能影響航空、帆船、放風箏及其他戶外活動。

CurrentConditionsResult

由「取得當前條件」操作回傳的回應,包含一個或多個指定位置的當前條件觀測值。 預設情況下,會回傳當前時間的單一觀測;當 duration 參數設為 6 或 24 時,回應也會包含該視窗內每小時一筆觀測。

名稱 類型 Description
results

CurrentConditions[]

目前的觀測數據,依時間順序排列,從最近的開始。 預設只有一條記錄——最新的觀察

  • 回傳;回應也可能在最近的滾動視窗(通常為過去6或24小時)每小時包含一條條目,視請求而定。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳情

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

所有 Azure Resource Manager API 的常見錯誤回應,用於回傳失敗操作的錯誤細節。 (這也遵循 OData 錯誤回應格式。)。

名稱 類型 Description
error

ErrorDetail

error 物件。

IconCode

數字天氣條件代碼,用來標示要顯示哪個圖示。 此列舉中的每個值對應一個 Azure 地圖服務 天氣圖示(如晴天、陰天或雷雨),並與一個人類可iconPhrase讀的回報一對應。 相同的程式碼可以出現在當前、每小時、每日、季度及每分鐘的回應中,讓應用程式能在所有氣象服務中呈現一致的圖示。

關於完整的代碼清單、它們所對應的圖示以及範例影像,請參見 Azure 地圖服務 中的天氣服務。

值 Description
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

Ice

25

Sleet

26

凍雨

29

雨天降雪

30

Hot

31

Cold

32

Windy

33

晴

34

大部晴朗

35

局部多雲

36

間歇雲量

37

朦朧月光

38

多雲

39

時陰陣雨

40

多雲陣雨

41

部分多雲伴有雷暴

42

多雲雷暴

43

大部分多雲,伴隨零星小雪

44

多雲降雪

JsonFormat

回應所需的格式。 僅支援 json 格式。

值 Description
json

JavaScript 物件表示法數據交換格式

PastHoursTemperature

在某一捲起窗 TemperatureSummary 開啟期間(超過6、12或24小時)觀察到的最高與最低空氣溫度,單位為攝氏度(°C)或華氏(華氏度),視請求中指定的單位而定。

名稱 類型 Description
maximum

WeatherValue

這是該窗口期間觀察到的最高溫度。

minimum

WeatherValue

這是該時間窗內觀察到的最低溫度。

PrecipitationSummary

觀測點通過滾動窗戶,於觀測時間結束時所落下的總液體當量降水量。 每個值涵蓋從「現在」開始測量的整個窗戶——例如, past3Hours 是最近三小時的累計,而非僅第三小時——因此窗戶重疊,較長的窗戶包含較短窗戶報告的降水量。 雪和冰則貢獻了它們的融化(液態)等效物。 依請求中指定的單位,以毫米(mm)或英吋(in)為單位報告。

名稱 類型 Description
past12Hours

WeatherValue

過去12小時內降落的液體當量降水量。

past18Hours

WeatherValue

過去18小時內降落的液體當量降水量。

past24Hours

WeatherValue

過去24小時內降落的液體當量降水量。

past3Hours

WeatherValue

過去三小時內降落的液體當量降水量。

past6Hours

WeatherValue

過去6小時內降落的液體當量降水量。

past9Hours

WeatherValue

過去9小時內降落的液體當量降水量。

pastHour

WeatherValue

過去一小時內降水量為液體當量。

PressureTendency

大氣壓力的最新趨勢——無論是上升、下降還是穩定——以局部語句和單字母代碼的形式回歸。 有助於預測短期天氣變化;氣壓下降常代表天氣惡化,而氣壓上升通常表示條件改善。

名稱 類型 Description
code

string

一個語言無關的單字母壓力趨勢代碼: F = 下降, S = 穩定, R = 上升。

localizedDescription

string

一段描述壓力傾向的短語——例如下降、穩定或上升——會以請求中指定的語言回傳。

TemperatureSummary

該地點在搖動窗戶上觀察到的最高與最低氣溫,結束於觀測時間。 每個值涵蓋從「現在」開始測量的整個視窗——例如,報告 past12Hours 最近12小時的最高與最低溫度,而非僅第12小時——因此視窗重疊,較長視窗則包含較短窗口的溫度報告。 依請求中指定的單位,以攝氏度(°C)或華氏度(°F)報告。

名稱 類型 Description
past12Hours

PastHoursTemperature

過去12小時觀察到的最高與最低氣溫。

past24Hours

PastHoursTemperature

過去24小時觀察到的最高與最低氣溫。

past6Hours

PastHoursTemperature

過去6小時內觀察到的最高與最低氣溫。

UnitType

與顯示單位類型相關的整數值。 例如,17 表示攝氏度,18 表示華氏度。 可用於單位轉換。 欲了解更多資訊,請參閱氣象服務Azure 地圖服務。

值 Description
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)
  • 英制:英吋(內)、英尺(ft)、英里(mi)、華氏(F)
值 Description
imperial

回傳資料時使用英制單位,例如溫度用華氏(F)表示溫度,距離用英里(mi)表示。

metric

使用公制單位返回數據,例如攝氏度 (C) 表示溫度,公里 (km) 表示距離。

WeatherValue

天氣相關指標的數值,如溫度、露點及風速,以公制或英制單位表示,並依單位 URI 參數指定。 欲了解更多資訊,請參閱《Azure 地圖服務 中的天氣服務》一文中的單元類型。

名稱 類型 Description
unit

string

回傳值中使用的計量單位,例如「C」代表攝氏,「F」代表華氏。

unitType

UnitType

一個整數代表單位的類型。 例如,0代表英尺,1代表英吋,2代表英里。 完整列表請參閱《Azure 地圖服務 中的氣象服務》一文中的單元類型。

value

number (float)

以指定單位表示的測量值。

WindDetails

提供預報風速,單位為公里每小時(km/h)或英里每小時(mph),視申請中指定的單位而定。 同時標示以方位角測量的風向,從真北開始順時針移動。 北對應0°,東對應90°,南對應180°,西對應270°。 可能的數值範圍從0°到359°不等。

名稱 類型 Description
direction

WindDirection

風向以方位角為單位測量,從真北(0°)開始順時針移動。 東對應90°,南對應180°,西對應270°。 可能的數值範圍從0°到359°不等。 此性質回傳一個整數,代表風向。

speed

WeatherValue

預期風速,以公里每小時(km/h)或英里每小時(mph)為單位,依請求中指定的單位而定。

WindDirection

提供風向細節,包括方位角方向及風向的局部縮寫。

名稱 類型 Description
degrees

integer (int32)

風向以方位角為單位,從真北開始順時針移動。 北緯對應0度,東角為90度,南緯180度,西經270度。 可能的數值範圍從0到359度不等。

localizedDescription

string

風向的局部縮寫,並以請求中指定的語言回傳。 例如, N 北方、 E 東方、 S 南方和 W 西方。