开放平台
- 新手介绍
- 应用接入
- API接口说明
定制平台
- Web定制服务
- 客户端定制
概述:
中国位置"应用平台是为自有品牌以及第三方品牌硬件提供软件服务配套支撑的云开放平台。
- 介绍说明
- 常见问题
具体步骤:
1、注册用户:
1)打开访问地址:http://lbs.capcare.com.cn/,用户输入手机号和密码进行用户注册。
2)用户也可以通过直接扫描下方二维码
或者通过各大应用程序市场,搜索“凯步关爱”进行下载凯步关爱app客户端,安装完成后,进行用户注册。
2、捆绑设备:
输入15位的产品IMEI码,添加设备。
PC端添加设备:
app端添加设备:
3、开发应用:
通过HTTP请求,调用相应接口,开发定制属于自己的位置服务应用。
1.怎样成为一个开发者?
答:在中国位置门户网站上进行注册、然后登录、捆绑设备即可成为一名开发者。
2请问个人用户申请和公司申请的流程有什么不同吗?
答:所有开发者和网站主申请流程是一致的,只有在提交资质时有差别。
概述
支持常连接模式,实现信息服务端Push功能。支持Get,Post方式,支持一条request获取多条协议的内容。Request和Response具有统一的格式与规则,满足良好的扩展性和兼容性。
- 介绍说明
- 常见问题
Open API技术标准与要求:
支持常连接模式,实现信息服务端Push功能。
支持Get,Post方式,支持一条request获取多条协议的内容。
Request和Response具有统一的格式与规则,满足良好的扩展性和兼容性。
Open API开放接口
终端接入接口:
位置服务网页平台和手机端软件需要接入导航定位设备的定位数据。这些导航定位设备终端可以是开通定位功能的手机,也可是基于GPS 和北斗系统的定位导航设备。
平台可以支持第三方品牌设备和自有品牌硬件。
平台服务可根据硬件设备差异性和需求实现平台服务功能定制化。
平台服务可根据硬件设备差异性和需求实现平台服务功能定制化。
位置服务类接口:
提供全方位的优质位置服务端口,包括查询设备当前位置、轨迹查询、轨迹回放等位置服务功能。
设备管理接口:
主要用于设备管理维护,包括设置设备头像、绑定/解绑/更新设备、获取单个设备信息、获取所有设备状态、获取所有设备列表等。
围栏告警接口:
提供电子围栏、告警功能。主要包括设置/更新某个设备的围栏信息、向围栏里面添加/删除设备、获取单个设备的所有警告信息、删除警报信息等。
1.如果App key丢失怎么办?
您可以在应用管理后台查询到。
2.请问App key的有效期是多长时间?
应用开发者在申请应用之后,如90天内没有用户使用,中国位置应用开放平台有权利停止该应用接口使用权限并删除该应用。
3.应用类型变更的问题。如果应用已经在使用,想改变应用类型怎么办?
应用分类无法变更,请开发者慎重选择。
概述
平台采用插线板开放式架构,为个体、微型公司、中型公司、大型企业、政务管理以及个人提供位置服务应用接口。
- OPEN API协议
- 常见问题
1.注册OPEN API协议下载
名称 | 类型 | 备注 |
cmd | int | 2012 /register.app.do |
type | int | 注册的类型1:手机号 |
name | string | 手机号 |
pwd | string | 原始密码一次md5加密 |
app_name | string | appname |
verify_no | string | 手机验证码(手机注册需先请求下面2.获取手机注册码接口,非手机注册可为空) |
ios_device_token | string | iosToken |
返回数据 | ||
ret | int | 返回结果:1成功,2失败 |
desc | string | 登录结果描述 |
token | string | 执行成功后返回用户登录凭证 |
user_id | string | 执行成功后返回用户编号 |
2.登陆
名称 | 类型 | 备注 |
cmd | int | 2003 logon.do |
username | string | 登录名 |
ts | long | 时间戳 |
ios_device_token | string | iosToken |
app_name | string | 区分业务标志 |
app_version | string | 客户端版本号 |
pwd | string | MD5(原始密码二次MD5+时间戳) |
返回数据 | ||
ret | int | 返回结果:1成功,2失败,3用户不存在,9 token过期 |
desc | string | 登录结果描述 |
token | string | 执行成功后返回用户登录凭证 |
user_id | string | 执行成功后返回用户编号 |
binding | string | 0为未绑定,1为已绑定 |
3.修改密码
名称 | 类型 | 备注 |
cmd | int | 2004 /update.pwd.do |
user_id | string | 用户id |
password | string | 用户旧密码(两次md5加密,和登录时密码逻辑相同) |
ts | long | 时间戳 与登陆逻辑一样 |
new_password | string | 用户新密码(一次md5加密既可,和注册时密码逻辑相同) |
返回数据 | ||
ret | int | 返回结果:1成功,2失败 |
desc | string | 登录结果描述 |
token | string | 执行成功后返回用户登录凭证 |
user_id | string | 执行成功后返回用户编号 |
4.绑定/解绑/更新设备
名称 | 类型 | 备注 |
cmd | int | 2101 /device.edit.do |
operate | int | 绑定:1 解绑:2 更新:3 初始化:4 重启:5 |
user_id | string | 用户id |
device_sn | string | 设备序列号 |
name | string | 设备名称 |
phone | string | 设备电话号码(必填) |
icon | byte | (可选)头像(见16) |
car | string | (可选)车牌号 |
height | int | (可选)身高(单位厘米) |
weight | int | (可选)体重(克) |
gender | int | (可选)性别:男1; 女2 |
age | int | (可选)年龄 |
tick | int | (指令)上传位置频率(60s一次) |
moveSwitch | int | (指令)移动报警开关:1开; 2关 |
speedingSwitch | int | (指令)超速报警开关:1开; 2关 |
fenceSwitch | int | (指令)围栏报警开关:1开; 2关 |
speedThreshold | int | (指令)超速报警阈值(单位km/h) |
flow | float | (指令)流量报警阈值 |
battery | int | (指令)电量报警阈值 |
sos | string | Sos电话 |
target_id | string | 下级用户id |
app_name | string | 区分业务标识 |
birth | string | 生日 |
dog_figure | string | 体型 |
dog_breed | string | 种类 |
contact | string | 短信告警电话 |
sms_alarm | string | 短信告警开关 |
car_brand | string | 车辆品牌 |
car_model | string | 车辆型号 |
返回数据 | ||
ret | int | 返回结果:1成功, 2失败 3已有设备 |
operate | int | 操作类型,同上面的operate |
device_sn | string | 设备序列号 |
desc | string | 结果描述 |
device | obj | 设备信息 |
5.获取单个设备信息
名称 | 类型 | 备注 |
cmd | int | 2102 /device.get.do |
user_id | string | 用户id |
device_sn | string | 设备序列号 |
返回数据 | ||
ret | int | 返回结果:1成功,2失败 |
desc | string | 结果描述 |
device | obj | 内容参照设备信息 |
6.获取所有设备列表
名称 | 类型 | 备注 |
cmd | int | 2103 /device.list.do |
user_id | string | 用户id |
target_id | string | 下属用户id |
app_name | string | 区分业务 |
page_number | string | 页码 |
page_size | string | 一页显示数目 |
返回数据 | ||
ret | int | 返回结果:1成功,2失败 |
desc | string | 结果描述 |
devices | array | 内容参照设备信息1.10 |
7.轨迹回放信息
名称 | 类型 | 备注 |
cmd | int | 2401 /get.track.do |
user_id | string | 用户id |
target_id | string | 下属id |
device_sn | string | 设备序列号 |
begin | long | 时间起始点 |
end | long | 时间结束点 |
part | string | 可先字段,Y为分段,同CMD=24 |
page_number | string | 页码 |
page_size | string | 页数 |
app_name | string | 区分业务类型 |
返回数据 | ||
ret | int | 返回结果:1成功,2失败 |
desc | string | 结果描述 |
track | array | 内容参照Spot轨迹点 |
8. 获取所有警告信息
名称 | 类型 | 备注 |
cmd | int | 2203 /alarm.all.do |
user_id | string | 用户id |
target_id | string | 下属id |
app_name | string | 区分业务类型 |
begin | long | 开始时间 -1:表示从最远的时间开始 |
返回数据 | ||
ret | int | 返回结果:1成功,2失败 |
desc | string | 结果描述 |
alarms | array | 内容参照设备信息1.2 |
1.都有哪些接口?
终端接入接口、位置服务类接口、设备管理接口、围栏告警接口
2.怎样开发测试?
通过HTTP请求,调用相应的位置服务接口(注:每次调用都需要传入应用token),开发定制属于自己的位置服务应用
WEB定制介绍:
WEB定制平台服务:使用“大众位置服务”的基础上为企业打造自有品牌位置服务平台,统一企业形象,帮助树立企业品牌与位置平台。可以根据企业需求,定制企业专属位置服务平台。拥有完整的从注册、登陆、设备捆绑、追踪、轨迹、报警、设备等功能。还可以为企业、用户定制开发独特的功能。
- 定制说明
客户端定制介绍:
可根据企业需求,定制企业专属的位置服务平台,平台覆盖移动手机客户端包括:IOS苹果手机与安卓手机,两大移动手机操作系统。
手机定制客户端服务:使用“凯步关爱”安卓与IOS苹果手机客户端的基础上为企业打造自有品牌位置手机客户端,统一企业形象,帮助树立企业品牌与位置平台。可以根据企业需求,定制企业专属位置服务平台。
- 定制说明
拥有企业专属域名链接;
定制企业logo和皮肤
用户管理功能包括:注册功能、登录功能、忘记密码、设备捆绑
定位追踪功能包括:实时追踪、3个月的轨迹回放、
报警提示功能包括:超速、断电、电子围栏等功能
独立的KEY申请与上线