Skip to content

天气实况

更新频率:约15分钟

滞后时间:约30分钟

调用示例

sh
POST https://open.apihub.net/api/weather-basic/now
apihub-token: {{ apihub_token }}

{
    "lng": 116.40,
    "lat": 39.93
}
sh
curl -X POST \
  "https://open.apihub.net/api/weather-basic/now" \
  -H "apihub-token: {{ apihub_token }}" \
  -H "Content-Type: application/json" \
  -d '{
    "lng": 116.40,
    "lat": 39.93
}'

参数说明

参数位置类型必传说明
lngJsonBodynumber经度
latJsonBodynumber纬度

未传经纬度时,将默认尝试ip定位。

返回值说明


{>...3
    "success": true,

    "trace": "c0f039d8219c11f09f814a73ab197607",

    "result": {>...3
        "location": {>...2
            "name": "福州",

            "path": "福州,福州,福建,中国"

        
},

        "now": {>...3
            "text": "阴",

            "code": "9",

            "temperature": "17"

        
},

        "lastUpdated": 1745561261000

    
}

}
字段说明
now.text天气现象 文字描述
now.code天气现象 编码
now.temperature温度,单位:°C

逐日天气

数据时间范围:今天,明天,后天

更新频率:3~4次每天

调用示例

sh
POST https://open.apihub.net/api/weather-basic/daily
apihub-token: {{ apihub_token }}

{
    "lng": 116.40,
    "lat": 39.93
}
sh
curl -X POST \
  "https://open.apihub.net/api/weather-basic/daily" \
  -H "apihub-token: {{ apihub_token }}" \
  -H "Content-Type: application/json" \
  -d '{
    "lng": 116.40,
    "lat": 39.93
}'

参数说明

参数位置类型必传说明
lngJsonBodynumber经度
latJsonBodynumber纬度

未传经纬度时,将默认尝试ip定位。

返回值说明


{>...3
    "success": true,

    "trace": "e91ab94c219c11f096f8c6807b612ccf",

    "result": {>...3
        "location": {>...2
            "name": "福州",

            "path": "福州,福州,福建,中国"

        
},

        "daily": [>...3
            
{>...14
                "date": "2025-04-25",

                "text_day": "小雨",

                "code_day": "13",

                "text_night": "小雨",

                "code_night": "13",

                "high": "19",

                "low": "15",

                "rainfall": "4.41",

                "precip": "0.56",

                "wind_direction": "无持续风向",

                "wind_direction_degree": "",

                "wind_speed": "8.4",

                "wind_scale": "2",

                "humidity": "79"

            
},

            
{>...14
                "date": "2025-04-26",

                "text_day": "多云",

                "code_day": "4",

                "text_night": "小雨",

                "code_night": "13",

                "high": "22",

                "low": "15",

                "rainfall": "1.90",

                "precip": "0.41",

                "wind_direction": "无持续风向",

                "wind_direction_degree": "",

                "wind_speed": "8.4",

                "wind_scale": "2",

                "humidity": "77"

            
},

            
{>...14
                "date": "2025-04-27",

                "text_day": "阴",

                "code_day": "9",

                "text_night": "中雨",

                "code_night": "14",

                "high": "27",

                "low": "20",

                "rainfall": "14.70",

                "precip": "0.95",

                "wind_direction": "无持续风向",

                "wind_direction_degree": "",

                "wind_speed": "3.0",

                "wind_scale": "1",

                "humidity": "82"

            
}

        
],

        "lastUpdated": 1745539200000

    
}

}
字段说明
daily[].text_day白天 天气现象 文字描述
daily[].code_day白天 天气现象 编码
daily[].text_night晚间 天气现象 文字描述
daily[].code_night晚间 天气现象 编码
daily[].high当天最高温度,单位:°C
daily[].low当天最低温度,单位:°C
daily[].precip降水概率,范围:0~1
daily[].rainfall降水量,单位:mm
daily[].wind_direction风向 文字描述
daily[].wind_direction_degree风向角度,范围:0~360
daily[].wind_speed风速,单位:km/h
daily[].wind_scale风力等级
daily[].humidity相对湿度,0~100,单位:百分比

相关资源

天气图标

适合深色背景下使用。资源地址:https://apihub-net.oss-cn-beijing.aliyuncs.com/img/weather/v3/${天气现象 编码}.svg