汽车在线开放平台API文档

接口说明

(1) 长度单位是字节。
(2) 信息内容若为json格式，必须采用UTF-8编码。
参见: http://en.wikipedia.org/wiki/UTF-8
(3) 信息内容中含有时间字段的，字段值为UTC毫秒数。
参见：http://en.wikipedia.org/wiki/UTC
(4) 关于参数mapType(地图类型)的值的说明。

需要的校准方式 mapType值 备注
Google校准 G_NORMAL_MAP 用于需要google校准的地方
百度校准 BAIDU 用于需要百度校准的地方
不需要校准   不需要传值

登录

请求参数

参数 类型 必选 说明
version number true 版本:0
method string true 方法:loginSystem
userName string true 用户输入的账号(UTF-8编码)
pwd string true 用户输入的密码

HTTP请求例子：http://api.gpsoo.net/MobileServlet?method=loginSystem&version=0&userName=ad&pwd=8888

服务器响应

参数 类型 说明
version number 版本:0
success boolean 是否成功
customID number 客户id
serviceKey string 服务器鉴权key(以后每次请求都要带上这个key)

返回格式：

	{
	  "version": 0,
	  "success": true,
	  "customID": 1000239,
	  "serviceKey": "42DEFB3AAA67BC864EB6BAE402FAE555"
	}

获取客户信息

请求参数

参数 类型 必选 说明
version number true 版本:0
method string true 方法:getCustomerInfo
customID number true 客户id
serviceKey string true 服务器鉴权key(登录请求服务器的响应)

HTTP请求例子：http://api.gpsoo.net/MobileServlet?method=getCustomerInfo&version=0&customID=1001772&serviceKey=42DEFB3AAA67BC864EB6BAE402FAE555

服务器响应

参数 类型 说明
version number 版本:0
success boolean 是否成功
customID number 客户id
customName string 客户名称
customType string 客户类型(8:终端客户 4:经销商)

返回格式：

	{
	   "version": 0,
	   "success": true,
	   "customID": 1000239,
	   "customName": "好汉物流", 
	   "customType": 8
	}

获取客户设备列表

请求参数

参数 类型 必选 说明
version number true 版本:0
method string true 方法:getCustomerInfo
customID number true 客户id
serviceKey string true 服务器鉴权key(登录请求服务器的响应)

HTTP请求例子：http://api.gpsoo.net/MobileServlet?method=getMyDevicesInfo&version=0&customID=1001772&serviceKey=42DEFB3AAA67BC864EB6BAE402FAE555

服务器响应

参数 参数 类型 说明
version number 版本:0
key deviceID number 设备id
deviceName string 设备名
imei string 设备imei号
iconType string 图标类型
deviceType string 设备型号
isValidate boolean 是否是有效设备: true:有效(未过期),false:无效（过期设备）
carNum string 车牌号
groupID number 设备所在分组id （默认分组id:0，名字:默认组）
values Key中参数对应值组成的数组， 格式如下"values": [{value1}, …，{valuen}]
groups groupID number 组id
groupName string 组名

返回格式：

	{
	  "version": 0,
	  "key": {
		  "deviceID": 0,
		  "deviceName": 1,
		  "imei": 2,
		  "iconType": 3,
		  "deviceType": 4,
		  "isValidate": 5,
		  "carNum": 6,
		  "groupID": 7
		},
	  "values": [
		{
		  "0": 238,
		  "1": "深圳的士",
		  "2": "353419034478888",
		  "3": "22",
		  "4": "GT02A++", 
		  "5": true,
		  "6": "粤D8899888",
		  "7":1
		}
	    ],
	   "groups": [
		 {"groupID": 1,"groupName": "武广专线"},
		 {"groupID": 2,"groupName": "上海专线"}
	   ]
	}

跟踪单设备

请求参数

参数 类型 必选 说明
version number true 版本:0
method string true 方法:getDeviceGpsInfo
deviceID number true 设备id，有多个可以用将id用逗号分隔
mapType string true 地图类型
serviceKey string true 服务器鉴权key(登录请求服务器的响应)

HTTP请求例子：http://api.gpsoo.net/MobileServlet?method=getDeviceGpsInfo&version=0&deviceID=65979&mapType=G_SATELLITE_MAP&serviceKey=42DEFB3AAA67BC864EB6BAE402FAE555

服务器响应

参数 参数 类型 说明
version number 版本:0
key deviceID number 设备id
dateTime number 定位时间
sysTime number 系统时间
heartTime number 心跳时间
serverTime number 当前服务器时间
lng number 经度
lat number 纬度
course number 航向(正北方向为0度，顺时针方向增大。最大值360度)
speed number 速度，(单位:KM/H)
status string 状态
values Key中参数对应值组成的数组， 格式如下"values": [{value1}, …，{valuen}]

返回格式：

	{
	"version": 0,
	"key":{ 
	  "deviceID": 0,
	  "dateTime": 1,
	  "sysTime": 2,
	  "heartTime": 3,
	  "serverTime": 4,
	  "lng": 5,
	  "lat": 6,
	  "course": 7,
	  "speed": 8,
	  "status": 9
	},
	"values":[
	    {
		"0": 238, 
		"1": 1318409927000, 
		"2": 1318409919009, 
		"3": 1318409919009, 
		"4": 1318428292663,
		"5": 113.91919,
		"6": 22.54546,
		"7": 100,
		"8": 80,
		"9": "02"
	    }
	  ]
	}

回放历史数据

请求参数

参数 类型 必选 说明
version number true 版本:0
method string true 方法:getHistoryLocationInfo
deviceID number true 设备id
mapType string true 地图类型
beginTime number true 开始时间(UTC)
endTime number true 结束时间(UTC)
limit number true 每次请求数据数量(一次最大1000条)
serviceKey string true 服务器鉴权key(登录请求服务器的响应)

注:
客户端每次发起获取回放数据请求，只要能获取到指定的数量的数据或得到的数据的定位时间小于结束时间，就需要发起请求，发起请求参数的beginTime就是上次请求最后一个点的定位时间

HTTP请求例子：http://api.gpsoo.net/MobileServlet?method=getHistoryLocationInfo&version=0&deviceID=65979&mapType=G_SATELLITE_MAP&serviceKey=42DEFB3AAA67BC864EB6BAE402FAE555&beginTime=1318409927000&endTime=1318409997000&limit=200

服务器响应

参数 参数 类型 说明
version number 版本:0
key dateTime number 定位时间
lng number 经度
lat number 纬度
speed number 速度，(单位:KM/H)
values Key中参数对应值组成的数组， 格式如下"values": [{value1}, …，{valuen}]

返回格式：

	{
	"version": 0,
	"key":{
	  "dateTime": 0,
	  "lng": 1,
	  "lat": 2,
	  "speed": 3
	},
	"values": [
		{ 
		"0": 1318409927000,
		"1": 113.81818,
		"2": 22.54556,
		"3": 30
		}, {
		 "0": 1318409937000,
		 "1": 113.91818,
		 "2": 22.54556, 
		 "3": 25
		}, { 
		 "0": 1318409947000,
		 "1": 113.92818,
		 "2": 22.54567, 
		 "3": 40
		}
	   ]
	}

监控所有设备

请求参数

参数 类型 必选 说明
version number true 版本:0
method string true 方法:getCustomDeviceAndGpsInfo
customID number true 客户id
mapType string true 地图类型
serviceKey string true 服务器鉴权key(登录请求服务器的响应)

HTTP请求例子：http://api.gpsoo.net/MobileServlet?method=getCustomDeviceAndGpsInfo&version=0&customID=1001772&mapType=G_SATELLITE_MAP&serviceKey=42DEFB3AAA67BC864EB6BAE402FAE555

服务器响应

参数 参数 类型 说明
version number 版本:0
key deviceID number 设备id
userName string 设备名
isValidate boolean 是否是有效设备: true:有效(未过期),false:无效（过期设备）
deviceType string 设备类型
dateTime number 定位时间
sysTime number 系统时间
heartTime number 心跳时间
serverTime number 当前服务器时间
lng number 经度
lat number 纬度
course number 航向(正北方向为0度，顺时针方向增大。最大值360度)
speed number 速度，(单位:KM/H)
status string 状态
groupID number 设备所在组id（默认分组id:0，名字:默认组）
values Key中参数对应值组成的数组， 格式如下"values": [{value1}, …，{valuen}]
groups groupID number 组id
groupName string 组名

返回格式：

	{
	"version":0,
		"key":{ 
		   "userID":0,
		   "userName":1,
		   "isValidate ":2,
		   "deviceType":3,
		   "dateTime":4,
		   "sysTime":5,
		   "heartTime":6,
		   "serverTime":7,
		   "lng":8,
		   "lat":9,
		   "course":10,
		   "speed":11,
		   "status":12,
		   "groupID":13
		},
		"values":[
		  { 
			"0":238,
			"1":"深圳的士",
			"2":true,
			"3":"GT06",
			"4":1318409937000,
			"5":1318409937000,
			"6":1318409937000,
			"7":1318409938000,
			"8":113.91918,
			"9":22.54556,
			"10":100,
			"11":60,
			"12":"450604",
			"13":1}, {"0":239,
			"1":"摩托车",
			"2":false,
			"3":"GT02",
			"4":1318409937000,
			"5":1318409937000,
			"6":1318409937000,
			"7":1318409938000,
			"8":113.91918,
			"9":22.54556,
			"10":100,
			"11":60,
			"12":"02",
			"13":2}, {"0":4004,
			"1":"大卡",
			"2":true,
			"3":"GT06",
			"4":1318409937000,
			"5":1318409937000,
			"6":1318409937000,
			"7":1318409938000,
			"8":113.91918,
			"9":22.54556,
			"10":100,
			"11":60,
			"12":"450604",
			"13":3
		  }
		],
		"groups":[
		   {"groupID":1,"groupName":"武广专线"},
		   {"groupID":2,"groupName":"上海专线"}
		]
	}

获取设备最新位置数据(监控)

请求参数

参数 类型 必选 说明
version number true 版本:0
method string true 方法:getMonitorGpsInfo
customID number true 客户id
mapType string true 地图类型
serviceKey string true 服务器鉴权key(登录请求服务器的响应)

HTTP请求例子：http://api.gpsoo.net/MobileServlet?method=getMonitorGpsInfo&version=0&customID=1001772&mapType=G_SATELLITE_MAP&serviceKey=42DEFB3AAA67BC864EB6BAE402FAE555

服务器响应

参数 参数 类型 说明
version number 版本:0
key deviceID number 设备id
dateTime number 定位时间
sysTime number 系统时间
heartTime number 心跳时间
serverTime number 当前服务器时间
lng number 经度
lat number 纬度
course number 航向(正北方向为0度，顺时针方向增大。最大值360度)
speed number 速度，(单位:KM/H)
status string 状态
values Key中参数对应值组成的数组， 格式如下"values": [{value1}, …，{valuen}]

返回格式：

	{
	"version": 0,
	"key":{ 
	  "deviceID": 0,
	  "dateTime": 1,
	  "sysTime": 2,
	  "heartTime": 3,
	  "serverTime": 4,
	  "lng": 5,
	  "lat": 6,
	  "course": 7,
	  "speed": 8,
	  "status": 9
	},
	"values":[
	   {
		"0": 238, 
		"1": 1318409927000, 
		"2": 1318409919009, 
		"3": 1318409919009, 
		"4": 1318428292663,
		"5": 113.91919,
		"6": 22.54546,
		"7": 100,
		"8": 80,
		"9": "02"
	    }
	  ]
	}

逆地理位置解析

接口说明

该接口是根据经纬度得到中文地址

注意：目前仅能得到大陆地区的地址,如果需要大陆地区以外的地址信息，请调用google接口或其他接口)

接口地址

http://g.gpsoo.net/o.jsp

参数列表

参数名 必选 值 说明
i true 经度,纬度,速度 如114.342155,纬度: 30.682749,速度为4KM/H，那么参数的值为: 114.342155,30.682749,4
map false BAIDU 经纬度是经过百度校准过的
G_NORMAL_MAP 经纬度是经过google校准过的
空/不传该参数 经纬度是原始经纬度，未经任何校准

例子：

(这里 经度为114.342155,纬度: 30.682749,速度为4KM/H)
1). 经过百度校准的经纬度得到地址的请求
http://g.gpsoo.net/o.jsp?i=114.342155,30.682749,4&map=BAIDU
2). 经过google校准的经纬度得到地址的请求
http://g.gpsoo.net/o.jsp?i=114.342155,30.682749,4&map=G_NORMAL_MAP
3). 原始经纬度(未经校准) 得到地址的请求
http://g.gpsoo.net/o.jsp?i=114.342155,30.682749,4

经纬度校准

默认是google地图校准，如果需要其他地图校准，请联系我们 info#goome.net
接口: http://api.gpsoo.net/adjust.jsp?q=经度,纬度
返回结果为： 校准后的经度,校准后的纬度
例如： http://api.gpsoo.net/adjust.jsp?q=113.91919,22.54545
返回结果：113.92405,22.542414

名词解释

位置数据相关的时间

1. 定位时间(datetime): 终端设备上来的gps定位时间，是卫星时间
2. 系统时间(systime): 终端设备上来定位数据的时候，服务器的时间，即这条数据上来的时候的服务器时间
3. 心跳时间(heartTime):心跳时间，即终端设备上来心跳数据包的时间(是服务器时间)
补充：andriod等客户端请求设备的位置的数据的时候，会带下去一个serverTime的时间，这个是android客户端请求位置数据时，服务器的时间。即这次请求的时候服务器的时间。给android用来判断设备的运动状态用的

终端设备的状态

终端设备有 未上线，静止，运动，离线 4种状态
服务器时间:servertime
定位时间:datetime
心跳时间:heart_time
系统时间:sys_time
a:服务器时间-定位时间
b:服务器时间-心跳时间
c:服务器时间-系统时间

未上线:速度为-9，且b 大于1500秒，判断为未上线

离线:如果b和c中的最小值大于1500秒(即重新搜网25分钟没有收到心跳) 就判断该设备处于离线状态

静止:如果a大于35秒(即连续俩个信号周期没有定位)就判断设备处于静止状态 或者是速度小于某个指定值,以gt02为例,如果速度不大于10(静态漂移)则为静止

运动:a <=35秒，判定为运动，行驶中

API文档

显示全部

基于开放API的第三方应用：

Android： 百度地图 | 谷歌地图

info@goome.net