必经地/禁行地管理服务
4.1.5. 必经地/禁行地管理服务
4.1.5.1. 服务使用场景
4.1.5.2. 产品功能说明
4.1.5.3. 业务规则
1.
2.
3.
4.1.5.4. API对接说明
/api/jjzy/groundPassesV2输入参数列表
| 请求参数 | 必须参数 | 参数类型 | 示例数据 | 说明 |
|---|---|---|---|---|
| vehicleNo | 是 | String | 沪FH8703 | 车牌号 |
| plateColorCode | 是 | String | 2 | 车牌颜色代码（见文档最后【车牌颜色】代码集） |
| timeNearby | 是 | Integer | 10 | 时间范围，从车辆最后一次位置上报开始往前计算，单位小时 |
| fenceArray | 是 | Array | - | 围栏信息集合 |
fenceArray（围栏信息集合）中元素包含属性
| 参数 | 必须参数 | 参数类型 | 示例数据 | 说明 |
|---|---|---|---|---|
| serialNum | 否 | Integer | 5 | 围栏编号 |
| latitude | 是 | Double | 30.893984 | 围栏中心维度(WGS84坐标系) |
| longitude | 是 | Double | 121.84164 | 围栏中心经度(WGS84坐标系) |
| radius | 是 | Double | 20 | 围栏半径：单位米 |
输出参数列表
| 响应参数 | 必须参数 | 参数类型 | 示例数据 | 说明 |
|---|---|---|---|---|
| code | 是 | Int | 200 | 状态码 |
| message | 是 | String | 请求成功 | 返回提示消息 |
| data | 否 | Object | - | 获取成功不为空 |
data字段包含
| 响应参数 | 必须参数 | 参数类型 | 示例数据 | 说明 |
|---|---|---|---|---|
| longitude | 是 | String | 17855836 | 格式：1/600000;经度(WGS84坐标系) |
| latitude | 是 | String | 64007815 | 格式：1/600000;维度(WGS84坐标系) |
| vec1 | 是 | String | 86.5 | 车速:km/h |
| direction | 是 | Integer | 56 | 车辆行驶方向（0度为正北方向，顺时针方向递增）大于0且小于90：东北，等于90：正东，大于90且小于180：东南，等于180：正南，大于180且小于270：西南，等于270：正西，大于270且小于等于359：西北，其他：未知 |
| isInside | 是 | String | 1 | 是否在围栏内部: 1是、0否 |
| positionTime | 是 | Integer | 1729597559000 | 定位时间戳，单位：毫秒 |
| province | 是 | String | 江苏省 | 所在省份 |
| city | 是 | String | 镇江市 | 所在城市 |
| county | 是 | String | 扬中市 | 所在地区 |
| mileage | 是 | String | 1896 | 定位是车辆的累计里程,单位：m |
| areaArray | 是 | List | - | 触发围栏列表 |
areaArray（触发围栏列表）中元素包含属性
| 响应参数 | 必须参数 | 参数类型 | 示例数 据 | 说明 |
|---|---|---|---|---|
| serialNum | 否 | Integer | 3 | 围栏编号 |
| inOutTime | 是 | Long | 1729597559000 | 进出围栏时间 时间戳格式，单位：毫秒 |
| inOutType | 是 | Integer | 1 | 进出围栏类型 1进入围栏 2退出围栏 |