GPS点串上报

初始化定位

在调用GPS点串SDK接口之前，请务必先初始化定位SDK，具体请参考《Android 定位SDK》开发指南。

//在使用DMapLocationClient、DMapTrackClient之前调用，比如App.onCreate的时机
final DMapLocationConfig config = new DMapLocationConfig.Builder()
        .scene(DMapLocationConfig.Scene.DRIVER) //设置为司机定位场景
        .build();
DMapLocationManager.getInstance().init(context.getApplicationContext(), config);

实现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默认的GPS点串上报频率是3s，3s上报一次GPS点串信息。

GPS点串存储周期

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

停止GPS点串上报

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