聚合數據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":"電信"
}
}