高级权限（国内经纬度天气查询）
GET
/weather/v1/
| 参数名 | 参数类型 | 描述信息 | 返回条件 | 异常值 | 字段类型 |
|---|---|---|---|---|---|
| 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 | 高级字段 |
| aqi | Int | 空气质量指数数值 | data_type=now/all | 999999 | 高级字段 |
| pm25 | Int | pm2.5浓度(μg/m3) | data_type=now/all | 999999 | 高级字段 |
| pm10 | Int | pm10浓度(μg/m3) | data_type=now/all | 999999 | 高级字段 |
| no2 | Int | 二氧化氮浓度(μg/m3) | data_type=now/all | 999999 | 高级字段 |
| so2 | Int | 二氧化硫浓度(μg/m3) | data_type=now/all | 999999 | 高级字段 |
| o3 | Int | 臭氧浓度(μg/m3) | data_type=now/all | 999999 | 高级字段 |
| co | Double | 一氧化碳浓度(mg/m3) | data_type=now/all | 999999 | 高级字段 |
| uptime | String | 数据更新时间，北京时间 | data_type=now/all | - | 基础字段 |
| alert | ObjectArray | 气象预警数据 | - | - | 高级字段 |
| type | String | 预警事件类型 | data_type=alert/all | "暂无" | 高级字段 |
| level | String | 预警事件等级 | data_type=alert/all | "暂无" | 高级字段 |
| title | String | 预警标题 | data_type=alert/all | - | 高级字段 |
| desc | String | 预警详细提示信息 | data_type=alert/all | - | 高级字段 |
| indexes | ObjectArray | 生活指数数据 | - | - | 高级字段 |
| name | String | 生活指数中文名称 | data_type=index/all | "暂无" | 高级字段 |
| brief | String | 生活指数概要说明 | data_type=index/all | "暂无" | 高级字段 |
| detail | String | 生活指数详细说明 | data_type=index/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 | "暂无" | 基础字段 |
| 参数名 | 参数类型 | 描述信息 | 返回条件 | 异常值 | 字段类型 |
|---|---|---|---|---|---|
| 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 | 高级字段 |
| status编码 | 错误原因 | 补充说明 |
|---|---|---|
| 1 | 服务器内部错误 | 具体失败消息会在message提示 |
| 2 | 高级权限才允许使用location字段 | 用户需开通高级权限功能 |
| 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 | 当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问 | 并发控制超限，可在控制台购买提升并发 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.map.baidu.com/weather/v1/?data_type=all&ak='响应示例响应示例
{}请求参数
Query 参数
location
string
可选
示例值:
116.40387,39.91489
data_type
string
必需
示例值:
all
district_id
string
可选
output
string
可选
coordtype
string
可选
ak
string
必需
默认值:
{{ak}}
返回响应
修改于 2022-08-22 02:15:07