GPS LBS定位接口(GPS)

1.接口描述

小程序可以通过该接口调用客户端GPS定位服务,获取当前位置的经纬度信息。

2.调用命令

2.1 命令格式

http://cmbls/gps?id=XXX&usecache=XXX&maptype=XXX

2.2 字段定义

字段说明
id功能标识,每个id对应一个特定的命令。
maptype

地图类型: bd 表示使用百度地图定位,gd表示使用高德地图定位。默认值为bd

usecache

是否需要使用缓存

true:表示使用缓存

false:表示不适用缓存,进行实时定位

缓存在启动时获取,之后每隔60S更新一次,缓存数据返回快,无需等待,但数据实时性较差;如果对数据实时性要求高,可采用实时定位,但须等待一定时间。如果此参数没有配置,默认为true


3.回调函数

小程序可以通过回调接口来获取App返回给小程序的结果,GPS接口回调函数如下所示,具体使用方法请参考新手指南使用范例。

3.1  成功回调函数

CMBLS.gps.successCallback(id,message)

其中:message的值为:

<Data>
    <latitude>纬度</latitude>
    <longitude>经度</longitude>
    <locationstate>定位状态码</locationstate>
    <locationtime>时间戳</locationtime>//7.2开始支持,表示获取到经纬度的时间
    <maptype>地图类型</maptype> //7.2开始支持,表示使用的地图类型
    <address>
      <name>地名</name>
      <province>省</province>
      <city>市</city>
      <subcity>区/县</subcity>
      <street>街道</street>
   </address>
</Data>


3.2 失败回调函数

CMBLS.gps.failCallback(id,message)

其中:

失败时,message的值为:


<Data>
  <stateCode>非0状态码</stateCode>//
  <locationstate>定位状态码</locationstate>
  <description>描述信息</description>
  <maptype>地图类型</maptype> //7.2开始支持
</Data>




4.调用示例

http://cmbls/gps?id=15

5.备注



stateCode
描述
100表示用户首次拒绝调用(这种情况不要调用敏感信息授权接口,否则用户会看到两次授权弹框提示)
101
示用户曾经拒绝过调用该接口,需要调用敏感信息授权接口Permission重新授权后才可以再次调用。