天气查询服务 | 百度地图API SDK

所有文档

天气查询

服务概览

快速开始

使用准备

接口文档

服务功能

国内天气查询海外天气查询国内经纬度天气查询海外经纬度天气查询

相关资料

更新日志常见问题资源下载使用指南

海外天气查询

下载开发文档

接口说明

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

API服务地址

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

服务状态码

status编码	错误原因	补充说明


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	当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问	并发控制超限，可在控制台购买提升并发

国内天气查询

国内经纬度天气查询

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