百度天气返回的json数据各参数的意义

请求参数

参数名数据类型是否必传默认值描述信息

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

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

高级字段

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

"暂无"

基础字段

未来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

高级字段

服务状态码

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

当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问并发控制超限,可在控制台购买提升并发

示例代码

请求类型为all的响应示例(部分字段需开通高级权限,具体请参考上方文档说明)

{
    "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,
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值