AndroidSDK——和风天气使用初体验

最近做的项目涉及到获取当地的天气状态等信息，偶然发现和风天气这个很好用，所以打算分享一下。

---

官方文档：https://dev.heweather.com/docs/sdk/android

首先进行注册

并在控制台创建应用获取username，key 待后续使用

下载

和风天气SDK的jar包，并集成到Android项目中

jar包：https://a.hecdn.net/download/api_sdk/HeWeather_Public_Android_V3.3.jar

(可以进入官方网站获取最新版的jar包

集成步骤：（下图展示

1. 找到AndroidStudio的Project目录下的app路径的libs文件夹中，将jar包粘贴到该路径。
2. 右击jar包，点击[Add As Library] 进行集成
3. 集成成功后，Build状态栏显示正常
4. 点击build.gradle文件中可以看到相关代码

添加依赖

同时在build.gradle文件的dependencies获取okhttp和gson的依赖

okhttp和gson是我们的old friends了，可见和风天气是利用okhttp进行网络访问同时将天气数据结果用gson的形式传输。

//引入okhttp和gson
    implementation 'com.squareup.okhttp3:okhttp:3.9.0'
    implementation 'com.google.code.gson:gson:2.6.2'

添加权限

集成成功后在AndroidManifest.xml文件添加相关权限

<!--必选Internet网络-->
    <uses-permission android:name="android.permission.INTERNET"/>
    <!-- 这个权限用于进行网络定位-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <!-- 这个权限用于访问GPS定位-->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <!-- 获取运营商信息，用于支持提供运营商信息相关的接口-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <!-- 用于读取手机当前的状态-->
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <!--wifi状态-->
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!--读取设置 唤醒屏幕-->
    <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
    <uses-permission android:name="android.permission.WAKE_LOCK"/>

获取相应权限后，我们即可通过代码获取地方天气数据

 在MainActivity.java的oncreate方法中，先进行天气环境初始化（在主线程中

init参数为第一步注册并获取的username和key，注意：应用定义包名必须和项目的包名一致

//和风天气init 初始化
        /*
        *参数：
        * s:Username
        * s1:Key
        * */
        HeConfig.init("HE2005212341181595","f4cbb7844d664d12b8f4149ea875ad57");
        //转换为免费模式
        HeConfig.switchToFreeServerNode();

在主线程进行动态权限申请，

REQUEST_GSP为自定义私有常量

private final int REQUEST_GPS = 1;

//动态申请GPS权限
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, REQUEST_GPS);

在动态申请的方法回调中进行weather方法调用

public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            Toast.makeText(MainActivity.this, "Permission GET", Toast.LENGTH_SHORT).show();
            if(requestCode==REQUEST_GPS){
                getWeather();
            }

        } else {
            Toast.makeText(MainActivity.this, "Permission Denied", Toast.LENGTH_SHORT).show();
        }

        super.onRequestPermissionsResult(requestCode, permissions, grantResults);

    }

定义getWeather()方法

public void getWeather() {
        HeWeather.getWeatherNow(MainActivity.this, Lang.CHINESE_SIMPLIFIED, Unit.METRIC, new HeWeather.OnResultWeatherNowBeanListener() {
            public static final String TAG = "he_feng_now";

            @Override
            public void onError(Throwable e) {
                Log.e(TAG, "onError: ", e);
                System.out.println("Weather Now Error:" + new Gson());
            }

            @Override
            public void onSuccess(Now dataObject) {
                Log.e(TAG, " Weather Now onSuccess: " + new Gson().toJson(dataObject));
                String jsonData = new Gson().toJson(dataObject);
                String tianqi = null, wendu = null, tianqicode = null;
                if (dataObject.getStatus().equals("ok")) {
                    String JsonNow = new Gson().toJson(dataObject.getNow());
                    JSONObject jsonObject = null;
                    try {
                        jsonObject = new JSONObject(JsonNow);
                        tianqi = jsonObject.getString("cond_txt");
                        Log.e("tinaqi", tianqi);
                        wendu = jsonObject.getString("tmp");
                        Log.e("wendu", wendu);
                    } catch (JSONException e) {
                        e.printStackTrace();
                    }
                } else {
                    Toast.makeText(MainActivity.this, "有错误", Toast.LENGTH_SHORT).show();
                    return;
                }

            }
        });

    }

结果

最后运行APP，可以在Log中看到相关信息。

通过获取到的gson字符串，我们可以通过json的getString获取相关数据信息。如天气或者温度等；

tianqi = jsonObject.getString("cond_txt");

当然一些其他的信息我看也可以创建实体类，进行gson字符串的反序列化；

最后通过这些数据进行项目的各种可行性功能操作即可。