智运宝官方 Docs
  1. 始发地/目的地-实时通知服务
智运宝官方 Docs
  • 智运宝API接口文档
    • 智运宝 API 中心
    • 在途监控类服务
      • 普货车运输节点服务
      • 普货车运输行程服务
      • 危货车运输节点服务
      • 危货车运输行程服务
      • 必经地/禁行地管理服务
      • 普货运输行程服务 2.0-轨迹纠偏
    • 信息校验类服务
      • 营业执照验证服务
      • 企业道路运输经营许可证验证服务
      • 道路运输证验证服务
      • 司机从业资格证验证服务
      • 车辆入网验证服务
      • 车辆入网确认
      • 车辆能耗查询服务
    • 电子围栏服务
      • 电子围栏服务 V1.0
    • 熟车运力池服务
      • 熟车运力池服务
    • 始发地/目的地-实时通知服务
      • 始发地/目的地-实时通知服务
    • 包年包月车辆订阅服务
      • 包年包月车辆订阅服务
    • 国六车辆综合服务
      • G6运输行程服务
      • G6运输节点服务
      • G6运输节点服务(批量)
      • G6入网验证服务
      • G6入网确认服务
    • OCR 识别类服务
      • OCR识别类服务
      • OCR营业执照识别服务
      • OCR磅单识别服务
      • OCR道路运输证识别服务
      • OCR行驶证识别服务
      • OCR驾驶证识别服务
  • 数盾对称加密工具
    • 数盾 · DataShield 白皮书
    • 数盾 · 隐私与安全声明
    • 数盾 · 数据传输操作规范
    • 数盾 · Chrome 插件版
    • 数盾 · Python3 代码版
  1. 始发地/目的地-实时通知服务

始发地/目的地-实时通知服务

4.5. 始发地/目的地-实时通知服务#

4.5.1. 服务使用场景#

在规范化的厂区和园区内,装卸货通常需要提前安排好装卸设备和人员,因此对车辆的准时到达和出发有着严格的时间要求。如果能够提前得知车辆的抵达情况,将有助于现场提前部署和安排。
目的地-实时消息服务通过订阅车辆信息,实时计算货物的到达情况,并通过信息推送的方式在关键节点提供提醒,从而优化周转效率。

4.5.2. 产品功能说明#

基于实时进出区域算法,对货物进、出区域进行实时提醒。本服务根据客户提供的围栏和绑定的车辆,进行围栏和车辆的监控。
本服务需要结合电子围栏服务使用,包含6个接口:自定义区域注册接口,多边形区域注册接口,车辆订阅接口,车辆驶入事件接口,删除车辆订阅接口,删除自定义区域注册接口。
多接口按如下顺序调用
接口调用顺序

4.5.3. 业务规则#

订阅车辆#

1.
传入区域ID,绑定车辆。
2.
系统根据绑定的车辆进行监控。
3.
生命周期,注册后10分钟生效。

推送信息#

1.
需为我方开放平台提供车辆事件的通知回调接口,接口需遵循如下规范:
采用https方式对外提供接口服务,提供一个POST请求接口,x-www-form-urlencoded方式接收入参列表的所有参数,然后返回字符串"success"即可。
2.
推送接口不支持IP调用,必须使用域名调用。

删除车辆订阅接口#

1.
一次性最多请求100台车,进行删除订阅,但必须是绑定同一个围栏的车辆

4.5.4. API对接说明#

4.5.4.1. 车辆订阅接口#

接口基本信息
接口名称:车辆订阅接口
请求方式:POST
接口地址:/api/jjzy/save/apis/vnoReg
接口方法:ORIGINAL_PLACE
输入参数列表#
请求参数必须参数参数类型示例数据说明
areaid是Stringc850ea300cae8ada
699595c6623c8952
围栏ID
vnos是String沪FH8703_2,冀E6870Y_2车牌号_车牌颜色(车牌颜色见文档最后【车牌颜色】代码集),多个用英文逗号分隔(最大支持50个)
输出参数列表#
响应参数必须参数参数类型示例数据说明
code是Int200状态码
message是String请求成功返回提示消息
data否Object-获取成功不为空
data字段包含#
参数必须参数参数类型示例数据说明
result是Long11:成功,2:自定义区域ID不存在
status是String1001状态

4.5.4.2. 车辆订阅删除接口#

接口基本信息
接口名称:车辆订阅接口
请求方式:POST
接口地址:/api/jjzy/save/apis/vnoDel
接口方法:ORIGINAL_PLACE
输入参数列表#
请求参数必须参数参数类型示例数据说明
areaid是Stringc850ea300cae8ada
699595c6623c8952
围栏ID
vnos是String沪FH8703_2,冀E6870Y_2车牌号_车牌颜色(车牌颜色见文档最后【车牌颜色】代码集),多个用英文逗号分隔(最大支持100个)
输出参数列表#
响应参数必须参数参数类型示例数据说明
code是Int200状态码
message是String请求成功返回提示消息
data否Object-获取成功不为空
data字段包含#
参数必须参数参数类型示例数据说明
result是Long11:成功,2:自定义区域ID不存在
status是String1001状态

4.5.4.3. 车辆事件通知接口#

对接地址#
在"系统设置->应用管理->回调地址"中,设置一个POST请求接口,每个appId对应一个通知地址,x-www-form-urlencoded方式接收入参列表的所有参数,如:http://www.xxx.cn/areamsg
回调地址设置
POST数据体类似于如下:#
输入参数列表#
拼接参数必须参数参数类型示例数据说明
vno是String沪FH8703车牌号
plateColor是String2车牌颜色(见文档最后【车牌颜色】代码集)
areaId是Stringde2dc398c11e4f43
98ba5435c386c80b
围栏区域ID
type是Int2事件类型:1进区域通知、2出区域通知
areaName是String北仑港围栏名称
utc是Long1484978812831时间:UTC格式精确到毫秒
上一页
熟车运力池服务
下一页
包年包月车辆订阅服务