敬告:此 DEMO 演示为开放测试页面,仅用于开发者快速测试体验应用功能,请严格遵守开发者协议,了解更多。
♦ JS-SDK 引用方式:
♦ 普通网页 script 方式加载:下载最新版 jsBridge-v20251019.zip,请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库;
♦ js module 方式引用:npm install ym-jsbridge 具体请参考 npm package
1. 详情请查看 官方说明
2. 接入步骤:
2.1 去 高德开放平台 创建 Android / iOS 应用,将 Key 配置到打包平台生成 APP;
2.2 去 高德开放平台 创建 Web服务,将获得的 Key 用于调用 服务器端接口;
2.3 调用服务器端接口创建 服务 和 终端 取得服务ID serviceId、终端ID terminalId;
2.4 用上一步取得的 serviceId、terminalId 调用APP端 jsBridge.amapTrack.startTrack 接口开启轨迹采集服务;
2.5 APP会把采集到的轨迹数据上传到高德平台,请调用 轨迹查询 接口获取轨迹数据(可用于可视化呈现,如展示在地图等);
• 如需接口调用事件,请设置此监听器;
jsBridge.amapTrack.setListener(function(event, res) {
//此函数仅用于显示回调参数在本 DEMO 页面上
showResult({event: event, res: res});
});
//请拉到页面底部查看回调数据信息
$('html,body').animate({ scrollTop: $('#view').offset().top }, 500);
/**
回调参数说明:
event - 事件代码,字符串类型,为 这里 的方法名称,如 onStartTrackCallback
res - 事件数据,JSON 对象
{
status : 0, //结果错误码
message: "" //结果描述
}
**/
//移除监听器,不会再收到回调通知 //在需要时可重新调用 setListener jsBridge.amapTrack.removeListener();
轨迹服务
//开启轨迹采集服务
jsBridge.amapTrack.startTrack({
//必须,数字类型,服务ID(请调用高德服务端接口 创建服务)
serviceId : 383478,
//必须,数字类型,终端ID(请调用高德服务端接口 创建终端)
terminalId: 386234337,
//可选,数字类型,轨迹ID(请调用高德服务端接口 创建轨迹),默认无(0)
//如果提供此参数则采集的位置点将关联到此轨迹
trackId : 0,
//可选,数字类型,轨迹点采集时间间隔(秒),1 - 60 秒之间,默认2秒
gatherInterval: 2,
//可选,数字类型,打包上传时间间隔(秒) , 单位为s, 范围为5倍采集时间 - 50倍采集时间,必须为采集时间的整数倍,默认20秒
packInterval : 20,
//可选,数字类型,定位模式,默认 1
//1 高精度定位模式:同时使用网络定位和GPS定位,优先返回精度高的定位
//2 仅设备定位模式:只使用GPS定位
//3 低功耗定位模式:只使用网络定位
locationMode : 1
}, function(succ, data) {
alert(succ + "\n" + JSON.stringify(data));
});
//停止轨迹采集服务
jsBridge.amapTrack.stopTrack(function(succ, data) {
if (!succ) {
alert(JSON.stringify(data));
}
});
监听回调数据: