分钟降水API开发指南
基本信息
- 华风爱科 API提供给用户一个简洁的RESTful Web接口,用以访问基于位置的天气数据。
- 分钟级预报需要经纬度配合调取(输入经纬度必须截至小数点后2位)。
API服务地址
请求URL
类型 | URL | 请求方式 |
---|---|---|
中国区域分钟级降水预报(经纬度搜索) | https://openapi.weathercn.com/nowcast_cn/{version}/basic{.{format}}?q={latitude, longitude}&apikey=<用户的key> | GET |
输入经纬度必须截至小数点后2位;只适用于中国大陆地区访问,如果用户在非中国大陆地区,服务器可能会返回403或者错误代码,合作方不应频繁重试
请求参数
参数 | 说明 | 默认值 | |
---|---|---|---|
apikey | 用以在API里验证与授权使用的用户密钥 | N/A | 必选 |
version | 当前API版本 | v1 | 必选 |
q | (latitude,longitude),输入纬度与经度 | N/A | 必选 |
format | 响应格式 | JSON | 可选 |
返回参数
参数 | 说明 | ||
---|---|---|---|
Status | 状态,0或-1 | ||
Msg | 状态信息,ok或lat/lon out of range | ||
Lat | 纬度,精确到小数点后两位 | ||
Lon | 经度,精确到小数点后两位 | ||
Data | 摘要信息 | ||
IfPre | true/false | ||
PreTypeCode | 0代表无降水,1雨,2雪,3雨夹雪 | ||
PreType | 雨/雪/雨夹雪 | ||
NearestPre | 最近降水,单位公里 | ||
Intensity | 降水强度数组,20个,单位dbz: (0,0.25]小雨/雪; (0.25, 0.35]中雨/雪; (0.35, 1]大雨/雪; | ||
Interval | 周期,单位分钟 | ||
Description | 天气摘要短句 | ||
Datetime | 当前日期与时间, ISO8601 格式: yyyy-mm-ddThh:mm:ss±hh:mm | ||
Epochtime | 当前的UNIX时间,从协调世界时1970年1月1日0时0分0秒起至现在的总秒数,不考虑闰秒 (午夜 UTC/GMT) | ||
CurrentConditions | 实况天气现象 | ||
WeatherText | 当前天气实况的说明,以指定语言显示 | ||
WeatherCode | 本地数据供应商所提供的天气代码,需匹配WeatherCode编码表。 | ||
HourlyForecastsNext2H | 逐小时预报未来2小时天气现象 | ||
Datetime | 当前预报日期与时间, ISO8601 格式: yyyy-mm-ddThh:mm:ss±hh:mm | ||
Epochtime | 当前预报的UNIX时间,从协调世界时1970年1月1日0时0分0秒起至现在的总秒数,不考虑闰秒 (午夜 UTC/GMT) | ||
WeatherText | 预报天气实况的说明,以指定语言显示 | ||
WeatherCode | 本地数据供应商所提供的天气代码,需匹配WeatherCode编码表。 | ||
PrecipitationProbability | 降水概率 | ||
MobileLink | 跳转至的华风爱科/Accuweather移动端网页的链接 |
调用示例
中国区域分钟级降水预报(经纬度搜索)
jsonhttps://openapi.weathercn.com/nowcast_cn/v3/basic?q=39.95,116.328&apikey=<用户的key>