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.
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 para
StartFaceSearch.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 o
TIMESTAMPpara agrupar rostos no momento em que elas são reconhecidas. Usar oINDEXpara classificar por rostos reconhecidos.Type: String
Valores válidos:
INDEX | TIMESTAMPObrigató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 para
StartFaceSearch. 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:
