Appearance

逐小时预报API开发指南 ​

基本信息 ​

  • 华风爱科 API提供给用户一个简洁的RESTful Web接口，用以访问基于位置的天气数据。
  • 逐小时预报搜索需location key配合。请使用定位API调取您所需要搜索的地点location key。
  • 逐小时预报可调取小时数为1小时，12小时，24小时（~一天），72小时（~3天）。更多逐小时预报请联系商务。
  • 逐小时预报支持中英文语言。如需要更多语言与本地化方言请联系商务。
  • 逐小时预报响应可返回公制与英制单位。默认返回英制单位，公制单位可在URL中添加metric=true以请求返回。
  • API默认返回简短版逐小时预报数据，信息包括：headline：数据有效期，Epoch数据有效期，严重程度，与文字。逐日报告信息：日期，Epoch日期，气温。白天：图标，图标文字，夜晚：图标，图标文字，mobile link与link。URL中添加details=true以请求详细版数据。

API服务地址 ​

请求URL ​
类型URL请求方式
使用LocationKey调取1小时预报https://openapi.weathercn.com/forecasts/{version}/hourly/1hour/{locationKey}{.{format}}?apikey=<用户的key>{&language={language code}}{&details={true or false}}{&metric={true or false}}GET
使用LocationKey调取12小时预报https://openapi.weathercn.com/forecasts/{version}/hourly/12hour/{locationKey}{.{format}}?apikey=<用户的key>{&language={language code}}{&details={true or false}}{&metric={true or false}}GET
使用LocationKey调取24小时预报https://openapi.weathercn.com/forecasts/{version}/hourly/24hour/{locationKey}{.{format}}?apikey=<用户的key>{&language={language code}}{&details={true or false}}{&metric={true or false}}GET
使用LocationKey调取72小时预报https://openapi.weathercn.com/forecasts/{version}/hourly/72hour/{locationKey}{.{format}}?apikey=<用户的key>{&language={language code}}{&details={true or false}}{&metric={true or false}}GET
请求参数 ​
参数说明默认值
apikey用以在API里验证与授权使用的用户密钥N/A必选
version当前API版本v1必选
locationkey用以搜索指定地点的特定IDN/A必选
format响应格式JSON可选
language指定响应数据语言的字符串zh-cn可选
details用以判断是否返回简短版或完整版数据的布尔值（true 或 false），完整版 (details = true)False可选
metric用以判断是否返回公制或英制版版数据的布尔值（true 或 false），公制版 ( = true)False可选
返回参数 ​
参数说明
DateTime当前预报日期与时间， ISO8601 格式: yyyy-mm-ddThh:mm:ss±hh:mm
EpochDateTime当前预报的UNIX时间，从协调世界时1970年1月1日0时0分0秒起至现在的总秒数，不考虑闰秒 (午夜 UTC/GMT)
WeatherIcon天气预报图标ID
IconPhrase图标说明
HasPrecipitation表示存在任何类型降水的布尔值。如果存在降水，则显示为真。（true or false）
IsDaylight白天判断值（true or false）
Temperature气温
Value气温取整数
Unit气温数值的单位类型
UnitType用于单位转换使用的ID
LocalSource针对特定数据的当地的数据源信息。如当地数据源信息缺失，该参数则不显示。
Id当地数据供应商ID值
Name当地数据供应商名称。在支持的情况下供应商名字将以请求的语言显示。否则名称将以英文或者该名称的本地语言显示。
WeatherCode本地数据供应商所提供的天气代码，需匹配WeatherCode编码表。
WindLevelCode本地数据供应商所提供的风力等级，需匹配WindLevelCode编码表。
WindDirectionCode本地数据供应商所提供的风向代码，需匹配WindDirectionCode编码表。
RealFeelTemperature™AccuWeather RealFeel™ Temperature 温度（专利）
ValueAccuWeather RealFeel™ Temperature 温度（专利）的气温取整数
UnitRealFeel™数值的单位类型
UnitType用于单位转换使用的ID
RealFeelTemperatureShade™AccuWeather RealFeel™ Temperature in shade
ValueRealFeelTemperatureShade™温度（专利）的气温取整数
UnitRealFeel™数值的单位类型
UnitType用于单位转换使用的ID
WetBulbTemperature湿球温度
Value湿球温度取整数
Unit湿球温度数值的单位类型
UnitType用于单位转换使用的ID
DewPoint露点温度
Value露点温度取整数
Unit露点温度数值的单位类型
UnitType用于单位转换使用的ID
Wind风
Speed风速
Value风速取整数
Unit风速数值的单位类型
UnitType用于单位转换使用的ID
Direction风向
Degrees风向的方位角度(例：180°则是南风)
Localized特定语言的风向缩写
English风向英文缩写
WindGust阵风
Speed风速
阵风风速取整数
阵风风速数值的单位类型
用于单位转换使用的ID
RelativeHumidity相对湿度
IndoorRelativeHumidity室内相对湿度
Visibility能见度
Value能见度取整数
Unit能见度数值的单位类型
UnitType用于单位转换使用的ID
Ceiling云高
Value云高取整数
Unit云高数值的单位类型
UnitType用于单位转换使用的ID
UVIndex紫外线强度衡量指数，UV Index、描述、颜色如下：
0-2(Green)：Low danger from the sun's UV rays or the average person；
3-5(Yellow)：Moderate risk of harm from unprotected sun exposure；
6-7(Orange)：High risk of harm from unprotected sun exposure；
8-10(Red)：Very high risk of harm from unprotected sun exposure；
11+(Purple)：Extreme risk of harm from unprotected sun exposure；
UVIndexText紫外线强度衡量指数文字说明
PrecipitationProbability降水概率(单位：%)
ThunderstormProbability雷暴概率(单位：%)
RainProbability降雨概率(单位：%)
SnowProbability降雪概率(单位：%)
IceProbability冻雪概率(单位：%)
TotalLiquid液体总量
Value总降水量取整数
Unit总降水数值的单位类型
UnitType用于单位转换使用的ID
Rain降雨
Value降雨取整数
Unit降雨数值的单位类型
UnitType用于单位转换使用的ID
Snow降雪
Value降雪取整数
Unit降雪数值的单位类型
UnitType用于单位转换使用的ID
Ice冻雪
Value冻雪取整数
Unit冻雪数值的单位类型
UnitType用于单位转换使用的ID
CloudCover云量
Evapotranspiration蒸发，土壤水分蒸发蒸腾损失总量。
Value蒸发取整数
Unit蒸发数值的单位类型
UnitType用于单位转换使用的ID
SolarIrradiance太阳辐照度，在地球表面测量的太阳电磁辐射（全球水平辐照度）。
可以为空。
Value太阳辐照度取整数
Unit太阳辐照度数值的单位类型
单位：瓦特/平方米（W/㎡）
UnitType用于单位转换使用的ID
MobileLink跳转至的华风爱科/Accuweather移动端网页的链接
Link跳转至的华风爱科/Accuweather网页的链接
调用示例 ​

在线体验