用户可通过行政区划代码查询实时天气信息及未来5天天气预报。
https://api.map.baidu.com/weather_abroad/v1/?district_id=JPN10041030001&data_type=all&ak=你的ak
//GET请求
参数名 | 数据类型 | 必选 | 默认值 | 描述信息 |
---|---|---|---|---|
district_id | string | 否 | 无 | 海外城市行政区划编码海外城市行政区划编码为自定义,只支持海外天气查询服务使用),和location二选一 |
location | double | 否 | 无 | 经纬度,经度在前纬度在后,逗号分隔。支持类型:bd09mc/bd09ll/wgs84/gcj02。 |
ak | string | 是 | 无 | 开发者密钥,可在API控制台申请获得 |
data_type | string | 是 | 无 | 请求数据类型。数据类型有:now/fc/index/alert/fc_hour/all,控制返回内容 |
output | string | 否 | json | 返回格式,目前支持json/xml |
language | string | 否 | cn | 语言类型。语言类型有: cn/en,分别表示中文和英文, 默认中文。目前仅支持行政区划显示英文。 |
coordtype | string | 否 | wgs84 | 支持类型:wgs84/bd09ll/bd09mc/gcj02 |
注意:如果district_id和location同时传,默认以district_id为准;
参数名 | 参数类型 | 描述信息 | 返回条件 | 异常值 |
---|---|---|---|---|
address | Object | 地理位置信息 | - | - |
country | String | 国家名称 | 始终返回 | - |
province | String | 省份名称 | 始终返回 | - |
city | String | 城市名称 | 始终返回 | - |
name | String | 区县名称 | 始终返回 | - |
id | String | 区县id | 始终返回 | - |
now | Object | 实况数据 | - | - |
temp | Int | 温度(℃) | 始终返回 | 999999 |
feels_like | Int | 体感温度(℃) | data_type=now/all | 999999 |
rh | Int | 相对湿度(%) | data_type=now/all | 999999 |
wind_class | String | 风力等级 | data_type=now/all | 暂无 |
wind_dir | String | 风向描述 | data_type=now/all | 暂无 |
text | String | 天气现象 | data_type=now/all | 暂无 |
prec_1h | Double | 1小时累计降水量(mm) | data_type=now/all | 999999 |
clouds | Int | 云量(%) | data_type=now/all | 999999 |
vis | Int | 能见度(m) | data_type=now/all | 999999 |
uptime | String | 数据更新时间,当地时间 | data_type=now/all | - |
forecasts | ObjectArray | 预报数据 | - | - |
date | String | 日期,当地时间 | data_type=fc/all | - |
week | String | 星期,当地时间 | data_type=fc/all | - |
high | Int | 最高温度(℃) | data_type=fc/all | 999999 |
low | Int | 最低温度(℃) | data_type=fc/all | 999999 |
wc_day | String | 白天风力 | data_type=fc/all | "暂无" |
wc_night | String | 晚上风力 | data_type=fc/all | "暂无" |
wd_day | String | 白天风向 | data_type=fc/all | "暂无" |
wd_night | String | 晚上风向 | data_type=fc/all | "暂无" |
text_day | String | 白天天气现象 | data_type=fc/all | "暂无" |
text_night | String | 晚上天气现象 | data_type=fc/all | "暂无" |
未来24小时逐小时预报返回参数
参数名 | 参数类型 | 描述信息 | 返回条件 | 异常值 |
---|---|---|---|---|
forecast_hours | Object Array | 预报数据 | - | - |
text | String | 天气现象 | data_type=fc_hour/all | "暂无" |
temp_fc | Int | 温度(℃) | data_type=fc_hour/all | 999999 |
wind_class | String | 风力等级 | data_type=fc_hour/all | "暂无" |
wind_dir | String | 风向描述 | data_type=fc_hour/all | "暂无" |
rh | Int | 相对湿度 | data_type=fc_hour/all | 999999 |
prec_1h | Double | 1小时累计降水量(mm) | data_type=fc_hour/all | 999999 |
clouds | Int | 云量(%) | data_type=fc_hour/all | 999999 |
data_time | String | 数据时间 | data_type=fc_hour/all | 999999 |
1 | 服务器内部错误 | 具体失败消息会在message提示 |
2 | ||
10 | 缺少必要的请求参数 | 缺少参数的时候会抛出该异常 |
11 | 请求参数格式错误 | 请求参数类型错误时会抛出该异常, 如字符长度、数据类型、数据格式不规范等 |
20 | 身份验证失败 | ak 无效时会抛出该异常 |
21 | timestamp超出有效时间范围 | timestamp 与服务端的当前时间相差超过1分钟 |
40 | 查询的区域编码无效 | 查询的区域编码与约定的编码不符 |
41 | 查询的经纬度值范围无效 | 查询的经纬度超出了正常的经纬度范围 |
42 | 不支持的数据类型 | 查询的数据类型不支持 |
43 | 不支持的语言类型 | 查询的语言类型不支持 |
44 | 经纬度所在地区无数据覆盖 | 输入的经纬度区域无数据覆盖 |
45 | 服务被禁用 | 查询的数据类型与用户类型不匹配 |
50 | 服务繁忙 | 其他类型错误 |
101 | AK参数不存在 | 请求消息没有携带AK参数 |
102 | MCODE参数不存在,mobile类型mcode参数必需 | 对于Mobile类型的应用请求需要携带mcode参数,该错误码代表服务器没有解析到mcode |
200 | APP不存在,AK有误请检查再重试 | 根据请求的AK,找不到对应的APP |
201 | APP被用户自己禁用,请在控制台解禁 | |
202 | APP被管理员删除 | 恶意APP被管理员删除 |
203 | APP类型错误 | 当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22))及Browser(类型3),除此之外其他类型认为是APP类型错误 |
210 | APP IP校验失败 | 在申请SERVER类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败 |
211 | APP SN校验失败 | SERVER类型APP有两种校验方式IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败 |
220 | APP Referer校验失败 | 浏览器类型的APP会校验referer字段是否存且切在referer白名单里面,否则返回该错误码 |
230 | APP Mcode码校验失败 | 服务器能解析到mcode,但和数据库中不一致,请携带正确的mcode |
240 | APP 服务被禁用 | 用户在API控制台中创建或设置某APP的时候禁用了某项服务,若需开通权限,可进入API控制台为AK勾选对应服务 |
250 | 用户不存在 | 根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id |
251 | 用户被自己删除 | 该用户处于未激活状态 |
252 | 用户被管理员删除 | 恶意用户被加入黑名单 |
260 | 服务不存在 | 服务器解析不到用户请求的服务名称 |
261 | 服务被禁用 | 该服务已下线,请在控制台确认是否有该服务的权限 |
301 | 永久配额超限,限制访问 | 配额超限,可在控制台购买提升配额 |
302 | 天配额超限,限制访问 | 配额超限,可在控制台购买提升配额 |
401 | 当前并发量已经超过约定并发配额,限制访问 | 并发控制超限,可在控制台购买提升并发 |
402 | 当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问 | 并发控制超限,可在控制台购买提升并发 |
上一篇
下一篇
本篇文章对您是否有帮助?