车辆历史轨迹

简要描述

单车历史轨迹查询

限流规则

(车牌号+开始时间年月日+结束时间年月日) / 5分钟 / 次

请求地址

/v4/api/location/selectRouterPath

Header

参数名	必选	类型	说明
Token	是	string	应用令牌

请求参数

参数名	必选	类型	层级	说明	示例
vclN	是	string	1	车牌号	鄂A11252
vco	是	string	1	车牌颜色(1 蓝色、2 黄色、3 黄绿色)	2
vin	是	string	1	车架号	1234568915
startTime	是	string	1	开始时间 近 6 个月自然月	2021-09-05 15:56:46
endTime	是	string	1	结束时间 与开始时间相差 72 小时之内	2021-09-05 23:56:46
startLonlat	否	string	1	始发地坐标 始发地坐标和目的地坐标为一组，始发地行政区划编码和目的地行政区划编码为一组，都输入的时候以始发地坐标、 目的地坐标为准	116.31795,30.4252
endLonlat	否	string	1	目的地坐标系 始发地坐标和目的地坐标为一组，始发地行政区划编码和目的地行政区划编码为一组，都输入的时候以始发地坐标、 目的地坐标为准	110.9946817,25.9089816
startAreaCode	否	string	1	始发地行政区划编码	431102
endAreaCode	否	string	1	目的地行政区编码	450324
parkMins	否	int	1	停车时长 (分钟)	5 不填默认5min,(若输入，则最小值为5min，最大值为10000min)
fileId	否	string	1	文件id	调用/location/operateVehicleAuth接口传入车辆行驶证照片返回fileId (特殊场景)

• 请求对象

@Schema(description = "车牌号")
@NotBlank(message = "车牌号不能为空")
private String vclN;

@Schema(description = "车牌颜色(1 蓝色、2 黄色、3 黄绿色)", example = "2")
@NotBlank(message = "车牌颜色不能为空")
private String vco;

@Schema(description = "开始时间 近 6 个月自然月", example = "2021-09-05 15:56:46")
@NotNull(message = "开始时间不能为空")
private Date startTime;

@Schema(description = "结束时间 与开始时间相差 72 小时之内", example = "2021-09-05 23:56:46")
@NotNull(message = "结束时间不能为空")
private Date endTime;

@Schema(description = "始发地坐标 始发地坐标和目的地坐标为一组，始发地行政区划编码和目的地行政区划编码为一组，都输入的时候以始发地坐标、 目的地坐标为准", example = "116.31795,30.4252")
private String startLonlat;

@Schema(description = "目的地坐标系 始发地坐标和目的地坐标为一组，始发地行政区划编码和目的地行政区划编码为一组，都输入的时候以始发地坐标、 目的地坐标为准", example = "110.9946817,25.9089816")
private String endLonlat;

@Schema(description = "始发地行政区划编码", example = "431102")
private String startAreaCode;

@Schema(description = "目的地行政区编码", example = "450324")
private String endAreaCode;

@Schema(name = "停车时长 (分钟)", example = "5", description = "不填默认5min,(若输入，则最小值为5min，最大值为10000min)")
private Integer parkMins;

@Schema(description = "文件id")
private String fileId;

返回参数

@Schema(description = "路程总里程(千米)", example = "55")
private String mileage;

@Schema(description = "停车次数")
private String parkSize;

@Schema(description = "途经城市列表")
private List<CityArrayDTO> cityArray;

@Schema(description = "停车列表")
private List<ParkArrayDTO> parkArray;

@Schema(description = "轨迹列表")
private List<TrackArrayDTO> trackArray;


@Getter
@Setter
@Schema(description = "途经城市列表")
public static class CityArrayDTO {

    @Schema(description = "城市名称", example = "500106")
    private String cityCode;

    @Schema(description = "城市名称", example = "1")
    private String cityName;

    @Schema(description = "进出城市时间", example = "1628486013000")
    private String vInOutTime;

    @Schema(description = "进出城市类型 1-进   2-出", example = "1")
    private String vInOutType;
}

@Getter
@Setter
@Schema(description = "停车列表")
public static class ParkArrayDTO {

    @Schema(description = "停车地址", example = "重庆市渝北区铁家湾,东北方向,229.0米")
    private String parkAdr;

    @Schema(description = "停车开始时间", example = "1628477210000")
    private String parkBte;

    @Schema(description = "停车结束时间", example = "1628485611000")
    private String parkEte;

    @Schema(description = "纬度 格式：1/600000.0 (WGS84 坐标系)", example = "17855836")
    private String parkLat;

    @Schema(description = "经度 格式：1/600000.0 (WGS84 坐标系)", example = "64007815")
    private String parkLon;

    @Schema(description = "停车时长(分钟)", example = "30")
    private String parkMins;
}

@Getter
@Setter
@Schema(description = "轨迹列表")
public static class TrackArrayDTO {
    @Schema(description = "上报里程(千米)", example = "123.0")
    private String mlg;

    @Schema(description = "正北方向夹角 0 或 360：正北，大于 0 且小于 90：东北，等于 90：正东，大于 90 且小于 180：东南，等于 180：正南，大于 180 且小于 270：西南，等于 270：正西，大于270 且小于等于 359：西北，9其他：未知", example = "270")
    private String agl;

    @Schema(description = "GPS时间 对应2021-08-09 10:46:50", example = "20210809/104650")
    private String gtm;

    @Schema(description = "海拔(米)", example = "326")
    private String hgt;

    @Schema(description = "纬度 格式：1/600000.0 (WGS84 坐标系)")
    private String lat;

    @Schema(description = "经度 格式：1/600000.0 (WGS84 坐标系)", example = "64007815")
    private String lon;

    @Schema(description = "GPS速度(千米/小时)", example = "54.3")
    private String spd;
}

失败返回示例

{
  "code": 1006,
  "msg": "无结果",
  "data": null,
  "total": null,
  "requestId": "661df7a1"
}