Alipay JSSDK V3.1.1

ap.getLocation(OPTION, CALLBACK)

获取当前的地理位置信息。

OPTION 参数说明

名称类型必填描述
cacheTimeoutNumber钱包经纬度定位缓存过期时间,单位秒。默认 30s。使用缓存会加快定位速度,缓存过期会重新定位
typeNumber支持 0:详细逆地理编码,带周边信;1:逆地理编码到城市;2:仅获取经纬度、速度和精度。默认为 2
timeoutNumber定位超时失败回调时间,单位秒。默认10s
bizTypeString自定义业务类型

CALLBACK 参数说明

  • 当 type 为 0 时,会返回下面全部字段。
名称类型描述
longitudeString经度
latitudeString纬度
accuracyNumber精度,单位米
speedNumber速度,单位毫秒
countryString国家名
countryCodestring国家编号
provinceString省份名
cityString城市名
cityCodeString城市编码
adCodeString区域编码
streetNumberObject街道门牌信息,结构是:{street, number}
poisObject Array定位点附近的 POI 信息,结构是:{name, address}

错误码说明

error描述
12GPS打开,但定位失败
13获取地理位置信息失
14定位超时
15网络错误
16GPS未打开或用户未授权

代码示例

<script src="https://gw.alipayobjects.com/as/g/h5-lib/alipayjsapi/3.1.1/alipayjsapi.inc.min.js"></script>

<style>
.output{ display:block; max-width: 100%; overflow: auto}
</style>
<button id="J_btn_location" class="btn btn-default">获取当前位置信息</button>
<pre id="J_output" class="output"></pre>
<script>
  var btnLocation = document.querySelector('#J_btn_location');
  var output = document.querySelector('#J_output');
  btnLocation.addEventListener('click', function(){
    ap.getLocation(function(res) {
      output.innerHTML = JSON.stringify(res, undefined, '  ');
    });
  });
</script>

其他说明

  • ap.getLocation使用的是高德坐标系,关于高德坐标系及与其他地图坐标系差异详见这里