聚合数据Android SDK 快递查询演示示例

1.到libs聚合SDK是聚合数据平台,为移动开发者提供的免费数据接口.使用前请先到聚合平台(http://www.juhe.cn/)注册,申请相关数据.

2.下载聚合数据SDK,将开发包里的juhe_sdk_v_1_1.jar拷贝到libs根目录下，将libJuheSDK_v_1_0.so拷贝到libs\armeabi目录下,如图:

3.根据接口说明文档找到以下方法:

/**
	 * 常用快递查询API
	 * 
	 * @param com
	 *            需要查询的快递公司编号
	 * @param no
	 *            需要查询的订单号
	 * @param jsonCallBack
	 */
	public void search(String com, String no, JsonCallBack jsonCallBack)

/**
	 * 快递公司编号对照表
	 * 
	 * @param jsonCallBack
	 */
	public void company(JsonCallBack jsonCallBack)

4.程序中调用方法

首先,在AnroidManifest.xml中添加权限

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

在application标签内部加入你申请的openid

    <meta-data
            android:name="com.thinkland.juheapi.openid"
            android:value="申请的openid" />

在使用前需要调用一次初始化方法

    CommonFun.initialize(getApplicationContext());

导入相关包

import com.thinkland.juheapi.common.CommonFun;
import com.thinkland.juheapi.common.JsonCallBack;
import com.thinkland.juheapi.data.exp.ExpData;

调用方法

// 常用快递查询
		ExpData expData = ExpData.getInstance();
		expData.search("sf", "575677355677", new JsonCallBack() {

			@Override
			public void jsonLoaded(JSONObject arg0) {
				// TODO Auto-generated method stub
				try {
					int code = arg0.getInt("resultcode");
					if (code == 200) {
						JSONObject resultJson = arg0.getJSONObject("result");
					}
				} catch (JSONException e) {
					// TODO Auto-generated catch block
					e.printStackTrace();
				}
			}
		});

5.返回字段及相关错误码

public void search(String com, Stringno, JsonCallBackjsonCallBack)

返回字段:

名称			类型	说明
error_code			int	错误码
resultcode			int	返回码
reason			string	返回说明
result			dictionary	返回结果
	company		string	快递公司名称
	com		string	快递公司编号
	no		string	订单号
	list		array	物流跟踪
		datetime	string	时间
		remark	string	描述
		zone	string	区域

public voidcompany(JsonCallBack jsonCallBack)

返回字段:

名称		类型	说明
error_code		int	错误码
resultcode		int	返回码
reason		string	返回说明
result		dictionary	返回结果
	com	string	快递公司编号
	no	string	订单号

错误码	说明
204301	未被识别的快递公司
204302	请填写正确的运单号
204303	加载类库失败
204304	查询失败