Método: projects.locations.models.predict

Não usado para o rastreamento de objetos do AutoML Video Intelligence.

Solicitação HTTP

POST https://automl.googleapis.com/v1beta1/{name}:predict

Parâmetros de caminho

Parâmetros
name

string

Nome do modelo solicitado para disponibilizar a predição.

A autorização requer a seguinte permissão do Google IAM no recurso name especificado:

  • automl.models.predict

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 

{
  "payload": {
    object(ExamplePayload)
  },
  "params": {
    string: string,
    ...
  }
}
Campos
payload

object(ExamplePayload)

Obrigatório. Payload para realizar uma previsão. O payload precisa corresponder ao tipo de problema que o modelo foi treinado para resolver.

params

map (key: string, value: string)

Outros parâmetros específicos de domínio, qualquer string precisa ter até 25.000 caracteres de comprimento.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Mensagem de resposta de PredictionService.Predict.

Representação JSON 

{
  "payload": [
    {
      object(AnnotationPayload)
    }
  ],
  "metadata": {
    string: string,
    ...
  }
}
Campos
payload[]

object(AnnotationPayload)

Resultado da predição.

metadata

map (key: string, value: string)

Outros metadados de resposta de predição específica do domínio.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte a Visão geral da autenticação.

ExamplePayload

Dados de exemplo usados em treinamento ou predição.

AnnotationPayload

Contém informações de anotação relevantes para AutoML.

Representação JSON 

{
  "annotationSpecId": string,
  "displayName": string,

  // Union field detail can be only one of the following:
  "classification": {
    object(ClassificationAnnotation)
  },
  "videoObjectTracking": {
    object(VideoObjectTrackingAnnotation)
  }
  // End of list of possible types for union field detail.
}
Campos
annotationSpecId

string

Apenas saída. O código do recurso da especificação de anotação a que essa anotação pertence. A especificação de anotação vem de um conjunto de dados ancestral ou do conjunto de dados que foi usado para treinar o modelo em uso.

displayName

string

Apenas saída. O valor de AnnotationSpec.display_name quando o modelo foi treinado. Como esse campo retorna um valor no tempo de treinamento de modelo, para modelos diferentes treinados usando o mesmo conjunto de dados, o valor retornado pode ser diferente, porque o proprietário do modelo pode atualizar o displayName entre dois treinamentos de modelo quaisquer.

Campo de união detail. Apenas saída. Informações adicionais sobre a anotação específica da solução AutoML. detail só pode ser um destes:
classification

object(ClassificationAnnotation)

Não usado para o rastreamento de objetos do AutoML Video Intelligence.

videoObjectTracking

object(VideoObjectTrackingAnnotation)

Detalhes da anotação para predições de rastreamento de objetos.

ClassificationAnnotation

Contém detalhes da anotação específicos à classificação.

Representação JSON 

{
  "score": number
}
Campos
score

number

Apenas saída. Uma estimativa de confiança entre 0,0 e 1,0. Um valor mais alto significa mais confiança de que a anotação seja positiva. Se um usuário aprovar uma anotação como negativa ou positiva, o valor da pontuação permanecerá inalterado. Se um usuário criar uma anotação, o valor será 0 para negativo ou 1 para positivo.

VideoObjectTrackingAnnotation

Detalhes de anotação para rastreamento de objetos de vídeo.

Representação JSON 

{
  "instanceId": string,
  "timeOffset": string,
  "boundingBox": {
    object(BoundingPoly)
  },
  "score": number
}
Campos
instanceId

string

Opcional. A instância do objeto, expressa como um inteiro positivo. Usado para distinguir objetos do mesmo tipo (isto é, AnnotationSpec) quando vários estão presentes em um único exemplo. OBSERVAÇÃO: a qualidade de predição do código da instância não faz parte da avaliação do modelo e é feita como o melhor esforço. Especialmente nos casos em que uma entidade sai da tela por mais tempo (minutos), quando ela volta, pode receber um novo código de instância.

timeOffset

string (formato Duration)

Obrigatório. Um tempo (frame) de um vídeo ao qual esta anotação pertence. Representado como a duração desde o início do vídeo.

A duração em segundos com até nove dígitos fracionais que termina com “s”. Exemplo: "3.5s".
boundingBox

object(BoundingPoly)

Obrigatório. O retângulo que representa o local do objeto no frame (ou seja, no timeOffset do vídeo).

score

number

Apenas saída. A confiança de que essa anotação é positiva para o vídeo no timeOffset, valor em [0, 1], maior significa maior confiança na positividade. Para anotações criadas pelo usuário, o valor é 1. Quando o usuário aprova uma anotação, o valor flutuante original é mantido e não é alterado para 1.

BoundingPoly

Um polígono delimitador de um objeto detectado em um plano. Na saída, são fornecidos ambos os vértices e normalizedVertices. O polígono é formado com a conexão dos vértices na ordem em que estão listados.

Representação JSON 

{
  "normalizedVertices": [
    {
      object(NormalizedVertex)
    }
  ]
}
Campos
normalizedVertices[]

object(NormalizedVertex)

Apenas saída. Os vértices normalizados do polígono delimitador.

NormalizedVertex

Um vértice representa um ponto 2D na imagem. As coordenadas do vértice normalizado estão entre 0 e 1 frações em relação ao plano original (imagem, vídeo). Por exemplo, se o plano (exemplo, imagem inteira) tivesse tamanho 10 x 20, então um ponto com coordenadas normalizadas (0,1, 0,3) estaria na posição (1, 6) naquele plano.

Representação JSON 

{
  "x": number,
  "y": number
}
Campos
x

number

Obrigatório. Coordenada horizontal.

y

number

Obrigatório. Coordenada vertical.