WebApp快捷打包
腾讯地理定位
转到模块插件

敬告:此 DEMO 演示为开放测试页面,仅用于开发者快速测试体验应用功能,请严格遵守开发者协议,了解更多

JS-SDK 引用方式:

♦ 普通网页 script 方式加载:下载最新版 jsBridge-v20241118.zip,请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库;

♦ js module 方式引用:npm install ym-jsbridge 具体请参考 npm package

♦ 腾讯位置服务 定位

getCurrentPosition 获取当前位置

$("#cnt").hide();
var result = $("#result").text("定位中...");    
$('html,body').animate({scrollTop: $('#view').offset().top}, 1200);

//发起定位单次定位(watch 为 false)
jsBridge.qqLoc.getCurrentPosition({
  //可选, 连续定位, 默认 false
  //调用 jsBridge.qqLoc.stop() 停止定位
  watch : false,
  //可选,连续定位时间间隔(秒),最低1秒,默认3
  watchInterval: 3,
  //可选,布尔类型, true = 不需要地址信息,默认 false (需要)
  //不需要地址信息时的定位速度更快,消耗更少的流量
  notAddress   : false,
  //可选,连续定位通知栏标题,默认为应用名称
  notifyTitle  : "",
  //可选,连续定位通知栏内容
  notifyContent: "持续定位中..."
}, function(succ, data) {
  //jsBridge.setClipboardText(JSON.stringify(data));
  result.JSONView({
    succ: succ,
    data: data
  });
});

//示例定位结果(模拟数据):
var sample = 
{
    //成功
    success: true,
    address: null,
    name: null,
    //室内定位时返回楼层
    floor: "1000",
    //室内定位时返回建筑ID
    buildingId: "",
    //纬度
    latitude: 30.542879,
    //经度
    longitude: 104.047229,
    //室外GPS定位时返回海拔高度
    altitude: 0,
    //室外GPS定位时返回速度
    speed: 0,
    //方向
    direction: -22.051645187045615,
    //地址
    country: "中国",
    province: "四川省",
    city: "成都市",
    district: "武侯区",
    town: "石羊场街道",
    village: "Unknown",
    street: "天府四街",
    streetNumber: "剑南大道1537号",
    //邮编
    cityCode: "510107",
    //电话区号
    cityPhoneCode: "028",
    bearing: 0,
    //精确度(米)
    accuracy: 40,
    //定位方式
    provider: "network",
    //周边信息
    poi: [
        {
            address: "四川省成都市武侯区剑南大道中段1537号",
            latitude: 30.543404,
            longitude: 104.047569,
            catalog: "房产小区:住宅区:住宅小区",
            name: "佳年华·时代晶座",
            uid: "13166346620311622068",
            distance: 0,
            direction: ""
        },
        {
            address: "四川省成都市武侯区利通时代晶座2幢",
            latitude: 30.542837,
            longitude: 104.047173,
            catalog: "房产小区:房产小区附属",
            name: "佳年华·时代晶座2栋",
            uid: "1306492289682442565",
            distance: 10.7,
            direction: ""
        },
        {
            address: "四川省成都市武侯区天府四街时代金座3栋1911",
            latitude: 30.542694,
            longitude: 104.046967,
            catalog: "公司企业:公司企业",
            name: "四川创客暖通工程有限公司",
            uid: "10882588705945394131",
            distance: 35.5,
            direction: ""
        },
        {
            address: "四川省成都市武侯区剑南大道与天府四街交叉口东北方向120米",
            latitude: 30.542688,
            longitude: 104.046967,
            catalog: "公司企业:公司企业",
            name: "成都灵动美绘科技有限公司",
            uid: "15341516959025700688",
            distance: 35.9,
            direction: ""
        },
        {
            address: "四川省成都市武侯区剑南大道中段1589号时代晶座(天府四街交汇处)",
            latitude: 30.542686,
            longitude: 104.046967,
            catalog: "医疗保健:专科医院:整形",
            name: "紫藤花语医美连锁(高新门诊部)",
            uid: "2915740464587222983",
            distance: 36.1,
            direction: ""
        }
    ]
}

getCurrentPosition 实时连续定位

1. watch 参数设为 true 即为实时连续定位,当用户位置发生变化时会收到回调通知;

2. Android 8 以上会在手机状态通知栏放置持续定位的前台服务通知,以降低应用被系统杀掉的概率;部分设备默认禁止了 APP 通知,可打包 本地通知 插件,调用 jsBridge.notification.requestAuth 检查是否开启了通知权限,如果没有通知权限可调用 jsBridge.appSettings() 引导用户开启权限;

3. Android 10 以上系统会申请后台定位权限(ACCESS_BACKGROUND_LOCATION),用户可选择 “始终允许” 或 “仅在使用该应用期间允许”;

4. Android 11 申请后台定位权限时不再出现 “始终允许” 选项,此时只能引导用户进入应用设置授予始终允许后台定位的权限;

5. 调用 jsBridge.appSettings() 可以打开应用设置;

var i = 0;
var cnt = $("#cnt").show().text("");
var result = $("#result").text("定位中...");    
$('html,body').animate({scrollTop: $('#view').offset().top}, 1200);

//发起定位,开启后请拿着手机走起来
//在室外开启GPS定位会更准确
jsBridge.qqLoc.getCurrentPosition({
  watch: true,
  watchInterval: 3,
  //不需要地址信息时的定位速度更快,消耗更少的流量
  notAddress   : true,
  notifyTitle  : "我的APP",
  notifyContent: "持续定位中..."
}, function(succ, data){
  cnt.text("第 " + (++i) + " 次位置回调: ");
  result.JSONView({
    succ: succ,
    data: data
  });
});

stop 停止定位

停止定位

//停止定位
jsBridge.qqLoc.stop();

定位结果 (position 回调参数):