产品服务
解决方案
文档与支持
定价
为什么选择百度地图
登录
国内天气查询
下载开发文档
接口说明

用户可通过行政区划代码查询实时天气信息及未来5天天气预报。

API服务地址

https://api.map.baidu.com/weather/v1/?district_id=222405&data_type=all&ak=你的ak
//GET请求

请求参数
参数名称参数含义默认值字段类型必选
district_id

区县的行政区划编码，和location二选一

无string否
location

经纬度，经度在前纬度在后，逗号分隔。支持类型：bd09mc/bd09ll/wgs84/gcj02。

无double否
ak

开发者密钥，可在API控制台申请获得

无string是
data_type请求数据类型。数据类型有：now/fc/index/alert/fc_hour/all，控制返回内容无string是
output返回格式，目前支持json/xmljsonstring否
coordtype支持类型:wgs84/bd09ll/bd09mc/gcj02wgs84string否

注意：如果district_id和location同时传，默认以district_id为准；

返回参数
参数名参数类型描述信息返回条件异常值
addressObject地理位置信息--
countryString国家名称始终返回-
provinceString省份名称始终返回-
cityString城市名称始终返回-
nameString区县名称始终返回-
idString区县id始终返回-
nowObject实况数据--
tempInt温度（℃）始终返回999999
feels_likeInt体感温度(℃)data_type=now/all999999
rhInt相对湿度(%)data_type=now/all999999
wind_classString风力等级data_type=now/all暂无
wind_dirString风向描述data_type=now/all暂无
textString天气现象
参考天气取值对照表		data_type=now/all暂无
prec_1hDouble1小时累计降水量(mm)data_type=now/all999999
cloudsInt云量(%)data_type=now/all999999
visInt能见度(m)data_type=now/all999999
aqiInt空气质量指数数值data_type=now/all999999
pm25Intpm2.5浓度(μg/m3)data_type=now/all999999
pm10Intpm10浓度(μg/m3)data_type=now/all999999
no2Int二氧化氮浓度(μg/m3)data_type=now/all999999
so2Int二氧化硫浓度(μg/m3)data_type=now/all999999
o3Int臭氧浓度(μg/m3)data_type=now/all999999
coDouble一氧化碳浓度(mg/m3)data_type=now/all999999
uptimeString数据更新时间，北京时间data_type=now/all-
alertObjectArray气象预警数据--
typeString预警事件类型
参考 天气取值对照表中的预警类型		data_type=alert/all暂无
levelString预警事件等级data_type=alert/all暂无
titleString预警标题data_type=alert/all-
descString预警详细提示信息data_type=alert/all-
indexesObjectArray生活指数数据--
nameString生活指数中文名称data_type=index/all暂无
briefString生活指数概要说明data_type=index/all暂无
detailString生活指数详细说明data_type=index/all暂无
forecastsObjectArray预报数据--
dateString日期，北京时区data_type=fc/all-
weekString星期，北京时区data_type=fc/all-
highInt最高温度(℃)data_type=fc/all999999
lowInt最低温度(℃)data_type=fc/all999999
wc_dayString白天风力data_type=fc/all暂无
wc_nightString晚上风力data_type=fc/all暂无
wd_dayString白天风向data_type=fc/all暂无
wd_nightString晚上风向data_type=fc/all暂无
text_dayString白天天气现象
参考天气取值对照表		data_type=fc/all暂无
text_nightString晚上天气现象
参考天气取值对照表		data_type=fc/all暂无
如您需要获取国内经纬度天气查询，海外经纬度天气查询，请点击国内经纬度天气查询，海外经纬度天气查询。

未来24小时逐小时预报返回参数

参数名参数类型描述信息返回条件异常值
forecast_hoursObject Array预报数据--
textString天气现象
参考天气取值对照表		data_type=fc_hour/all"暂无"
temp_fcInt温度(℃)data_type=fc_hour/all999999
wind_classString风力等级data_type=fc_hour/all"暂无"
wind_dirString风向描述data_type=fc_hour/all"暂无"
rhInt相对湿度data_type=fc_hour/all999999
prec_1hDouble1小时累计降水量(mm)data_type=fc_hour/all999999
cloudsInt云量(%)data_type=fc_hour/all999999
data_timeString数据时间data_type=fc_hour/all999999
服务状态码
status编码错误原因补充说明
1服务器内部错误具体失败消息会在message提示
2
10缺少必要的请求参数缺少参数的时候会抛出该异常
11请求参数格式错误请求参数类型错误时会抛出该异常， 如字符长度、数据类型、数据格式不规范等
20身份验证失败ak 无效时会抛出该异常
21timestamp超出有效时间范围timestamp 与服务端的当前时间相差超过1分钟
40查询的区域编码无效查询的区域编码与约定的编码不符
41查询的经纬度值范围无效查询的经纬度超出了正常的经纬度范围
42不支持的数据类型查询的数据类型不支持
43不支持的语言类型查询的语言类型不支持
44经纬度所在地区无数据覆盖输入的经纬度区域无数据覆盖
45服务被禁用查询的数据类型与用户类型不匹配
50服务繁忙其他类型错误
101AK参数不存在请求消息没有携带AK参数
102MCODE参数不存在，mobile类型mcode参数必需对于Mobile类型的应用请求需要携带mcode参数，该错误码代表服务器没有解析到mcode
200APP不存在，AK有误请检查再重试根据请求的AK，找不到对应的APP
201APP被用户自己禁用，请在控制台解禁
202APP被管理员删除恶意APP被管理员删除
203APP类型错误当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone（类型22））及Browser（类型3），除此之外其他类型认为是APP类型错误
210APP IP校验失败在申请SERVER类型应用的时候选择IP校验，需要填写IP白名单，如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211APP SN校验失败SERVER类型APP有两种校验方式IP校验和SN校验，当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
220APP Referer校验失败浏览器类型的APP会校验referer字段是否存且切在referer白名单里面，否则返回该错误码
230APP Mcode码校验失败服务器能解析到mcode，但和数据库中不一致，请携带正确的mcode
240APP 服务被禁用用户在API控制台中创建或设置某APP的时候禁用了某项服务，若需开通权限，可进入API控制台为AK勾选对应服务
250用户不存在根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id
251用户被自己删除该用户处于未激活状态
252用户被管理员删除恶意用户被加入黑名单
260服务不存在服务器解析不到用户请求的服务名称
261服务被禁用该服务已下线，请在控制台确认是否有该服务的权限
301永久配额超限，限制访问配额超限，可在控制台购买提升配额
302天配额超限，限制访问配额超限，可在控制台购买提升配额
401当前并发量已经超过约定并发配额，限制访问并发控制超限，可在控制台购买提升并发
402当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问并发控制超限，可在控制台购买提升并发

上一篇

使用准备

下一篇

海外天气查询

本篇文章对您是否有帮助？