前言

本手册旨在指导开发者快速对接位置服务SDK ，实现终端位置数据的上报功能。 在使用SDK过程中，以下参数和格式为核心必填项，直接影响数据上报的有效性，开发者需重点关注并确保配置正确：

一、核心必填参数

SDK的所有功能依赖于以下基础参数 ：

1. appId与appSecret：由图创官方分配的应用标识与密钥，用于接口身份验证，二者缺失或错误将导致上报失败。
2. deviceId：由图创指定的设备唯一标识，用于关联终端所属的设备主体，不可随意修改。

二、locationString格式规范

locationString是位置数据的核心载体，其格式直接决定了服务端能否正确解析终端的位置信息， 必须严格遵循以下格式：

deviceId,terminalId,locationType,longitude,latitude,altitude,speed,direction,timestamp,createTime  

各字段说明如下：

• deviceId：与客户端配置的deviceId一致，不可为空；
• terminalId：上报位置的终端唯一标识（如设备编号、用户ID等），需自行定义且唯一；
• locationType：固定值为GPS，标识位置来源类型；
• longitude/latitude：终端的经纬度（精确到小数点后6位），例如116.404000、39.915000；
• altitude/speed/direction：如果无值就传0.000000 ；
• timestamp ：时间戳（终端上报时间）
• createTime：时间戳（毫秒级），创建时间（第三方服务端上报图创的时间）。

若locationString格式错误（如字段缺失、分隔符错误、数值格式不符等），服务端将无法解析数据，导致上报失败。

互联网测试环境地址

http上报测试地址：wuhan.gishub.com.cn:4100 TCP上报测试地址：wuhan.gishub.com.cn:4103 808协议上报测试地址：wuhan.gishub.com.cn:4102