JAVA SDK 使用文档

下载

版本号 更新日期 MD5
1.6 2018-10-15 cc6e0ef1ca479c5a44eb3149a9cd579e 下载

适配版本

JDK 1.6+

1.工程配置

解压文件,将文件夹内jar放入您的工程,并且引用

引用库

    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.2.9</version>
    </dependency>

建议 fastjson 升级为 1.2.40+ 版本

2.接口和数据类对照

各个接口的方法都有一个或多个重载方法名

接口说明 接口代码 数据类
城市查询 s6Search Search
3-10天天气预报 s6Forecast List<Forecast>
实况天气 s6Now List<Now>
逐小时预报 s6Hourly List<Hourly>
生活指数 s6Lifestyle List<Lifestyle>
常规天气数据集合 s6Weather List<Weather>
格点实况天气 s6GridNow GridNow
格点逐天预报 s6GridForecast GridForecast
格点逐小时预报 s6GirdHourly GridHourly
分钟级降雨(邻近预报) s6GirdMinute GirdMinute
天气灾害预警 s6Alarm List<Alarm>
天气灾害预警集合 s6AlarmAll AlarmAll
景点天气预报 s6ScenicForecast List<Scenic>
空气质量实况 s6AirNow List<AirNow>
空气质量7天预报 s6AirForecast List<AirForecast>
空气质量逐小时预报 s6AirHourly List<AirHourly>
空气质量数据集合 s6Air List<Air>
卫星云图 s6CloudMapNewest byte[]
太阳高度 s6SolarElevationAngle SolarElevationAngle
日出日落 s6SunRiseAndSet List<SolarSunriseSunset>
历史数据 s6Historical Historical

3.数据类属性对照

详见同目录和风 JAVA SDK 实体类属性对照

4.数据访问代码

  • SDK 不提供日志功能, 错误信息可由回调函数 OnError 中的 Throwable 对象提供
  • 使用 SDK 时,需 提前进行账户初始化(全局执行一次即可)
//全局执行一次即可
HeConfig.init("userId", "key");
  • SDK 默认访问付费服务域名,普通用户可通过以下方法进行调整(全局执行一次即可)
//切换至普通服务域名
HeConfig.switchToFreeServerNode();
//切换至中国付费服务域名
HeConfig.switchToCNBusinessServerNode();
  • 根据您的需求调用不同的方法,接口回调方法中的参数就是接口返回的数据类

示例

/**
 * 实况天气
 * 实况天气即为当前时间点的天气状况以及温湿风压等气象指数,具体包含的数据:体感温度、
 * 实测温度、天气状况、风力、风速、风向、相对湿度、大气压强、降水量、能见度等。
 *
 * @param location (必填)城市 ID, 经纬度(经度在前,纬度在后,以高德经纬度为准),Adcode, 名称,IP(精度不高)
 * @param lang     (选填)多语言,可以不使用该参数,默认为简体中文
 * @param unit     (选填)单位选择,公制(m)或英制(i),默认为公制单位
 * @param callback 网络访问回调接口
 */
HeWeather.s6Now("CN101010300", Lang.CHINESE_SIMPLIFIED, Unit.METRIC, new Callback<List<Now>>() {
    @Override
    public void onSuccess(List<Now> value) {
        System.out.println(JSON.toJSONString(value));
    }

    @Override
    public void onError(Throwable e) {
        e.printStackTrace();
    }
});

地址详解,location参数

权限说明 代码
城市ID:城市列表 location=CN101010100
经纬度格式:经度,纬度(经度在前,纬度在后英文,分隔,十进制格式,北纬东经为正,南纬西经为负 location=116.40,39.9
城市名称,城市列表 location=北京、 location=北京市、 location=beijing
城市名称,上级城市 或 省 或 国家,英文逗号分隔,此方式可以在重名的情况下只获取想要的地区的天气数据,例如 西安,陕西 location=朝阳,北京、 location=chaoyang,beijing
IP location=60.194.130.1
根据请求自动判断,根据用户的请求获取IP,通过 IP 定位并获取城市数据 location=auto_ip(固定参数)