分钟降水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移动端网页的链接 |