天翼云智能视图服务API

1. 批量查询视图机动车数据

接口功能介绍

本接口用于批量查询机动车信息。

接口约束

无

URI

GET /ga1400/motorVehicles

路径参数

无

Query参数

参数	是否必填	参数类型	说明	示例
PageNum	否	Integer	分页查询，第几页	1
PageSize	否	Integer	分页查询，页大小，取值范围为1～1000	10
DeviceID	否	String	设备唯一标识（非视图编码）； DeviceID不为空时，查询指定设备的机动车数据	1101548215381688320
MotorVehicleID	否	String	机动车id， MotorVehicleID不为空时，查询指定的机动车	120100004011970010110220240617161529004840600485
RegionCode	否	String	区域编码，RegionCode不为空时，查询该区域的机动车数据	0851001
StartTime	否	Integer	机动车数据上报时间，StartTime非空，查询在此时间之后(包含)出现的机动车数据	1721123422
EndTime	否	Integer	机动车上报时间，EndTime非空，查询在此时间之前出现的机动车数据	1730106125

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例
Authorization	是	String	认证信息。	CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f
Content-Type	是	String	互联网媒体类型。	application/json;charset=utf-8
Host	是	String	主机。	vssapi.ctyun.cn
Version	是	String	版本。	2021-11-25
Timestamp	是	String	时间戳。	1689643309

请求体body参数

无

响应参数

参数	参数类型	说明	示例	下级对象
statusCode	Integer	响应状态码。	200
error	String	错误码，执行成功时，不返回该字段。	VSS_0001
message	String	响应信息。	请求成功
requestId	String	请求ID。	362d4e78556b47129182d0881fade86b
returnObj	Object	响应数据，执行失败时，不返回该字段。		returnObj

表 returnObj

参数	参数类型	说明	示例	下级对象
Total	Integer	总条数	100
PageSize	Integer	页大小	10
PageNum	Integer	第几页	1
RequestId	String	请求id	362d4e78556b47129182d0881fade86b
MotorVehicleObject	Array of Objects	人员数据列表		MotorVehicle

表MotorVehicle

参数	参数类型	说明	示例	下级对象
MotorVehicleID	String	车辆标识。	330101010012100000010220171018080608022060269895
InfoKind	Integer	信息分类，人工采集还是自动采集。	1
SourceID	String	来源标识。	33010101001210000001022017101808060802206
TollgateID	String	关联卡口编号。
DeviceID	String	设备编码。	11010000445037000048
StorageUrl1	String	近景照片。	1023559125485764608/viid/persons/120100004011970010110220240618160303001240100125_12010000401197001011022024061816030300124_20240618160303.jpeg
StorageUrl2	String	车牌照片。	3
StorageUrl3	String	远景照片。	1
StorageUrl4	String	合成图。
StorageUrl5	String	缩略图。
LeftTopX	Integer	左上角 X 坐标。	1
LeftTopY	Integer	左上角 Y 坐标。	2
RightBtmX	Integer	右下角 X 坐标。	3
RightBtmY	Integer	右下角 Y 坐标。	4
MarkTime	String	位置标记时间。
AppearTime	String	车辆出现时间。
DisappearTime	String	车辆消失时间。
LaneNo	Integer	车道号。	1
HasPlate	Integer	有无车牌。	1
PlateClass	String	号牌种类。	99
PlateColor	String	车牌颜色。	99
PlateNo	String	车牌号。	沪AF8888
PlateNoAttach	String	挂车牌号。	1
PlateDescribe	String	车牌描述。	12
IsDecked	Integer	是否套牌。	1
IsAltered	Integer	是否涂改。	1
IsCovered	Integer	是否遮挡。	1
Speed	Double	行驶速度。	8
Direction	String	行驶方向。	9
DrivingStatusCode	String	行驶状态代码。	1
UsingPropertiesCode	Integer	车辆使用性质代码。	1
VehicleClass	String	车辆类型。	X99
VehicleBrand	String	车辆品牌。	1
VehicleModel	String	车辆型号。	1
VehicleStyles	String	车辆年款。	1
VehicleLength	Integer	车辆长度。	0
VehicleWidth	Integer	车辆宽度。	1
VehicleHeight	Integer	车辆高度。	1
VehicleColor	String	车身颜色。	1
VehicleColorDepth	String	颜色深浅。	2
VehicleHood	String	车前盖。	4
VehicleTrunk	String	车后盖。	5
VehicleWheel	String	车轮。	1
WheelPrintedPattern	String	车轮印花纹。	1
VehicleWindow	String	车窗。	1
VehicleRoof	String	车顶。	1
VehicleDoor	String	车门。	1
SideOfVehicle	String	车侧。	1
CarOfVehicle	String	车厢。	1
RearviewMirror	String	后视镜。	1
VehicleChassis	String	底盘。	1
VehicleShielding	String	遮挡。	1
FilmColor	String	贴膜颜色。	1
IsModified	Integer	改装标志。	1
HitMarkInfo	String	撞痕信息。	1
VehicleBodyDesc	string	车身描述。	1
VehicleFrontItem	string	车前部物品。	1
DescOfFrontItem	string	车前部物品描述。	1
VehicleRearItem	string	车后部物品。	1
DescOfRearItem	string	车后部物品描述。	1
NumOfPassenger	Integer	车内人数。	2
PassTime	String	经过时刻。	20160912220107
NameOfPassedRoad	String	经过道路。	12
IsSuspicious	Integer	是否可疑车。	1
Sunvisor	Integer	遮阳板状态。	1
SafetyBelt	Integer	安全带状态。	1
Calling	Integer	打电话状态。	1
PlateReliability	String	号牌识别可信度。	1
PlateCharReliability	string	每位号牌号码可信度。
BrandReliability	string	品牌标志识别可信度。	1
SubImageList	Object	图片列表。		SubImageInfoList

表 SubImageInfoList

参数	参数类型	说明	示例	下级对象
SubImageInfoObject	Array of Objects	图像信息。		SubImageInfoObject[]

表 SubImageInfoObject

参数	参数类型	说明	示例
ImageID	String	图像标识。	12010000401197001011022024061716152900484
EventSort	Integer	事件分类。	10
DeviceID	String	采集设备编码。	11010000445037000048
StoragePath	String	存储路径。	"https://vssapi.ctyun.cn/vss-1234567/1101548215381688320/viid/motorvehicles/130000005111970010020220241030171759000100200001_13000000511197001002022024103017175900011_20241030171759.jpeg"
Type	String	文件类型。	14
FileFormat	String	图像文件格式。	Jpeg
ShotTime	String	拍摄时间，格式：YYYYMMDDhhmmss。	20240617161529
Width	Integer	宽度。	1920
Height	Integer	高度。	1136
Data	String	Base64编码二进制流。

请求示例

请求url

'GET /ga1400/motorVehicles?PageNum=1&PageSize=10&StartTime=1706544000&EndTime=1730363718'

请求头header

{
    "Authorization": "CT-HMAC-SHA256 Credential=DS6X6E782JHKU7KHHMSH/2023-04-13/vss, SignedHeaders=content-type;host;timestamp, Signature=5131b2a142fca37d0ede208122a5183c32a466296df265609aac653221e00e71",
    "Content-Type": "application/json;charset=utf-8",
    "Host": "vssapi.ctyun.cn",
    "Version": "2021-11-25",
    "Timestamp": "1730277318"
}

请求体body

无

响应示例

{
    "statusCode": 200,
    "message": "请求成功",
    "requestId": "51f80f929333475eaad2f2e796122e94",
    "returnObj": {
        "Total": 6,
        "PageSize": 1,
        "PageNum": 1,
        "MotorVehicleObject": [
            {
                "MotorVehicleID": "130000005111970010020220241030171759000100200001",
                "InfoKind": 0,
                "SourceID": "13000000511197001002022024103017175900010",
                "TollgateID": "31010400001210000001",
                "DeviceID": "13000000511197001002",
                "StorageUrl1": "",
                "StorageUrl2": "",
                "StorageUrl3": "",
                "StorageUrl4": "",
                "StorageUrl5": "",
                "LeftTopX": 1,
                "LeftTopY": 2,
                "RightBtmX": 3,
                "RightBtmY": 4,
                "MarkTime": "20241030171759",
                "AppearTime": "20241030171759",
                "DisappearTime": "20241030171759",
                "LaneNo": 45,
                "HasPlate": "0",
                "PlateClass": "89",
                "PlateColor": "56",
                "PlateNo": "沪A123456",
                "PlateNoAttach": "车辆保存",
                "PlateDescribe": "wwww",
                "IsDecked": "0",
                "IsAltered": "0",
                "IsCovered": "0",
                "Speed": 98.9,
                "Direction": "2",
                "DrivingStatusCode": "234",
                "UsingPropertiesCode": 0,
                "VehicleClass": "123",
                "VehicleBrand": "123",
                "VehicleModel": "3",
                "VehicleStyles": "4",
                "VehicleLength": 200,
                "VehicleWidth": 100,
                "VehicleHeight": 89,
                "VehicleColor": "3",
                "VehicleColorDepth": "8",
                "VehicleHood": "1",
                "VehicleTrunk": "2",
                "VehicleWheel": "3",
                "WheelPrintedPattern": "4",
                "VehicleWindow": "5",
                "VehicleRoof": "6",
                "VehicleDoor": "7",
                "SideOfVehicle": "8",
                "CarOfVehicle": "9",
                "RearviewMirror": "0",
                "VehicleChassis": "e",
                "VehicleShielding": "r",
                "FilmColor": "1",
                "IsModified": "0",
                "HitMarkInfo": "2",
                "VehicleBodyDesc": "1.0",
                "VehicleFrontItem": "3",
                "DescOfFrontItem": "4",
                "VehicleRearItem": "5",
                "DescOfRearItem": "34",
                "NumOfPassenger": 45,
                "PassTime": "20241030171759",
                "NameOfPassedRoad": "22",
                "IsSuspicious": "0",
                "Sunvisor": 0,
                "SafetyBelt": 0,
                "Calling": 1,
                "PlateReliability": "2",
                "PlateCharReliability": "345",
                "BrandReliability": "1",
                "SubImageList": {
                    "SubImageInfoObject": [
                        {
                            "ImageID": "13000000511197001002022024103017175900011",
                            "EventSort": 0,
                            "DeviceID": "13000000511197001002",
                            "StoragePath": "https://vssapi.ctyun.cn/vss-1234567/1101548215381688320/viid/motorvehicles/130000005111970010020220241030171759000100200001_13000000511197001002022024103017175900011_20241030171759.jpeg",
                            "Type": "11",
                            "FileFormat": "Jpeg",
                            "ShotTime": "20241030171759",
                            "Width": 2048,
                            "Height": 1112,
                            "Data": null
                        },
                        {
                            "ImageID": "13000000511197001002022024103017175900012",
                            "EventSort": 0,
                            "DeviceID": "13000000511197001002",
                            "StoragePath": "https://vssapi.ctyun.cn/vss-1234567/1101548215381688320/viid/motorvehicles/130000005111970010020220241030171759000100200001_13000000511197001002022024103017175900012_20241030171759.jpeg",
                            "Type": "11",
                            "FileFormat": "Jpeg",
                            "ShotTime": "20241030171759",
                            "Width": 200,
                            "Height": 58,
                            "Data": null
                        }
                    ]
                }
            }
        ],
        "RequestId": "51f80f929333475eaad2f2e796122e94"
    }
}

状态码

请参考状态码说明。

错误码

请参考错误码说明。

批量查询GA1400机动车信息

最近更新时间：2026-03-19 18:16:28