百度地图开放平台
更新时间: 2026/09/08 10:08
天气服务
下载开发文档
简介

国内天气查询
国内天气查询服务分为基础服务和高级服务两类,其中高级服务需申请高级权限。
在基础服务中,用户可通过行政区划代码查询实时天气信息及未来5天天气预报。
在高级权限中,用户可通过经纬度查询实时天气信息、未来7天天气预报及未来24小时逐小时预报。同时,用户还可以通过高级权限获取国内空气质量指数、生活指数、气象预警等丰富信息。
海外天气查询
海外天气查询服务分为基础服务和高级权限。
在基础服务中,用户可通过行政区划代码查询实时天气信息及未来5天天气预报。
在高级权限中,用户可通过经纬度查询实时天气信息、未来7天天气预报及未来24小时逐小时预报。同时,用户还可以通过高级权限获取云量、能见度、降水量等信息。
高级权限需付费开通,您可以联系我们开通15天试用并了解更多信息。

实现步骤

示例如下:

1. 构造请求参数:
String districtID = "110105"; // 北京市朝阳区行政区划编码
WeatherSearchOption weatherSearchOption = new WeatherSearchOption()
.weatherDataType(WeatherDataType.WEATHER_DATA_TYPE_ALL)
.districtID(districtID);
2. 设置天气请求回调:
WeatherSearch mWeatherSearch = WeatherSearch.newInstance();
mWeatherSearch.setWeatherSearchResultListener(new OnGetWeatherResultListener() {
@Override
public void onGetWeatherResultListener(final WeatherResult weatherResult) {
}
});
3. 发起天气检索请求:
mWeatherSearch.request(weatherSearchOption);
4. 处理检索返回的结果WeatherResult:

通过返回WeatherResult的error判断检索是否成功,如果检索成功,可通过解析result字段获取具体的结果。具体使用示例可参照官方demo中的WeatherSearchActivity。
WeatherResult结构见下表:

结果数据含义

mRealTimeWeather

天气实况数据

mLocation

地理位置信息

mForecasts

未来若干天的天气预报数据

mForecastHours

未来24小时逐小时预报,高级字段

mLifeIndexes

生活指数数据,高级字段

mWeatherAlerts

气象预警数据,高级字段

注意:使用经纬度location字段发起天气检索,以及获取返回结果WeatherResult中的部分字段,需要申请高级服务权限,首先需要进行企业认证, 之后需要提交工单申请这个权限, 并详细说明使用场景, 包括但不限于:使用开放平台的哪些产品及服务、应用在贵方哪些产品上及该产品的相关介绍、预估使用配额等。另外需附带AK信息。

部分错误码对照表
错误码含义

NO_ERROR

检索结果正常返回

NO_ADVANCED_PERMISSION

用户需开通高级权限,例如:仅高级权限允许使用location字段;查询的数据类型与用户类型不匹配

INVALID_DISTRICT_ID

区域编码无效

NO_DATA_FOR_LATLNG

经纬度所在地图无数据覆盖或者经纬度无效

PARAMER_ERROR

请求参数错误,缺少必要的参数或者参数格式错误

RESULT_NOT_FOUND

没有找到检索结果

上一篇

公交信息检索

下一篇

推荐上车点
本篇文章对您是否有帮助?