Entity

Representa uma frase no texto que é uma entidade conhecida, como uma pessoa, uma organização ou um local. A API associa informações, como probabilidade e menções, a entidades.

Representação JSON 
{
  "name": string,
  "type": enum (Type),
  "metadata": {
    string: string,
    ...
  },
  "mentions": [
    {
      object (EntityMention)
    }
  ],
  "sentiment": {
    object (Sentiment)
  }
}
Campos
name

string

O nome representativo da entidade.
type

enum (Type)

O tipo de entidade.
metadata

map (key: string, value: string)

Metadados associados à entidade.

Para os metadados associados a outros tipos de entidade, consulte a tabela "Tipo" abaixo.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
mentions[]

object (EntityMention)

As referências à entidade no documento de entrada. Atualmente, a API é compatível com referências a nomes próprios.
sentiment

object (Sentiment)

Em chamadas para AnalyzeEntitySentimentRequest ou se AnnotateTextRequest.Features.extract_entity_sentiment estiver definido como verdadeiro, esse campo conterá o sentimento agregado expresso para a entidade no documento fornecido.

Tipo

O tipo de entidade. A tabela abaixo lista os campos associados a entidades com metadados diferentes.

Enums
UNKNOWN Desconhecido
PERSON Pessoa
LOCATION Local
ORGANIZATION Organização
EVENT Evento
WORK_OF_ART Obra de arte
CONSUMER_GOOD Produto de consumo
OTHER Outros tipos de entidades
PHONE_NUMBER

Número de telefone

Os metadados listam o número de telefone, formatado de acordo com a convenção local, além de outros elementos que aparecem no texto:

  • number: o número real, dividido em seções de acordo com a convenção local
  • national_prefix: código de país, se detectado
  • area_code: código de região ou área, se detectado
  • extension: extensão de telefone (a ser discada após a conexão), se detectada
ADDRESS

Endereço

Os metadados identificam o número da rua e a localidade, além dos outros elementos exibidos no texto:

  • street_number - Número do endereço
  • locality - Cidade ou município
  • street_name: nome da rua/rota, se detectado
  • postal_code: CEP, se detectado
  • country: país, se detectado
  • broad_region: área administrativa, como o estado, se detectado
  • narrow_region: área administrativa menor, como condado, se detectada
  • sublocality - usado em endereços asiáticos para marcar um distrito dentro de uma cidade, se detectado
DATE

Data

Os metadados identificam os componentes da data:

  • year: ano de quatro dígitos, se detectado
  • month - número de dois dígitos, se detectado
  • day: número de dois dígitos, se detectado
NUMBER

Número

Os metadados são os números em si.
PRICE

Preço

Os metadados identificam value e currency.

EntityMention

Representa uma referência a uma entidade no texto. Atualmente, as referências a nomes próprios são compatíveis.

Representação JSON 
{
  "text": {
    object (TextSpan)
  },
  "type": enum (Type),
  "sentiment": {
    object (Sentiment)
  },
  "probability": number
}
Campos
text

object (TextSpan)

O texto da referência.
type

enum (Type)

O tipo de referência à entidade.
sentiment

object (Sentiment)

Em chamadas para AnalyzeEntitySentimentRequest ou se AnnotateTextRequest.Features.extract_entity_sentiment estiver definido como verdadeiro, esse campo conterá o sentimento expresso para a referência da entidade no documento fornecido.
probability

number

Pontuação de probabilidade associada à entidade.

A pontuação mostra a probabilidade de a menção de entidade ser o tipo de entidade. A pontuação está no intervalo (0, 1].

Tipo

Os tipos de referência compatíveis.

Enums
TYPE_UNKNOWN Desconhecido
PROPER Nome próprio
COMMON Substantivo comum (ou composto)