GetFaceSearch - Amazon Rekognition

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

GetFaceSearch

Obtém os resultados da pesquisa de faces do Amazon Rekognition Video iniciada porStartFaceSearch. A pesquisa retorna faces em uma coleção que correspondem às faces de pessoas detectadas em um vídeo. Ele também inclui a (s) hora (s) em que as faces são combinadas no vídeo.

A pesquisa de faces do em um vídeo é uma operação assíncrona. Você inicia a pesquisa facial ligando paraStartFaceSearchque retorna um identificador de trabalho (JobId). Quando a operação de pesquisa termina, o Amazon Rekognition Video publica um status de conclusão no tópico do Amazon Simple Notification Service registrado na chamada inicial paraStartFaceSearch. Para obter os resultados da pesquisa, primeiro verifique se o valor de status publicado no tópico do Amazon SNS éSUCCEEDED. Em caso afirmativo, ligueGetFaceSearche passar o identificador de trabalho (JobId) da chamada inicial paraStartFaceSearch.

Para obter mais informações, consulte Pesquisando rostos em uma coleção.

Os resultados da pesquisa são retratados em uma matriz,Persons, dePersonMatchobjetos. EACHPersonMatchO elemento contém detalhes sobre as faces correspondentes na coleção de entrada, informações de pessoas (atributos faciais, caixas delimitadoras e identificador de pessoa) da pessoa correspondente, e a hora em que a pessoa foi correspondida no vídeo.

nota

GetFaceSearchretorna apenas os atributos faciais padrão (BoundingBox,Confidence,Landmarks,Pose, eQuality). Os outros atributos faciais listados naFaceobjeto da seguinte sintaxe de resposta não é retornado. Para obter mais informações, consulte FaceDetail.

Por padrão, oPersonsé classificado pelo tempo, em milissegundos a partir do início do vídeo, em que as pessoas foram correspondidas. Você também pode classificar por pessoas especificandoINDEXpara aSORTBYParâmetros de entrada.

Sintaxe da solicitação

{ "JobId": "string", "MaxResults": number, "NextToken": "string", "SortBy": "string" }

Parâmetros de solicitação

A solicitação aceita os dados a seguir no formato JSON.

JobId

O identificador de trabalho para a solicitação de pesquisa. Você obtém o identificador de trabalho de uma chamada inicial paraStartFaceSearch.

Type: String

Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 64.

Padrão: ^[a-zA-Z0-9-_]+$

Obrigatório: Sim

MaxResults

O número máximo de resultados a serem retornados por chamada paginada. O maior valor que você pode especificar é 1000. Se você especificar um valor maior que 1000, um máximo de 1000 resultados será retornado. O valor padrão é 1000.

Type: Inteiro

Intervalo válido: Valor mínimo de 1.

Obrigatório: Não

NextToken

Se a resposta anterior estiver incompleta (porque há mais resultados de pesquisa a serem recuperados), o Amazon Rekognition Video retornará um token de paginação na resposta. Você pode usar esse token de paginação para recuperação do próximo conjunto de resultados da pesquisa.

Type: String

Restrições de comprimento: Tamanho máximo de 255.

Obrigatório: Não

SortBy

Classifique a ser usado para agrupar faces na resposta. Usar oTIMESTAMPpara agrupar rostos no momento em que elas são reconhecidas. Usar oINDEXpara classificar por rostos reconhecidos.

Type: String

Valores válidos: INDEX | TIMESTAMP

Obrigatório: Não

Sintaxe da resposta

{ "JobStatus": "string", "NextToken": "string", "Persons": [ { "FaceMatches": [ { "Face": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Confidence": number, "ExternalImageId": "string", "FaceId": "string", "ImageId": "string", "IndexFacesModelVersion": "string" }, "Similarity": number } ], "Person": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Face": { "AgeRange": { "High": number, "Low": number }, "Beard": { "Confidence": number, "Value": boolean }, "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Confidence": number, "Emotions": [ { "Confidence": number, "Type": "string" } ], "Eyeglasses": { "Confidence": number, "Value": boolean }, "EyesOpen": { "Confidence": number, "Value": boolean }, "Gender": { "Confidence": number, "Value": "string" }, "Landmarks": [ { "Type": "string", "X": number, "Y": number } ], "MouthOpen": { "Confidence": number, "Value": boolean }, "Mustache": { "Confidence": number, "Value": boolean }, "Pose": { "Pitch": number, "Roll": number, "Yaw": number }, "Quality": { "Brightness": number, "Sharpness": number }, "Smile": { "Confidence": number, "Value": boolean }, "Sunglasses": { "Confidence": number, "Value": boolean } }, "Index": number }, "Timestamp": number } ], "StatusMessage": "string", "VideoMetadata": { "Codec": "string", "ColorRange": "string", "DurationMillis": number, "Format": "string", "FrameHeight": number, "FrameRate": number, "FrameWidth": number } }

Elementos de resposta

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

JobStatus

O status atual do trabalho de pesquisa facial.

Type: String

Valores válidos: IN_PROGRESS | SUCCEEDED | FAILED

NextToken

Se a resposta for truncada, o Amazon Rekognition Video retornará esse token que você pode usar na solicitação subsequente para recuperar o próximo conjunto de resultados de pesquisa.

Type: String

Restrições de comprimento: Tamanho máximo de 255.

Persons

Uma matriz de pessoas,PersonMatch, no vídeo cujas faces correspondem à (s) face (s) em uma coleção do Amazon Rekognition. Também inclui informações de tempo para quando as pessoas são combinadas no vídeo. Você especifica a coleção de entrada em uma chamada inicial paraStartFaceSearch. EACHPersonselemento inclui uma hora em que a pessoa foi correspondida, detalhes da correspondência facial (FaceMatches) para correspondência de rostos na coleção e informações sobre pessoas (Person) para a pessoa combinada.

Type: Uma matriz dePersonMatchobjetos

StatusMessage

Se o trabalho falhar,StatusMessagefornece uma mensagem de erro descritiva.

Type: String

VideoMetadata

Informações sobre um vídeo analisado pelo Amazon Rekognition.Videometadataé retornado em todas as páginas de respostas paginadas de uma operação do Amazon Rekognition Video.

Tipo: objeto VideoMetadata

Erros

AccessDeniedException

Você não está autorizado a executar a ação.

Código de status HTTP: 400

InternalServerError

O Amazon Rekognition teve um problema de serviço. Tente fazer a chamada novamente.

Código de status HTTP: 500

InvalidPaginationTokenException

O token de paginação na solicitação não é válido.

Código de status HTTP: 400

InvalidParameterException

Um parâmetro de entrada violou uma restrição. Valide seu parâmetro antes de chamar a operação de API novamente.

Código de status HTTP: 400

ProvisionedThroughputExceededException

O número de solicitações excedeu o limite da taxa de transferência. Se precisar aumentar esse limite, entre em contato com o Amazon Rekognition.

Código de status HTTP: 400

ResourceNotFoundException

O recurso especificado na solicitação não pode ser encontrado.

Código de status HTTP: 400

ThrottlingException

O Amazon Rekognition está temporariamente indisponível para processar a solicitação. Tente fazer a chamada novamente.

Código de status HTTP: 500

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: