问北位置开放平台
  1. Android接入
问北位置开放平台
  • 概述
  • 易测SDK
    • 概述
    • 接入前准备
    • 企业认证与创建应用
      • 企业注册与认证
      • 创建应用及获取秘钥
    • 易测终端购买与激活
      • 易测终端购买
      • 易测终端激活
    • 技术支持
    • Android接入
      • 必读
      • 安装
      • 更新日志
      • SDK使用-易测终端
      • SDK使用-手机高精度
    • 微信小程序SDK
      • Readme
  • 平台API
    • 接入前必读
    • 1、认证接口
      • 1.1、获取应用token
      • 1.2、获取sdkToken
  1. Android接入

SDK使用-易测终端

请向问北平台申请key和secret#

使用SDK时需要获取sdkToken, sdkToken获取方法见文档 1.2、获取sdkToken
secret 不应该放在客户端,应该放在服务端
如有问题,请查看Demo

Demo#

示例:MainActivity
本地运行Demo需要在 com.esurvey.esurvey_sdk.utils.Api 里面 填写自己申请的key 和 secret

实例化ESurvey对象#

class MainActivity : ComponentActivity() {
    val instance = ESurvey.getInstance()
    ...
}

设置key (v1.5新增)#

全局设置一次即可, 请在App初始化中传入,可在Application或者主Activity中Oncreate方法传入。Key值请向问北位置平台申请, 使用SDK前必须传入key

运行时权限请求#

添加授权监听器#

isAuthentication 认证是否通过,如果为false, 请提示用户认证失败,在失败的情况下,天线将不会吐定位数据

添加位置改变监听器#

LocationState对象解析#

参数名解析备注
lon经度
lat纬度
height高程
yInaccuracies高程误差
xInaccuracies水平误差
locationShow格式化后的经纬度显示,保留7位小数后拼在了一起String.format("%.7f", lat) + " , " + String.format("%.7f", lon)
pdoppdop
satelliteNum解算卫星数量
locationStatus定位状态1: 单点解 2: 伪距差分 4: 固定解 5: 浮点解 6:组合定位
locationStatusShow解析后的定位状态,返回中文如:固定解
source数据来源1: 外接天线 2: 手机自带Rtk
antennaDataSource天线数据来源1: Type-c 2: 蓝牙
isNetworkDiffSync网络查分数据是否参与了解算true: 参与了解算 false: 未参与解算-数据仅来源FM
ggaggagga原始数据
nrtk014天线原始数据天线原始数据

添加天线启动/断开监听器#

连接启动#

source 消息据来源 1: Type-c 2: 蓝牙 比如如果source=Constant.ANTENNA_SOURCE_BLUETOOTH(2)表示是蓝牙连接/启动成功或失败
isConnectSuccess 是否连接成功
isStartSuccess 是否启动成功
message 提示信息

断联#

disConnectSource 表示是哪种方式断联

TypeC 方式#

添加 usb 挂载监听器#

isAttach: 是否监听到Type-C挂载

连接启动天线 (V1.5版本有更新,新增了两个参数)#

context
lon 经度
lat 纬度
autoBluetoothFlag 是否自动连接蓝牙 如果传true, SDK将在Usb模式启动完成后自动连接蓝牙
hostAppUserId: 用户在贵司平台的UserId(宿主App的UserId)
sdkToken: APP登录用户调用问北相关接口的临时凭证,sdkToken获取方法见文档 1.2、获取sdkToken

蓝牙方式#

注: 蓝牙使用 RxBLE库 不再使用AndroidBLE依赖 (0.95版本修改)
使用蓝牙前,需要先提示用户打开蓝牙

自动连接#

usb方式启动时候,autoBluetoothFlag 为 true 可自动连接蓝牙

主动连接#

1.
搜索蓝牙, 将搜索到的设备保存起来,用于显示 蓝牙会默认搜索5秒
BluetoothInfo-> name: 蓝牙名称, address: 地址
建议展示蓝牙列表前先用名称过滤
2.
主动停止蓝牙搜索
instance.stopBluetoothScan()
3.
蓝牙连接 (V1.5版本有更新,新增了两个参数)
context
bluetoothInfo: 搜索到的蓝牙设备
lon
lat
hostAppUserId: 用户在贵司平台的UserId(宿主App的UserId)
sdkToken: APP登录用户调用问北相关接口的临时凭证,sdkToken获取方法见文档 1.2、获取sdkToken
4.
也可以使用蓝牙名称进行连接
bluetoothName 蓝牙名称
5.
在天线启动/断开监听器中查看连接状态

激光测距#

测距使能#

必须使能成功后才可使用测距功能

测距#

isSuccess 测量是否成功
distance 测量值,单位毫米

停止测距#

退出测距功能时,需要调用此方法,否则天线会耗电很快

设备OTA(1.7版本新增)#

连接设备后,会自动检测是否需要更新

获取更新进度 注册setOnAntennaOtaListener 回调#

  instance.setOnAntennaOtaListener(object: ESAntennaOtaListener {
                override fun onStart() {
                    // 开始进行更新
                    isOta = true
                    deviceInfo = instance.deviceInfo
                }

                override fun onEnd(isSuccess: Boolean, message: String) {
                    // 结束更新
                    isOta = false
                    ToastUtils.showLong(message)
                }

                override fun onProgress(percent: Int) {
                    // 更新进度
                    otaPercent = percent
                }

            })
修改于 2025-01-02 03:09:33
上一页
更新日志
下一页
SDK使用-手机高精度
Built with