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)
返回字段:
名称 |
|
| 类型 | 说明 |
|
|
| int | |
resultcode |
|
| int | 返回码 |
reason |
|
| string | 返回说明 |
result |
|
| dictionary | 返回结果 |
| |
| string | |
| |
| string | 快递公司编号 |
| |
| string | 订单号 |
| |
| array | 物流跟踪 |
|
| | string | |
|
| | string | |
|
| | string | |
public voidcompany(JsonCallBack jsonCallBack)
返回字段:
名称 |
| 类型 | 说明 |
|
| int | |
resultcode |
| int | 返回码 |
reason |
| string | 返回说明 |
result |
| dictionary | 返回结果 |
| | string | 快递公司编号 |
| | string | 订单号 |
错误码 | 说明 |
204301 | 未被识别的快递公司 |
204302 | 请填写正确的运单号 |
204303 | 加载类库失败 |
204304 | 查询失败 |