Skip to content

分钟降水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摘要信息
IfPretrue/false
PreTypeCode0代表无降水,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移动端网页的链接
调用示例
  1. 中国区域分钟级降水预报(经纬度搜索)

    json
    https://openapi.weathercn.com/nowcast_cn/v3/basic?q=39.95,116.328&apikey=<用户的key>

    在线体验