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 saliência e referências, a entidades.

Representação JSON 

{
  "name": string,
  "type": enum(Type),
  "metadata": {
    string: string,
    ...
  },
  "salience": number,
  "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 a maioria dos tipos de entidade, os metadados são um URL da Wikipédia (wikipedia_url) e um MID do Mapa de informações (mid), se estiverem disponíveis. 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" }
salience

number

A pontuação de saliência associada à entidade no intervalo [0, 1.0].

A pontuação de saliência de uma entidade fornece informações sobre a importância ou a centralidade dela para o texto completo do documento. As pontuações próximas a 0 são menos salientes, enquanto as pontuações mais próximas a 1,0 são altamente relevantes.
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 [documents.analyzeEntitySentiment][] 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. Para a maioria dos tipos de entidade, os metadados associados são um URL da Wikipédia (wikipedia_url) e um MID do Mapa de informações (mid). 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)
  }
}
Campos
text

object(TextSpan)

O texto da referência.
type

enum(Type)

O tipo de referência à entidade.
sentiment

object(Sentiment)

Em chamadas para [documents.analyzeEntitySentiment][] 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.

Tipo

Os tipos de referência compatíveis.

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