search_face.go

package imm

//Licensed under the Apache License, Version 2.0 (the "License");
//you may not use this file except in compliance with the License.
//You may obtain a copy of the License at
//
//http://www.apache.org/licenses/LICENSE-2.0
//
//Unless required by applicable law or agreed to in writing, software
//distributed under the License is distributed on an "AS IS" BASIS,
//WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//See the License for the specific language governing permissions and
//limitations under the License.
//
// Code generated by Alibaba Cloud SDK Code Generator.
// Changes may cause incorrect behavior and will be lost if the code is regenerated.

import (
	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/requests"
	"github.com/aliyun/alibaba-cloud-sdk-go/sdk/responses"
)

// SearchFace invokes the imm.SearchFace API synchronously
// api document: https://help.aliyun.com/api/imm/searchface.html
func (client *Client) SearchFace(request *SearchFaceRequest) (response *SearchFaceResponse, err error) {
	response = CreateSearchFaceResponse()
	err = client.DoAction(request, response)
	return
}

// SearchFaceWithChan invokes the imm.SearchFace API asynchronously
// api document: https://help.aliyun.com/api/imm/searchface.html
// asynchronous document: https://help.aliyun.com/document_detail/66220.html
func (client *Client) SearchFaceWithChan(request *SearchFaceRequest) (<-chan *SearchFaceResponse, <-chan error) {
	responseChan := make(chan *SearchFaceResponse, 1)
	errChan := make(chan error, 1)
	err := client.AddAsyncTask(func() {
		defer close(responseChan)
		defer close(errChan)
		response, err := client.SearchFace(request)
		if err != nil {
			errChan <- err
		} else {
			responseChan <- response
		}
	})
	if err != nil {
		errChan <- err
		close(responseChan)
		close(errChan)
	}
	return responseChan, errChan
}

// SearchFaceWithCallback invokes the imm.SearchFace API asynchronously
// api document: https://help.aliyun.com/api/imm/searchface.html
// asynchronous document: https://help.aliyun.com/document_detail/66220.html
func (client *Client) SearchFaceWithCallback(request *SearchFaceRequest, callback func(response *SearchFaceResponse, err error)) <-chan int {
	result := make(chan int, 1)
	err := client.AddAsyncTask(func() {
		var response *SearchFaceResponse
		var err error
		defer close(result)
		response, err = client.SearchFace(request)
		callback(response, err)
		result <- 1
	})
	if err != nil {
		defer close(result)
		callback(nil, err)
		result <- 0
	}
	return result
}

// SearchFaceRequest is the request struct for api SearchFace
type SearchFaceRequest struct {
	*requests.RpcRequest
	ResultNum            requests.Integer `position:"Query" name:"ResultNum"`
	Project              string           `position:"Query" name:"Project"`
	SearchThresholdLevel string           `position:"Query" name:"SearchThresholdLevel"`
	SrcUri               string           `position:"Query" name:"SrcUri"`
	IsThreshold          requests.Boolean `position:"Query" name:"IsThreshold"`
	GroupName            string           `position:"Query" name:"GroupName"`
}

// SearchFaceResponse is the response struct for api SearchFace
type SearchFaceResponse struct {
	*responses.BaseResponse
	RequestId   string            `json:"RequestId" xml:"RequestId"`
	ImageUri    string            `json:"ImageUri" xml:"ImageUri"`
	GroupName   string            `json:"GroupName" xml:"GroupName"`
	Glasses     int               `json:"Glasses" xml:"Glasses"`
	Hat         int               `json:"Hat" xml:"Hat"`
	Score       float64           `json:"Score" xml:"Score"`
	Axis        []string          `json:"Axis" xml:"Axis"`
	ResultFaces []ResultFacesItem `json:"ResultFaces" xml:"ResultFaces"`
}

// CreateSearchFaceRequest creates a request to invoke SearchFace API
func CreateSearchFaceRequest() (request *SearchFaceRequest) {
	request = &SearchFaceRequest{
		RpcRequest: &requests.RpcRequest{},
	}
	request.InitWithApiInfo("imm", "2017-09-06", "SearchFace", "imm", "openAPI")
	return
}

// CreateSearchFaceResponse creates a response to parse from SearchFace response
func CreateSearchFaceResponse() (response *SearchFaceResponse) {
	response = &SearchFaceResponse{
		BaseResponse: &responses.BaseResponse{},
	}
	return
}