調用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

查詢類型。根據算法不同查詢不同的類型,天擎算法查詢類型示例:

  • person(行人)
  • bicycle (非機動?)
  • vehicle(機動?)
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”時,年齡類型置信度, 取值范圍[0,1]

Brand String DZ

當ObjType為“Vehicle”時,車輛品牌。

BrandScore Float 0.89

當ObjType為“Vehicle”時,車輛品牌置信度, 取值范圍[0,1]

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”時,上衣顏色置信度, 取值范圍[0,1]

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”時,頭發類型置信度, 取值范圍[0,1]

HeadWear String Hat

當ObjType為“NonVehicle”時,騎車人頭飾,取值范圍:

* None: 無

* Hat: 帽子

* Helmet: 頭盔

* Scarf: 頭巾

* Other: 其他

HeadWearScore Float 0.6

當ObjType為“NonVehicle”時, 騎車人頭飾置信度, 取值范圍[0,1]

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”時,非機動車類型置信度, 取值范圍[0,1]

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”時, 身體姿態置信度, 取值范圍[0,1]

Score Float 0.3

圖片相似度得分。

SexType String Male

當ObjType為“Person”或“NonVehicle”時,性別,取值范圍:

* Male: 男

* Female: 女

* Uncertain: 不確定

SexTypeScore Float 0.5

當ObjType為“Person”時,性別置信度, 取值范圍[0,1]

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”時, 下衣顏色置信度, 取值范圍[0,1]

TrouserType String Trousers

當ObjType為“Person”時,下衣類型,取值范圍:

* Trousers: 長褲

* Shorts: 短褲

* Longuette: 長裙

* ShortSkirt: 短裙

* Other: 其他

TrouserTypeScore Float 0.3

當ObjType為“Person”時,下衣顏色置信度,取值范圍[0,1]

VehicleColor String Black

當ObjType為“Vehicle”時,車身顏色類型,取值范圍同ClothColor.

VehicleColorScore Float 0.9

當ObjType為“Vehicle”時,車身顏色置信度,取值范圍[0,1]

VehicleType String Van

當ObjType為“Vehicle”時,車輛類型,取值范圍:

* SUV: SUV

* Car: 小轎車

* Truck: 大貨車

* Van: 小貨車

* Taxi: 出租車

* Bus: 公交車

* Minibus: 面包車

* Machineshop: 工程車

VehicleTypeScore Float 0.7

當ObjType為“Vehicle”時,車輛類型置信度,取值范圍[0,1]

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格式不合法。

訪問錯誤中心查看更多錯誤碼。