该部分为旧版H5辅助定位说明,使用定位SDK v3.7.0以及之前版本的开发者请参考该部分说明,同时建议尽快更新至最新版SDK的H5辅助定位。辅助 H5 页面定位功能服务于集成高德定位 SDK 以及使用高德 Javascript-Api 实现 H5 页面的 App,当页面需要使用位置时可以选择使用定位 SDK 辅助提供位置信息。
第 1 步,准备工作
第 2 步,开启辅助定位
调用如下方法开启 SDK 辅助H5定位功能:
mLocationClient.startAssistantLocation();
Javascript代码参考:
mapObj = new AMap.Map('iCenter');
mapObj.plugin('AMap.Geolocation', function () {
geolocation = new AMap.Geolocation({
useNative: true,//是否使用高德定位sdk用来辅助优化定位效果,默认:false
...//其余设置项请参考AMap.Geolocation 插件内容
});
mapObj.addControl(geolocation);
AMap.event.addListener(geolocation, 'complete', onComplete);//返回定位信息
AMap.event.addListener(geolocation, 'error', onError); //返回定位出错信息
});
第 3 步,获取定位数据
请您参考AMap.Geolocation 插件章节的 GeolocationResult 对象 表格说明。
最后一步,结束定位
当您使用完辅助 H5 页面定位功能时,请及时停止该功能,避免不必要的设备能耗开销。
调用如下方法停止 SDK 辅助H5定位功能:
mLocationClient.stopAssistantLocation();
您也可以进一步停止和销毁掉第一步中实例化的定位客户端,请您参考销毁定位客户端。