AI
产品服务
解决方案
文档与支持
定价
更新时间: 2026/03/23 17:17
天气服务
下载开发文档
简介

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

实现步骤

示例如下:

1. 构造请求参数:
String districtID = "110105"; // 天安门区域ID
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小时逐小时预报,高级字段

mLlifeIndexes

生活指数数据,高级字段

mWeatherAlerts

气象预警数据,高级字段

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

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

NO_ERROR

检索结果正常返回

NO_ADVANCED_PERMISSION

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

INVALID_DISTRICT_ID

区域编码无效

NO_DATA_FOR_LATLNG

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

PARAMER_ERROR

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

RESULT_NOT_FOUND

没有找到检索结果

上一篇

公交信息检索

下一篇

推荐上车点

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