全部服务产品
开发者频道
定价
登录
天气服务
下载开发文档
简介

国内天气查询
国内天气查询服务分为基础服务和高级权限。
在基础服务中,用户可通过行政区划代码查询实时天气信息及未来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没有找到检索结果

上一篇

公交信息检索

下一篇

推荐上车点

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