简介
cordova-plugin-baidugeolocation 是一个基于百度地图定位 SDK 的 Cordova 插件,它提供了一套简单易用的定位接口,能够让开发者轻易地在移动应用中使用百度地图进行定位服务。
安装
使用 npm 进行安装:
npm install cordova-plugin-baidugeolocation
或直接从 GitHub 下载插件,然后通过以下命令进行安装:
cordova plugin add /path/to/cordova-plugin-baidugeolocation
使用
初始化插件
在 deviceready
事件触发后,调用 BaiduGeolocation.init()
进行插件初始化,以便于后面调用其他方法。
document.addEventListener('deviceready', function() { BaiduGeolocation.init(); }, false);
获取当前位置
调用 BaiduGeolocation.getCurrentPosition(successFn, errorFn, options)
方法可获取当前位置的经纬度信息。其中 options
对象参数可选,其默认值为:
{ enableHighAccuracy: true, // 是否启用高精度 timeout: 10000, // 超时时间(毫秒) maximumAge: 0, // 缓存时间(毫秒),0 表示不使用缓存 coor: 'bd09ll' // 坐标系类型(bd09ll 表示百度坐标系) }
示例代码如下:
-- -------------------- ---- ------- ------------------------------------ ------------------ - -- ------ ----------------- - -------------------- ----------------- - ------------------- -- --------------- - -- ------ --------------------- -- - -------- ---- -- ---------- - - - --
successFn
函数将传入一个包含经纬度等信息的对象参数,该对象的属性与 Position 对象 保持一致。
监听位置变化
调用 BaiduGeolocation.watchPosition(successFn, errorFn, options)
方法可监听位置变化事件,该方法将返回一个用于 clearWatch
取消监听的 ID。
调用 clearWatch(watchID)
方法可取消监听。
-- -------------------- ---- ------- --- ------- - ------------------------------- ------------------ - -- ------ ----------------- - -------------------- ----------------- - ------------------- -- --------------- - -- ------ --------------------- - -- ------------------------------------- -- ----
示例代码
以下代码演示了如何在 Cordova 应用中使用该插件获取当前位置,并在地图上显示:
-- -------------------- ---- ------- --------- ----- ------ ------ ----- --------------- -- ----------------------- ------------ ------- ------ ---- --------------- ------- -------------------------- -------- ---------------------------------------- ---------- - ------------------------ ------------------------------------ ------------------ - --- --------- - ------------------- --- -------- - ------------------ --- --- - --- ---------------- --- ----- - --- --------------------- ---------- ------------------------ ---- --- ------ - --- ------------------- ----------------------- -- --------------- - --------------------- - -- -- ------- --------- ------- ------------------------------------------------------------- ------- -------
将 YOUR_APP_KEY
替换为你在百度地图开放平台上申请的应用 AK。可以在终端中使用以下命令获取当前位置的 AK(需要先安装 jq ):
curl -s -X GET 'http://api.map.baidu.com/lbsapi/getpoint/index.html' \ | grep AK \ | sed 's/.*AK=\([^"]*\).*/\1/'
总结
cordova-plugin-baidugeolocation 为 Cordova 应用提供了基于百度地图定位 SDK 的简单易用的定位接口,开发者可以方便地使用该插件实现定位服务的功能,并在百度地图上直观地展示定位信息。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60056bda81e8991b448e583b