分钟级降水 API

nowcast_cn/v3/basic 分钟级降水：经纬度 q 查询中国区域未来约 2 小时降水强度序列，无需 Location Key；全球路径为进阶能力。

产品概述

华风爱科分钟级降水预报 API（MinuteCast）提供高分辨率短临降水预报。与逐小时预报按小时输出不同，本接口返回未来约 2 小时的降水强度序列（Intensity）与自然语言短临描述。中国区域标准路径为 nowcast_cn/v3/basic，使用经纬度查询，无需 Location Key；全球覆盖为进阶能力。由中国气象局授权品牌与 AccuWeather 全球数据能力提供支撑。

  • ✓标准能力： /nowcast_cn/v3/basic?q=纬度,经度 中国区域短临降水
  • ✓进阶能力： /nowcast_global/v3/basic 全球分钟级降水（需单独开通）
  • ✓强度序列： Intensity 数组 + Interval 时间间隔（分钟）
  • ✓典型场景： 出行带伞提醒、分钟级降水动画、本地生活推送
产品效果

中国路径为默认标准能力；全球路径为进阶能力，需申请开通后使用（与示例中心说明一致）

分钟级降水动画效果

基于 Intensity 强度序列驱动的短临降水动画，直观展示未来约 2 小时降雨变化趋势。

华风爱科 MinuteCast 分钟级降水预报界面与短临描述示例

产品预报界面演示

展示 ShortPhrase、Description 等自然语言短临提示与降水概率信息。

快速开始

  1. 免费注册并完成开发者认证，获取 API Key（标准测试 Key 开通 30 天试用，每日 500 次免费调用，5 QPS）。
  2. 准备查询坐标：直接使用 纬度,经度（如北京附近 39.95,116.328），或通过 定位搜索 GeoPosition 获取坐标。
  3. 请求中国标准路径 GET /nowcast_cn/v3/basic?q=39.95,116.328，从返回的 Data.Intensity 与 Data.Interval 解析降水强度序列。

标准能力接口（中国）

GET 分钟级降水预报（中国）
https://openapi.weathercn.com/nowcast_cn/v3/basic?q=39.95,116.328&apikey=YOUR_API_KEY

进阶能力接口（全球）

⚠️ 全球分钟级降水（nowcast_global）需单独申请开通权限。标准测试 Key 无法调用，会返回 401/403。如需开通，请注册账号后联系商务咨询，或在开发者后台提交权限申请。
GET 分钟级降水预报（全球） 进阶
https://openapi.weathercn.com/nowcast_global/v3/basic?q=39.95,116.328&apikey=YOUR_API_KEY

请求参数

中国标准路径（nowcast_cn）与全球进阶路径（nowcast_global）均通过查询参数传递位置与密钥，无需 Location Key，使用 q=纬度,经度 即可。

参数名 类型 必填 默认值 说明 示例
apikey String 是 - 用以在API里验证与授权使用的用户密钥 YOUR_API_KEY
q String 是 - 查询位置，格式为「纬度,经度」（与示例中心一致，如北京附近 39.95,116.328） 39.95,116.328

返回字段

参数 类型 说明 数据形式示例
Status
String 状态码 1
Msg
String 状态描述 ok
Lat
Float 纬度 39.95
Lon
Float 经度 116.33
Data ▶
Object 预报核心数据
15 个子字段
 -
└─ IfPre
Boolean 未来2小时是否有降水 false
└─ IsLocalPre
Boolean 本地是否有降水 false
└─ PreTypeCode
Int 降水类型代码 0
└─ PreType
String 降水类型名称 ""
└─ NearestPreDirection
String 最近降水方向 ""
└─ NearestPre
Int 最近降水距离 999
└─ Intensity
Array 降水强度序列 (每6分钟一个值) -
└─ Interval
Int 数据时间间隔 (分钟) 6
└─ Description
String 降水趋势详细描述 未来2小时无降水
└─ ShortPhrase
String 降水趋势简短描述 ""
└─ Datetime
String 发布时间 2026-07-27T13:50:00+08:00
└─ Epochtime
Int 发布的 UNIX 时间戳 1785131400
└─ MobileLink
String 移动端地图链接 https://m.weathercn.com/weatherMap.do?mapType=precip&lang=zh-cn&z=wx4er0sv&phrase=未来2小时无降水
└─ CurrentConditions ▶
Object 当前天气状况
2 个子字段
 -
└─ WeatherText
String 天气描述 多云
└─ WeatherCode
String 天气代码 01
└─ HourlyForecastsNext2H ▶
Array 未来2小时逐小时预报摘要
5 个子字段
 -
└─ Datetime
String 预报时间 2026-07-27T14:00:00+08:00
└─ Epochtime
Int 预报时间的 UNIX 时间戳 1785132000
└─ WeatherText
String 天气描述 晴
└─ WeatherCode
String 天气代码 00
└─ PrecipitationProbability
Int 降水概率 (%) 0
>_ 代码示例
Request 
curl "https://openapi.weathercn.com/nowcast_cn/v3/basic?q=39.95,116.328&apikey=YOUR_API_KEY"
fetch('https://openapi.weathercn.com/nowcast_cn/v3/basic?q=39.95,116.328&apikey=YOUR_API_KEY')
  .then(r => r.json()).then(console.log);
import requests
url = "https://openapi.weathercn.com/nowcast_cn/v3/basic"
params = {'q': '39.95,116.328', 'apikey': 'YOUR_API_KEY'}
print(requests.get(url, params=params).json())
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://openapi.weathercn.com/nowcast_cn/v3/basic?q=39.95,116.328&apikey=YOUR_API_KEY"))
    .build();
<?php
$url = 'https://openapi.weathercn.com/nowcast_cn/v3/basic';
$params = http_build_query(['q'=>'39.95,116.328','apikey'=>'YOUR_API_KEY']);
print_r(json_decode(file_get_contents($url.'?'.$params), true));
?>
url := "https://openapi.weathercn.com/nowcast_cn/v3/basic?q=39.95,116.328&apikey=YOUR_API_KEY"
resp, _ := http.Get(url)
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
url = URI("https://openapi.weathercn.com/nowcast_cn/v3/basic")
url.query = URI.encode_www_form({q:'39.95,116.328',apikey:'YOUR_API_KEY'})
puts JSON.parse(Net::HTTP.get_response(url).body)
let url = URL(string: "https://openapi.weathercn.com/nowcast_cn/v3/basic?q=39.95,116.328&apikey=YOUR_API_KEY")!
URLSession.shared.dataTask(with: url) { d,_,_ in if let d=d { print(try? JSONSerialization.jsonObject(with:d)) } }.resume()
Response 
{
  "Status": "2",
  "Msg": "ok",
  "Lat": 39.0,
  "Lon": 116.0,
  "Data": {
    "IfPre": true,
    "IsLocalPre": true,
    "PreTypeCode": 1,
    "PreType": "雨",
    "NearestPreDirection": "",
    "NearestPre": 0,
    "Intensity": [0.0, 0.0, 0.0, 0.054, 0.082, 0.124, 0.11, 0.068, 0.068, 0.068, 0.068, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0],
    "Interval": 6,
    "Description": "20分钟后开始下小雨，下下停停",
    "ShortPhrase": "20分钟后开始下小雨",
    "Datetime": "2026-03-10T11:17:00+08:00",
    "Epochtime": 1773112620,
    "MobileLink": "https://m.weathercn.com/weatherMap.do?mapType=precip&lang=zh-cn&phrase=20分钟后开始下小雨，下下停停",
    "CurrentConditions": {
      "WeatherText": "霾",
      "WeatherCode": "53"
    },
    "HourlyForecastsNext2H": [
      {
        "Datetime": "2026-03-10T12:00:00+08:00",
        "Epochtime": 1773115200,
        "WeatherText": "小雨",
        "WeatherCode": "07",
        "PrecipitationProbability": 75
      },
      {
        "Datetime": "2026-03-10T13:00:00+08:00",
        "Epochtime": 1773118800,
        "WeatherText": "多云",
        "WeatherCode": "01",
        "PrecipitationProbability": 0
      }
    ]
  }
}
☆
获取 API Key：请先免费注册并完成开发者认证，标准测试 Key 开通 30 天试用，每日 500 次免费调用（5 QPS）。
坐标查询：本接口使用 q=纬度,经度，无需 Location Key；可从 GPS 或 GeoPosition 定位 获取坐标。
安全传参：建议通过 Header 传递密钥 X-Gw-API-Key: YOUR_API_KEY，避免 Key 出现在 URL 日志中。