調用SearchImages搜索圖片。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SearchImages |
系統規定參數。取值:SearchImages。 |
Contents | String | 是 | /9j/4AAQSkZJRgABAQAAAQABAAD/2wB... |
圖像內容,base64 編碼,多個用","隔開。 說明 當NoFeature值為False時,為必選項。
|
From | Integer | 是 | 0 |
返回結果在查詢結果集中的偏移量,默認為0。 |
InstanceId | String | 是 | cityvisual-xxxxxx |
實例ID。 |
Size | Integer | 是 | 100 |
返回結果數量,默認為10。 |
StartTime | String | 是 | 1553734800000 |
查詢范圍起始時間戳 (毫秒), 13 位, 如1553734800000。 |
Type | String | 否 | person |
查詢類型。根據算法不同查詢不同的類型,天擎算法查詢類型示例:
|
EndTime | String | 否 | 1553735800000 |
查詢范圍結束時間戳 (毫秒), 13 位, 如1553756400000。 |
ImageIds | String | 否 | 001,002 |
支持使用多個目標id查詢,實現漸進性查詢。 id與id之間用逗號“,”隔開,如:”001,002”, 查詢的結果是與001和002兩個目標共同相似度最高的圖像。 |
CameraIds | String | 否 | 003_2 |
攝像頭點位id,支持多點位查詢。 各個點位之間用逗號"," 隔開,如"0001,0002", 查詢攝像頭0001和0002下的目標。 |
Attribute.N.Key | String | 否 | Age |
待查詢對象詳細屬性的鍵. 當Type取值為“Person”時,取值范圍: * Sex: 性別 * Age: 年齡 * Hair: 頭發類型 * Pose: 身體姿態 * ClothType: 上衣類型 * ClothColor: 上衣顏色 * TrouserType: 下衣類型 * TrouserColor: 下衣顏色 當Type取值為“Vehicle”時,取值范圍: * PlateNumber: 車牌號 * VehicleColor: 車身顏色 * VehicleType: 車輛 * Brand: 車輛品牌 當Type取值為“Bicycle”時,取值范圍: * Sex: 騎車人性別 * Age: 騎車人年齡 * HeadWear: 騎車人頭飾 * NonVehicleType: 非機動車類型 |
Attribute.N.Value | String | 否 | 12 |
待查詢對象詳細屬性的值。 |
NoFeature | String | 否 | True |
"True"表示不用特征匹配查詢,純屬性或id 查詢, "False"表示使用特征查詢。 |
RegionId | String | 否 | cn-shanghai |
地域ID。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
Images | Array |
圖片 |
|
Image | |||
AgeType | String | Youth |
當ObjType為“Person” 或“NonVehicle”時,年齡類型,取值范圍: * Youth: 青年 * Midlife: 中年 * OldAge: 老年 * Uncertain: 無法判斷 |
AgeTypeScore | Float | 0.99 |
當ObjType為“Person”時,年齡類型置信度, 取值范圍 |
Brand | String | DZ |
當ObjType為“Vehicle”時,車輛品牌。 |
BrandScore | Float | 0.89 |
當ObjType為“Vehicle”時,車輛品牌置信度, 取值范圍 |
CameraId | String | 003_2 |
攝像頭id。 |
ClothColor | String | White |
當ObjType為“Person”時,上衣顏色,取值范圍: * Black: 黑色 * White: 白色 * Gray: 灰色 * Red: 紅色 * Blue: 藍色 * Yellow: 黃色 * Orange: 橙色 * Brown: 棕色 * Green: 綠色 * Purple: 紫色 * Cyan 青色 * Pink: 粉色 * Transparent: 透明 * Other: 其他 |
ClothColorScore | Float | 0.5 |
當ObjType為“Person”時,上衣顏色置信度, 取值范圍 |
ClothType | String | Other |
當ObjType為“Person”時,上衣類型,取值范圍: * ShortSleeve: 短袖 * MiddleSleeve: 中袖 * Sleeveless: 無袖 * Other: 其他 |
ClothTypeScore | Float | 0.4 |
當ObjType為“Person”時,上衣類型置信度, 取值范圍[0,1]。 |
CropImage | String | https://oss-cn-shanghai.aliyuncs.com/cropImage/1560148924921.jpg |
對象摳圖存儲路徑。 |
EntryTime | String | 2018-10-10T10:20:30Z |
進入視頻時間。 |
Feature | String | /9j/4AAQSkZJRgABAQAAAQABAAD/2wB... |
圖像的高維特征向量, base64編碼。 |
HairType | String | Crop |
當ObjType為“Person”時,發型,取值范圍: * Crop: 平頭 * CentreParting: 中分 * ForeheadBaldness: 額禿 * NeckBaldness: 頸禿 * Bald: 全禿 * CurlyHair: 卷發 * WavyHair: 波浪發 * Braid: 麻花辮 * Updo: 盤發 * LongHair: 披肩發 * Other: 其他 |
HairTypeScore | Float | 0.7 |
當ObjType為“Person”時,頭發類型置信度, 取值范圍 |
HeadWear | String | Hat |
當ObjType為“NonVehicle”時,騎車人頭飾,取值范圍: * None: 無 * Hat: 帽子 * Helmet: 頭盔 * Scarf: 頭巾 * Other: 其他 |
HeadWearScore | Float | 0.6 |
當ObjType為“NonVehicle”時, 騎車人頭飾置信度, 取值范圍 |
ImageId | String | xxx |
圖片ID。 |
LeaveTime | String | 2018-10-10T10:20:40Z |
離開視頻畫面時間。按照ISO8601標準表示,并需要使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 |
NonVehicleType | String | Bicycle |
當ObjType為“NonVehicle”時,非機動車類型,取值范圍: * Bicycle: 自行車 * ElectricVehicle: 電瓶車 * ClosedTricycle: 封閉三輪車 * OpenedTricycle: 開放式三輪車 * Other: 其他 |
NonVehicleTypeScore | Float | 0.1 |
當ObjType為“NonVehicle”時,非機動車類型置信度, 取值范圍 |
ObjBottom | Integer | 1068 |
對象輪廓外接矩形在畫面中的位置,右下角Y坐標。 |
ObjLeft | Integer | 1630 |
對象輪廓外接矩形在畫面中的位置,左上角X坐標。 |
ObjRight | Integer | 1774 |
對象輪廓外接矩形在畫面中的位置,右下角X坐標。 |
ObjTop | Integer | 863 |
對象輪廓外接矩形在畫面中的位置,左上角Y坐標。 |
ObjType | String | Person |
對象類型,取值范圍: * Person: 行人 * Vehicle: 機動車 * NonVehicle: 非機動車 |
OrigImage | String | http://oss-cn-shanghai.aliyuncs.com/…… |
原圖存儲路徑地址。 |
PlateNumber | String | 浙A8888 |
當ObjType為“Vehicle”時,車牌號。 |
PoseType | String | Lie |
當ObjType為“Person”時,身體姿態,取值范圍: * Stand: 站 * Squat: 蹲 * LieDown: 臥 * Lie: 躺 * Sit: 坐 * Walk: 行走 * Run: 奔跑 * Jump: 跳躍 * Climb: 攀登 * Crawl: 匍匐 * Other: 其他 |
PoseTypeScore | Float | 0.6 |
當ObjType為“Person”時, 身體姿態置信度, 取值范圍 |
Score | Float | 0.3 |
圖片相似度得分。 |
SexType | String | Male |
當ObjType為“Person”或“NonVehicle”時,性別,取值范圍: * Male: 男 * Female: 女 * Uncertain: 不確定 |
SexTypeScore | Float | 0.5 |
當ObjType為“Person”時,性別置信度, 取值范圍 |
TimeStamp | String | 2018-10-10T10:20:40Z |
請求的時間戳。按照ISO8601標準表示,并需要使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。示例:2018-01-01T12:00:00Z 表示北京時間 2018 年 01 月 01 日 20 點 00 分 00 秒。 |
TrouserColor | String | Black |
當ObjType為“Person”時,下衣顏色類型,取值范圍同ClothColor。 |
TrouserColorScore | Float | 0.8 |
當ObjType為“Person”時, 下衣顏色置信度, 取值范圍 |
TrouserType | String | Trousers |
當ObjType為“Person”時,下衣類型,取值范圍: * Trousers: 長褲 * Shorts: 短褲 * Longuette: 長裙 * ShortSkirt: 短裙 * Other: 其他 |
TrouserTypeScore | Float | 0.3 |
當ObjType為“Person”時,下衣顏色置信度,取值范圍 |
VehicleColor | String | Black |
當ObjType為“Vehicle”時,車身顏色類型,取值范圍同ClothColor. |
VehicleColorScore | Float | 0.9 |
當ObjType為“Vehicle”時,車身顏色置信度,取值范圍 |
VehicleType | String | Van |
當ObjType為“Vehicle”時,車輛類型,取值范圍: * SUV: SUV * Car: 小轎車 * Truck: 大貨車 * Van: 小貨車 * Taxi: 出租車 * Bus: 公交車 * Minibus: 面包車 * Machineshop: 工程車 |
VehicleTypeScore | Float | 0.7 |
當ObjType為“Vehicle”時,車輛類型置信度,取值范圍 |
RequestId | String | E175B041-75A2-4335-B3AC-0FD008F93627 |
請求ID。 |
TotalCount | Integer | 4000 |
示例
請求示例
http(s)://[Endpoint]/?Action=SearchImages
&Contents=/9j/4AAQSkZJRgABAQAAAQABAAD/2wB...
&InstanceId=cityvisual-xxxxxx
&From=0
&Size=100
&StartTime=1553734800000
&<公共請求參數>
正常返回示例
XML
格式
<SearchImagesResponse>
<PageNumber>1</PageNumber>
<TotalCount>4000</TotalCount>
<PageSize>1</PageSize>
<RequestId>E175B041-75A2-4335-B3AC-0FD008F93627</RequestId>
<Images>
<Image>
<CameraId>301</CameraId>
<CropImage>...</CropImage>
<CropImageSigned>...</CropImageSigned>
<EntryTime>2019-09-01T18:00:00Z</EntryTime>
<ExtImage>null</ExtImage>
<Feature></Feature>
<Hair>1</Hair>
<HairScore>0.7153491</HairScore>
<ImageId>9771a825f344a0a21ac9a443e2350c6d</ImageId>
<LeaveTime>2019-09-01T18:10:00Z</LeaveTime>
<TrouserColor>9</TrouserColor>
<TrouserColorScore>0.582683</TrouserColorScore>
<TrouserType>2</TrouserType>
<TrouserTypeScore>0.82184184</TrouserTypeScore>
<ObjBottom>1068</ObjBottom>
<ObjLeft>1630</ObjLeft>
<ObjRight>1774</ObjRight>
<ObjTop>8631</ObjTop>
<ObjType>person</ObjType>
<OriImageSigned>...</OriImageSigned>
<OrigImage>...</OrigImage>
<Score>0.89514667</Score>
<Sex>1</Sex>
<SexScore>0.56595963</SexScore>
<TimeStamp>2019-09-01T18:00:00Z</TimeStamp>
<ClothColor>10</ClothColor>
<ClothColorScore>0.7773359</ClothColorScore>
<ClothType>1</ClothType>
<ClothTypeScore>0.32749894</ClothTypeScore>
</Image>
</Images>
</SearchImagesResponse>
JSON
格式
{
"PageNumber": "1",
"TotalCount": "4000",
"PageSize": "1",
"RequestId": "E175B041-75A2-4335-B3AC-0FD008F93627",
"Images": {
"Image": [
{
"CameraId": "301",
"CropImage": "...",
"CropImageSigned": "...",
"EntryTime": "2019-09-01T18:00:00Z",
"ExtImage": null,
"Feature": "",
"Hair": 1,
"HairScore": 0.7153491,
"ImageId": "9771a825f344a0a21ac9a443e2350c6d",
"LeaveTime": "2019-09-01T18:00:00Z",
"TrouserColor": 9,
"TrouserColorScore": 0.582683,
"TrouserType": 2,
"TrouserTypeScore": 0.82184184,
"ObjBottom": 1068,
"ObjLeft": 1630,
"ObjRight": 1774,
"ObjTop": 863,
"ObjType": "person",
"OriImageSigned": "...",
"OrigImage": "...",
"Score": "0.89514667",
"Sex": 1,
"SexScore": 0.56595963,
"TimeStamp": "2019-09-01T18:00:00Z",
"ClothColor": 10,
"ClothColorScore": 0.7773359,
"ClothType": 1,
"ClothTypeScore": 0.32749894
}
]
}
}
錯誤碼
HttpCode | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
404 | InvalidCameraIds.NotFound | The specified CameraIds does not exist. | 指定的視頻點位不存在。 |
404 | InvalidImageIds.NotFound | The specified image does not exist. | 指定的圖片不存在。 |
400 | InvalidType.ValueNotSupported | The specified Type is invalid. | 指定的Type不合法。 |
400 | InvalidAttribute.KeyNotSupported | The specified Attribute.n.Key is invalid. | 指定的Attribute.n.Key不合法。 |
400 | InvalidFrom.ValueNotSupported | The specified From is invalid. | 指定的From不合法。 |
400 | InvalidSize.ValueNotSupported | The specified Size is invalid. | 指定的Size不合法。 |
400 | InvalidAttribute.KeyIsEmpty | You must specify Attribute.n.Key. | 指定的Attribute.n.Key不允許為空。 |
400 | InvalidAttribute.ValueNotSupported | The specified Attribute.n.Value is invalid. | 指定的Attribute.n.Value不合法。 |
400 | InvalidContents.Malformed | The specified Contents is incorrectly formatted. | 指定的Contents格式不合法。 |
訪問錯誤中心查看更多錯誤碼。