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字符串的反序列化；

最后通過這些數據進行項目的各種可行性功能操作即可。