搜索目标。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SearchTarget

系统规定参数。取值：SearchTarget。
CorpId String 是 44B0E0XXXX

项目ID，指定在哪个项目中搜索。
PageNumber Long 是 1

当前页码，最大不超过100。
PageSize Long 是 10

每页请求最大返回结果的数量，最大不超过100。
TargetType String 否 Face

搜索目标类型，可选值：

Face

Body

Motor

NonMotor

Event

AIoT

TargetAttributes String 否 [ { "Key":"HairColor", "Value":["4","1"], "Score":0.81 }, { "Key":"GenderCode", "Value":["1"], "Score":0.92 }]

搜索的属性，最多同时指定20个属性，多个属性需同时满足，才会返回结果。
TargetImageUrl String 否 http:/www.aliyun.com/file1

待搜索的图片url，url最长1024字符，对应图片最大500KB。
TargetImageData String 否 略

图片的Base64编码，最大500KB。
OrderBy String 否 [{"Key":"Timestamp","Type":"Asc"}]

按属性搜索才支持此字段，表示结果的排序方法，格式为{ "key": "排序规则"}。
DeviceList String 否 ["1C44674CC97AXXXX", "915E4ACA5866XXXX"]

设备ID列表，指定要在哪些设备产出的数据中搜索。
ModelId String 否 12345

设备ID对应使用的模型ID。
BeginTime String 否 2021-01-27T12:00:00Z

搜索的数据记录开始时间，需和结束时间配对使用，未配对则忽略。
EndTime String 否 2021-01-27T20:00:00Z

搜索的数据记录结束时间，需和开始时间配对使用，未配对则忽略。
SimilarityThreshold double 否 0.92

待搜索图片的相似度阈值，支持0.00, 0.99范围的小数。

返回数据

名称 类型 示例值 描述
RequestId String 46329898-489C-4E63-9BA1-C1DA5C5D0986

请求ID。
Success Boolean true

是否调用成功。
Code String 200

响应 code。
Message String OK

返回信息。
Data Object

返回结果数据。
Records Array of Record

数组。
TargetType String Face

目标类型，可选值：

Face

Body

Motor

NonMotor

Event

AIoT

Timestamp String 2021-09-14T12:00:00Z

目标出现的时间, 日期格式按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-ddTHH:mm:ssZ。
DeviceId String 001

产出该数据的设备ID。
TargetAttributes String [{"Key":"HairColor","Value":"1","Score":0.81},{"Key":"GenderCode","Value":"1","Score":0.92}]

查询到的目标属性信息, 仅返回查询条件中指定的属性。
TargetImageUrl String http:/www.aliyun.com/file2

目标图图片 url，该 url 可以直接通过 HTTP 协议访问到。
SourceImageUrl String http:/www.aliyun.com/file1

目标所在视频监控画面原始图片的url，该 url 可以直接通过 HTTP 协议访问到。
LeftTopX Long 10

目标图在原图上的左上角X轴坐标。
LeftTopY Long 10

目标图在原图上的左上角Y轴坐标。
RightBottomX Long 10

目标图在原图上的右下角X轴坐标。
RightBottomY Long 10

目标图在原图上的右下角Y轴坐标。
TargetImageSimilarity double 0.92

与待搜索目标图片的相似度。
TargetImageFullUrl String http:/www.aliyun.com/file2

完整的目标图片路径
SourceImageFullUrl String http:/www.aliyun.com/file2

完整的原图片路径
DataDetail String {"corpId":"123","deviceId":"123"}

结构化数据详情
TotalCount Long 30

结果总数量。
PageSize Long 10

分页大小。
PageNumber Long 1

返回第几个分页，从1开始。

示例

请求示例

http(s)://[Endpoint]/?Action=SearchTarget
&CorpId=44B0E0XXXX
&PageNumber=1
&PageSize=10
&TargetType=Face
&TargetAttributes=[	{  "Key":"HairColor", 	"Value":["4","1"], 	"Score":0.81	 }, 	{  "Key":"GenderCode",   "Value":["1"],   "Score":0.92 	}]
&TargetImageUrl=http:/www.aliyun.com/file1
&TargetImageData=略
&OrderBy=[{"Key":"Timestamp","Type":"Asc"}]
&DeviceList=["1C44674CC97AXXXX", "915E4ACA5866XXXX"]
&ModelId=12345
&BeginTime=2021-01-27T12:00:00Z
&EndTime=2021-01-27T20:00:00Z
&SimilarityThreshold=0.92
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SearchTargetResponse>
    <RequestId>46329898-489C-4E63-9BA1-C1DA5C5D0986</RequestId>
    <Success>true</Success>
    <Code>200</Code>
    <Message>OK</Message>
    <Data>
        <Records>
            <TargetType>Face</TargetType>
            <Timestamp>2021-09-14T12:00:00Z</Timestamp>
            <DeviceId>001</DeviceId>
            <TargetAttributes>[{"Key":"HairColor","Value":"1","Score":0.81},{"Key":"GenderCode","Value":"1","Score":0.92}]</TargetAttributes>
            <TargetImageUrl>http:/www.aliyun.com/file2</TargetImageUrl>
            <SourceImageUrl>http:/www.aliyun.com/file1</SourceImageUrl>
            <LeftTopX>10</LeftTopX>
            <LeftTopY>10</LeftTopY>
            <RightBottomX>10</RightBottomX>
            <RightBottomY>10</RightBottomY>
            <TargetImageSimilarity>0.92</TargetImageSimilarity>
        </Records>
        <TotalCount>30</TotalCount>
        <PageSize>10</PageSize>
        <PageNumber>1</PageNumber>
    </Data>
</SearchTargetResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "46329898-489C-4E63-9BA1-C1DA5C5D0986",
  "Success" : true,
  "Code" : "200",
  "Message" : "OK",
  "Data" : {
    "Records" : [ {
      "TargetType" : "Face",
      "Timestamp" : "2021-09-14T12:00:00Z",
      "DeviceId" : "001",
      "TargetAttributes" : "[{\"Key\":\"HairColor\",\"Value\":\"1\",\"Score\":0.81},{\"Key\":\"GenderCode\",\"Value\":\"1\",\"Score\":0.92}]",
      "TargetImageUrl" : "http:/www.aliyun.com/file2",
      "SourceImageUrl" : "http:/www.aliyun.com/file1",
      "LeftTopX" : 10,
      "LeftTopY" : 10,
      "RightBottomX" : 10,
      "RightBottomY" : 10,
      "TargetImageSimilarity" : 0.92
    } ],
    "TotalCount" : 30,
    "PageSize" : 10,
    "PageNumber" : 1
  }
}

错误码

访问错误中心查看更多错误码。