聚合数据简易开发流程

聚合数据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":"电信"
}
}