国内天气查询
国内天气查询服务分为基础服务和高级权限。
在基础服务中,用户可通过行政区划代码查询实时天气信息及未来5天天气预报。
在高级权限中,用户可通过经纬度查询实时天气信息、未来7天天气预报及未来24小时逐小时预报。同时,用户还可以通过高级权限获取国内空气质量指数、生活指数、气象预警等丰富信息。
海外天气查询
海外天气查询服务分为基础服务和高级权限。
在基础服务中,用户可通过行政区划代码查询实时天气信息及未来5天天气预报。
在高级权限中,用户可通过经纬度查询实时天气信息、未来7天天气预报及未来24小时逐小时预报。同时,用户还可以通过高级权限获取云量、能见度、降水量等信息。
高级权限需付费开通,您可以联系我们开通15天试用并了解更多信息。
示例如下:
String districtID = "110105"; // 天安门区域IDWeatherSearchOption weatherSearchOption = new WeatherSearchOption().weatherDataType(WeatherDataType.WEATHER_DATA_TYPE_ALL).districtID(districtID);
WeatherSearch mWeatherSearch = WeatherSearch.newInstance();mWeatherSearch.setWeatherSearchResultListener(new OnGetWeatherResultListener() {@Overridepublic void onGetWeatherResultListener(final WeatherResult weatherResult) {}});
mWeatherSearch.request(weatherSearchOption);
通过返回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 | 没有找到检索结果 |
上一篇
下一篇
本篇文章对您是否有帮助?