车辆实时位置

简要描述

多车实时位置查询

请求地址

/v4/api/location/selectTransTimeManage

Header

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

请求参数

参数名	必选	类型	层级	说明	示例
vclN	是	string	1	车牌号	鄂A11252
vco	是	string	1	车牌颜色(1 蓝色、2 黄色、3 黄绿色)	2
startLonlat	否	string	1	始发地坐标 始发地坐标和目的地坐标为一组，始发地行政区划编码和目的地行政区划编码为一组，都输入的时候以始发地坐标、 目的地坐标为准	116.31795,30.4252
endLonlat	否	string	1	目的地坐标系 始发地坐标和目的地坐标为一组，始发地行政区划编码和目的地行政区划编码为一组，都输入的时候以始发地坐标、 目的地坐标为准	110.9946817,25.9089816
startAreaCode	否	string	1	始发地行政区划编码	431102
endAreaCode	否	string	1	目的地行政区编码	450324
timeNearby	否	int	1	时间范围，单位:小时，指返回车辆最近时间范围内的最后定位信息	24(注:单位为小时，结合需要实际使用情况动态设置)
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 = "始发地坐标", example = "116.31795,30.4252")
private String startLonlat;

@Schema(description = "目的地坐标系", example = "110.9946817,25.908981")
private String endLonlat;

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

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

@Schema(name = "时间范围，单位:小时，指返回车辆最近时间范围内的最后定位信息", example = "24", description = "24(注:单位为小时，结合需要实际使用情况动态设置)")
private Integer timeNearby;

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

返回参数

@Schema(description = "车牌号", example = "京AB0001")
private String vno;

@Schema(description = "车辆最后定位经度 格式：1/600000.0(WGS84坐标系)", example = "19356858")
private String lon;

@Schema(description = "车辆最后定位纬度 格式：1/600000.0(WGS84坐标系)", example = "71847300")
private String lat;

@Schema(description = "车辆地理位置名称", example = "江苏省镇江市扬中市")
private String adr;

@Schema(description = "车辆定位时间，时间戳", example = "1635497914000")
private String utc;

@Schema(description = "速度(km/h)", example = "39.1")
private String spd;

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

@Schema(description = "省份", example = "江苏省")
private String province;

@Schema(description = "市区", example = "镇江市")
private String city;

@Schema(description = "县区", example = "扬中市")
private String country;

@Schema(description = "里程(km)", example = "0.0")
private String mil;

@Schema(description = "离线状态 true:离线 false:在线", example = "true")
private String offlineState;

@Schema(description = "离线时长(分钟)", example = "5422")
private String offlineTime;

@Schema(description = "车辆已行驶里程(km)", example = "724.0")
private String runDistance;

@Schema(description = "剩余运距(km)", example = "54.1")
private String remainDistance;

@Schema(description = "预计到达时间(时间戳)", example = "1626067123000")
private String estimateArriveTime;

成功返回示例

code = 200 且 data中state = 200 为定位成功，才会扣费

失败返回示例

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