易企用车

定位更新回调

GET

/callback/gps

提供回调地址，设备定位更新后，会将请求参数内容推送到该URL。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

address

string

地址描述

必需

中文

almOffline

string

是否离线

必需

1离线0在线

string

是否定位

必需

A定位V不定位

city

string

城市

必需

中文

createTime

integer

服务器时间

必需

服务器接收报文的时间

deviceNum

string

设备号

必需

direction

integer

方向

必需

单位度

directionName

string

方向名称

必需

string

东西方向

必需

E东W西

gpsTime

integer

定位时间

必需

设备上报GPS定位时间

hardMileage

integer

硬件里程

必需

设备上报累计里程，若重置需操作硬件

isMoving

integer

是否在行驶中

必需

1行驶0停车

lat

number

经度

必需

latBd

number

经度百度坐标系

必需

latGc

number

经度国测坐标系

必需

lng

number

纬度

必需

lngBd

number

纬度百度坐标系

必需

lngGc

number

纬度国测坐标系

必需

locMode

integer

定位方式

必需

定位方式 0-GPS；1-LBS单基站；2-LBS多基站；5-WIFI；9-不定位

string

南北

必需

N北S南

obdMileage

integer

OBD里程

必需

支持具有OBD功能的设备

obdV

integer

OBD电压

必需

支持具有OBD功能的设备

satCount

integer

卫星颗数

必需

设备扫描到的卫星颗数

signalLevel

integer

网络信号强度

必需

1极差 2差 3中 4强 null表示未上传或不支持

speed

integer

时速

必需

startTimeMovingStop

integer

开始行使/停车时间

必需

当isMoving=1此字段为开始行使时间，当isMoving=0此字段为开始停车时间

startTimeOnOffLine

integer

开始离线/在线时间

必需

当almOffline=1此字段为开始离线时间，当almOffline=0此字段为开始上线时间

status

string

状态

必需

状态描述空格间隔

totalMileage

integer

总里程

必需

软件里程

示例

{
  "address": "山东省 青岛市 市北区 劲松四路 阳光山色小区 内",
  "almOffline": 0,
  "av": "A",
  "city": "青岛市",
  "createTime": 1653361064000,
  "deviceNum": "868120276898647",
  "direction": 322,
  "directionName": "西北",
  "ew": "E",
  "gpsTime": 1653361060000,
  "hardMileage": 0,
  "isMoving": 0,
  "lat": 36.115024,
  "latBd": 36.12097,
  "latGc": 36.115318,
  "lng": 120.409504,
  "lngBd": 120.421234,
  "lngGc": 120.414635,
  "locMode": 0,
  "ns": "N",
  "obdMileage": 0,
  "obdV": 13,
  "satCount": 8,
  "signalLevel": 4,
  "speed": 0,
  "startTimeAv": 1653018285000,
  "startTimeMovingStop": 1653360911000,
  "startTimeOnOffLine": 1653321690000,
  "status": "停车",
  "totalMileage": 62890
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/callback/gps' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": "山东省 青岛市 市北区 劲松四路 阳光山色小区 内",
    "almOffline": 0,
    "av": "A",
    "city": "青岛市",
    "createTime": 1653361064000,
    "deviceNum": "868120276898647",
    "direction": 322,
    "directionName": "西北",
    "ew": "E",
    "gpsTime": 1653361060000,
    "hardMileage": 0.0,
    "isMoving": 0,
    "lat": 36.115024,
    "latBd": 36.12097,
    "latGc": 36.115318,
    "lng": 120.409504,
    "lngBd": 120.421234,
    "lngGc": 120.414635,
    "locMode": 0,
    "ns": "N",
    "obdMileage": 0.0,
    "obdV": 13,
    "satCount": 8,
    "signalLevel": 4,
    "speed": 0,
    "startTimeAv": 1653018285000,
    "startTimeMovingStop": 1653360911000,
    "startTimeOnOffLine": 1653321690000,
    "status": "停车",
    "totalMileage": 62890.0
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

规则触发回调（告警通知）