GPS点串上报

初始化SDK

在调用GPS点串SDK的其他方法之前，请先调用下面的方法初始化SDK，比如在App.onCreate()或者MainActivity的onCreate()等时机。

final IDMapCommonInfoDelegate dMapCommonInfoDelegate = new IDMapCommonInfoDelegate() {
    @Override
    public String getPhone() {
        return "";
    }

    @Override
    public String getUid() {
        return "";
    }

    @Override
    public String getToken() {
        return "";
    }

    @Override
    public long getCityId() {
        return 0;
    }

    @Override
    public long getCountryId() {
        return 0;
    }
};
DMapTrackClient.getDefaultClient().init(applicationContext, dMapCommonInfoDelegate);

实现GPS点串协议代理方法

实现GPS点串协议代理方法，提供必要的业务数据。

//实现GPS点串协议代理方法，在GPS点串采集时提供必要的业务信息。
DMapTrackClient.getDefaultClient().setTrackDataDelegate(new IDMapTrackDataDelegate() {
    @Override
    public DMapTrackData getTrackData() {
        return new DMapTrackData.Builder()
                //orderSource为THIRD_PARTY时必填，仅支持内容为数字的字符串。
                //生成规则：String.valueOf(longUid & 0x7fffffffffffL)，其中longUid为第三方的数字uid
                .thirdPartyUid("第三方用户id") 
                //orderSource为THIRD_PARTY时必填，仅支持内容为数字的字符串
                //生成规则：String.valueOf(longOid)，其中longOid为第三方的数字oid
                .thirdPartyOid("第三方订单id") 
                //选填
                .openUid("滴图开放平台用户id") 
                //orderSource为DIDI时必填
                .openOid("滴图开放平台订单id") 
                //必填，根据当前订单来源，设置是滴图订单还是三方订单
                .orderSource(DMapTrackData.OrderSource.DIDI) 
                //用户角色，派单必填，其它选填
                .role(DMapTrackData.Role.DRIVER) 
                //业务状态，派单必填，其它选填
                .bizStatus(DMapTrackData.BizStatus.ONTRIP) 
                .build();
    }
});

启动GPS点串上报

final int result = DMapTrackClient.getDefaultClient().start();
final Context context = getApplicationContext();
if (result == DMapTrackError.ERROR_OK) {
	//启动GPS点串上报成功
} else {
	//启动GPS点串上报失败，详见错误码
}

GPS点串采集&上报频率

GPS点串上报SDK默认的采集频率和上报频率是3s，可以通过下面的方法修改采集频率和上报频率。

DMapTrackClient.getDefaultClient().setTrackOptions(DMapTrackGatherIntervalMode.NORMAL, DMapTrackUploadIntervalMode.NORMAL);

GPS点串存储周期

GPS点串上报至滴图服务端后，GPS点串数据将在服务端存储1个月时间。

停止GPS点串上报

final int result = DMapTrackClient.getDefaultClient().stop();
final Context context = getApplicationContext();
if (result == DMapTrackError.ERROR_OK) {
    //停止GPS点串上报成功
} else {
    //停止GPS点串上报失败，详见错误码
}