聚合數據簡易開發流程

聚合數據SDK簡介

聚合數據SDK是一套基于Android/iOS開發的程序接口，目前已有Android、iOS版本。開發者可以使用該套SDK開發適用于Android/iOS系統移動設備的應用，通過調用SDK接口，可以輕松的訪問聚合的所有數據和服務，構建功能豐富、交互性強的應用程序
該SDK集成了平臺上的大部分數據服務（除電商SDK、比價SDK、定位SDK外）,開發者只需使用聚合SDK即可調用已經申請的數據，無需再針對不同數據編寫程序，更方便用戶快速開發。

Android SDK V2.0 簡易開發指南

該文檔僅適用于Android版本聚合數據SDK，下面是簡易的開發流程說明。詳細問題您可以通過 相關下載 下載相應的文檔、示例包、SDK。

一、開發工具

Android開發工具有很多，開發者可根據自己的喜好進行選擇。在此，我們推薦開發者使用Eclipse作為自己的開發工具，本套開發指南也是針對Eclipse開發環境下進行編寫的。

二、工程配置

將juhe_sdk_v_X_X.jar以及armeabi文件夾(內包含libJuheSDK_v_X_X.so)添加到工程中libs文件夾下,Android工程會自動將libs文件夾下的jar導入。

通過以上兩步操作后，您就可以正常使用短信驗證SDK為您提供的全部功能了。
注意：由于adt插件升級，若您使用Eclipse adt 22的話，需要對開發環境進行相應的設置，方法如下：
1. 在Eclipse 中選中工程，右鍵選 Properties->Java Build Path->Order and Export 使 Android Private Libraries處于勾選狀態；
2. Project -> clean-> clean all

三、調用SDK

①：先通過聚合數據中心（http://www.juhe.cn/docs）申請所需的數據服務。
②：創建并配置工程（具體方法參見工程配置部分的介紹）；
③：在AndroidManifest中添加開發密鑰（OPENID）、所需權限等信息；密鑰在個人中心->基本資料 頁面獲取。

1、在application中添加開發密鑰

<meta-data  
android:name="com.thinkland.juheapi.openid" 

        android:value="開發者OpenID" /> 
注意：
a. android:name中name的屬性值不能修改，直接復制即可，修改后無法通過驗證
b. android:value中value的屬性“開發者OpenID”請在聚合會員中心查看

2、添加所需權限

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />  
<uses-permission android:name="android.permission.INTERNET" />  
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />  
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION " />  
<uses-permission android:name="android.permission.READ_PHONE_STATE" />  

如下圖所示：

④：在調用接口之前需要初始化聚合數據SDK,只需要初始化一次即可。需要在Application中調用初始化方法

import com.thinkland.sdk.android.SDKInitializer; 
import android.app.Application;

public class MyApplication extends Application { 
    @Override 
    public void onCreate() { 
        // TODO Auto-generated method stub 
        super.onCreate(); 
        SDKInitializer.initialize(getApplicationContext()); 
    }

}

四、查找調用接口的參數值

在聚合數據API官網上http://www.juhe.cn/docs查看接口，并得到調用接口必須的字段：API， APIID， Method，以及需要設置的參數調用對應接口。
例：生活常用 -> IP地址 -> 根據IP/域名查詢地址 (前提：已經在聚合平臺申請了該數據服務)

api,api_id,method的獲取如下圖所示：

Param的獲取方法：

五、獲取數據

Parameters params = new Parameters(); 
params.add("ip", "www.juhe.cn"); 
params.add("dtype", "xml"); 
JuheData.executeWithAPI(數據ID, "http://apis.juhe.cn/ip/ip2addr", JuheData.GET, params, new DataCallBack() { 
@Override 
public void resultLoaded(int err, String reason, String result) { 
    // TODO Auto-generated method stub 
    if (err == 0) { 
        tv.setText(result); 
    } else { 
        Toast.makeText(getApplicationContext(), reason, Toast.LENGTH_SHORT).show(); 
        } 
} 
});

*詳細文檔及其他數據說明請通過 http://www.juhe.cn/docs 查閱。

六、返回數據示例

{
"resultcode":"200",
"reason":"Return Successd!",
"result":{
"area":"江蘇省蘇州市",
"location":"電信"
}
}