全部服务产品
开发者频道
定价
登录
国内天气查询
下载开发文档
接口说明

用户可通过行政区划代码查询实时天气信息及未来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高级字段
示例代码
填写您的AK

输入AK可生成包含IP/SN校验方式的代码

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的AK
$ak = '您的AK';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
function request_get($url = '', $param = array()) {
if (empty($url) || empty($param)) {
return false;
}
$getUrl = $url . "?" . http_build_query($param);
$curl = curl_init(); // 初始化curl
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
curl_setopt($curl, CURLOPT_URL, $getUrl); // 抓取指定网页
curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
$data = curl_exec($curl); // 运行curl
if (!$data) {
print("an error occured in function request_get(): " . curl_error($curl) . "\n");
}
curl_close($curl);
return $data;
}
// 请求地址
$url = 'https://api.map.baidu.com/weather/v1/';
// 构造请求参数
$param['district_id'] = '222405';
$param['data_type'] = 'all';
$param['ak'] = $ak;
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
{
"status":0,
"result":{
"location":{
"country":"中国",
"province":"北京市",
"city":"北京市",
"name":"东城",
"id":"110101"
},
"now":{
"temp":4,
"feels_like":1,
"rh":73,
"wind_class":"2级",
"wind_dir":"东风",
"text":"多云",
"prec_1h":0,
"clouds":999999,
"vis":3471,
"aqi":140,
"pm25":107,
"pm10":0,
"no2":23,
"so2":22,
"o3":70,
"co":1.7,
"uptime":"20200220143500"
},
"indexes":[
{
"name":"晨练指数",
"brief":"较适宜",
"detail":"天气阴沉,请避免在林中晨练。"
},
{
"name":"洗车指数",
"brief":"适宜",
"detail":"天气较好,适合擦洗汽车。"
},
{
"name":"感冒指数",
"brief":"易发",
"detail":"天凉,昼夜温差大,易感冒"
},
{
"name":"紫外线指数",
"brief":"最弱",
"detail":"辐射弱,涂擦SPF8-12防晒护肤品。"
},
{
"name":"穿衣指数",
"brief":"较冷",
"detail":"建议着厚外套加毛衣等服装。"
},
{
"name":"运动指数",
"brief":"较适宜",
"detail":"气温较低,在户外运动请注意增减衣物。"
}
],
"alerts":[
{
"type": "道路冰雪",
"level": "蓝色预警",
"title": "市气象局发布道路冰雪蓝色预警[IV级/一般]",
"desc": "市气象局发布道路冰雪蓝色预警信号:受降雪天气影响,
预计未来 24 小时我市将出现对交通有影响的道路结冰或积雪,
请有关部门及广大群众做好防范工作。"
}
],
"forecasts":[
{
"date":"2020-02-20",
"week":"星期四",
"high":7,
"low":-2,
"wc_day":"<3级",
"wc_night":"<3级",
"wd_day":"东南风",
"wd_night":"北风",
"text_day":"多云",
"text_night":"阴",
"aqi":93
},
{
"date":"2020-02-21",
"week":"星期五",
"high":11,
"low":1,
"wc_day":"4~5级",
"wc_night":"<3级",
"wd_day":"西北风",
"wd_night":"西北风",
"text_day":"多云",
"text_night":"晴",
"aqi":44
},
{
"date":"2020-02-22",
"week":"星期六",
"high":10,
"low":-2,
"wc_day":"<3级",
"wc_night":"<3级",
"wd_day":"西风",
"wd_night":"南风",
"text_day":"晴",
"text_night":"晴",
"aqi":39
},
{
"date":"2020-02-23",
"week":"星期日",
"high":11,
"low":0,
"wc_day":"<3级",
"wc_night":"<3级",
"wd_day":"北风",
"wd_night":"北风",
"text_day":"晴",
"text_night":"晴",
"aqi":65
},
{
"date":"2020-02-24",
"week":"星期一",
"high":9,
"low":-1,
"wc_day":"<3级",
"wc_night":"<3级",
"wd_day":"东风",
"wd_night":"东北风",
"text_day":"多云",
"text_night":"多云",
"aqi":38
},
{
"date":"2020-02-25",
"week":"星期二",
"high":9,
"low":-3,
"wc_day":"<3级",
"wc_night":"<3级",
"wd_day":"东南风",
"wd_night":"西南风",
"text_day":"晴",
"text_night":"晴",
"aqi":27
},
{
"date":"2020-02-26",
"week":"星期三",
"high":9,
"low":-3,
"wc_day":"<3级",
"wc_night":"<3级",
"wd_day":"西南风",
"wd_night":"西南风",
"text_day":"晴",
"text_night":"晴",
"aqi":26
}
],
"forecast_hours":[
{
"text":"晴",
"temp_fc":14,
"wind_class":"3~4级",
"wind_dir":"西南风",
"rh":15,
"prec_1h":0,
"clouds":10,
"data_time":"2020-04-01 16:00:00"
},
{
"text":"晴",
"temp_fc":14,
"wind_class":"3~4级",
"wind_dir":"西南风",
"rh":13,
"prec_1h":0,
"clouds":10,
"data_time":"2020-04-01 17:00:00"
},
{
"text":"晴",
"temp_fc":13,
"wind_class":"<3级",
"wind_dir":"西南风",
"rh":14,
"prec_1h":0,
"clouds":10,
"data_time":"2020-04-01 18:00:00"
},
{
"text":"晴",
"temp_fc":11,
"wind_class":"<3级",
"wind_dir":"西南风",
"rh":15,
"prec_1h":0,
"clouds":10,
"data_time":"2020-04-01 19:00:00"
},
{
"text":"晴",
"temp_fc":10,
"wind_class":"<3级",
"wind_dir":"西南风",
"rh":16,
"prec_1h":0,
"clouds":10,
"data_time":"2020-04-01 20:00:00"
},
{
"text":"晴",
"temp_fc":9,
"wind_class":"<3级",
"wind_dir":"西风",
"rh":18,
"prec_1h":0,
"clouds":6,
"data_time":"2020-04-01 21:00:00"
},
{
"text":"晴",
"temp_fc":9,
"wind_class":"<3级",
"wind_dir":"西风",
"rh":20,
"prec_1h":0,
"clouds":3,
"data_time":"2020-04-01 22:00:00"
},
{
"text":"晴",
"temp_fc":8,
"wind_class":"<3级",
"wind_dir":"西风",
"rh":21,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-01 23:00:00"
},
{
"text":"晴",
"temp_fc":7,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":26,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 00:00:00"
},
{
"text":"晴",
"temp_fc":6,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":31,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 01:00:00"
},
{
"text":"晴",
"temp_fc":6,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":36,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 02:00:00"
},
{
"text":"晴",
"temp_fc":5,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":39,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 03:00:00"
},
{
"text":"晴",
"temp_fc":4,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":42,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 04:00:00"
},
{
"text":"晴",
"temp_fc":4,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":45,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 05:00:00"
},
{
"text":"晴",
"temp_fc":5,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":40,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 06:00:00"
},
{
"text":"晴",
"temp_fc":7,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":34,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 07:00:00"
},
{
"text":"晴",
"temp_fc":8,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":29,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 08:00:00"
},
{
"text":"晴",
"temp_fc":11,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":29,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 09:00:00"
},
{
"text":"晴",
"temp_fc":13,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":29,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 10:00:00"
},
{
"text":"晴",
"temp_fc":16,
"wind_class":"<3级",
"wind_dir":"西北风",
"rh":29,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 11:00:00"
},
{
"text":"晴",
"temp_fc":17,
"wind_class":"3~4级",
"wind_dir":"西北风",
"rh":24,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 12:00:00"
},
{
"text":"晴",
"temp_fc":18,
"wind_class":"3~4级",
"wind_dir":"西北风",
"rh":19,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 13:00:00"
},
{
"text":"晴",
"temp_fc":19,
"wind_class":"3~4级",
"wind_dir":"西北风",
"rh":14,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 14:00:00"
},
{
"text":"晴",
"temp_fc":19,
"wind_class":"<3级",
"wind_dir":"西风",
"rh":17,
"prec_1h":0,
"clouds":0,
"data_time":"2020-04-02 15:00:00"
}
]
},
"message":"success"
}
在线运行
参数备注必选
district_id
区县的行政区划编码,和location二选一
data_type
请求数据类型。数据类型有:now/fc/index/alert/fc_hour/all,控制返回内容
服务状态码
status编码错误原因补充说明
1服务器内部错误具体失败消息会在message提示
2高级权限才允许使用location字段用户需开通高级权限功能
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当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问并发控制超限,可在控制台购买提升并发

上一篇

使用准备

下一篇

海外天气查询

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