androidsdk

更新时间：2020-06-23

简介

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

WebAPI文档全面上新