聚合数据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:"android.permission.ACCESS_NETWORK_STATE"/>
"android.permission.INTERNET"/>
"android.permission.ACCESS_WIFI_STATE"/>
"android.permission.ACCESS_COARSE_LOCATION "/>
"android.permission.READ_PHONE_STATE"/>

如下图所示：

importcom.thinkland.sdk.android.SDKInitializer;
importandroid.app.Application;

publicclassMyApplicationextendsApplication {
@Override
publicvoidonCreate() {
//TODOAuto-generated method stub
super.onCreate();
SDKInitializer.initialize(getApplicationContext());
}

}

四、查找调用接口的参数值

在聚合数据API官网上http://www.juhe.cn/docs查看接口，并得到调用接口必须的字段：API， APIID， Method，以及需要设置的参数调用对应接口。
例：生活常用 -> IP地址 -> 根据IP/域名查询地址(前提：已经在聚合平台申请了该数据服务)

api,api_id,method的获取如下图所示：

五、获取数据

Parametersparams=newParameters();
params.add("ip","www.juhe.cn");
params.add("dtype","xml");
JuheData.executeWithAPI(数据ID,"http://apis.juhe.cn/ip/ip2addr",JuheData.GET,params,newDataCallBack(){
@Override
publicvoidresultLoaded(interr,Stringreason,Stringresult){
//TODOAuto-generatedmethodstub
if(err==0){
tv.setText(result);
}else{
Toast.makeText(getApplicationContext(),reason,Toast.LENGTH_SHORT).show();
}
}
});

*详细文档及其他数据说明请通过 http://www.juhe.cn/docs 查阅。

六、返回数据示例

{
"resultcode":"200","reason":"ReturnSuccessd!","result":{
"area":"江苏省苏州市","location":"电信"
}
}