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 destaque e menções, 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 uma URL da Wikipédia ( wikipedia_url ) e um MID do Knowledge Graph ( mid ), se disponíveis. Para os metadados associados a outros tipos de entidade, consulte a tabela Tipo abaixo.

Um objeto contendo 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 centralidade dessa entidade para todo o texto do documento. Pontuações próximas a 0 são menos salientes, enquanto pontuações próximas a 1,0 são altamente salientes.

mentions[]

object ( EntityMention )

As menções desta entidade no documento de entrada. A API atualmente suporta menções de nomes próprios.

sentiment

object ( Sentiment )

Para chamadas para [AnalyzeEntitySentiment][] ou se AnnotateTextRequest.Features.extract_entity_sentiment for definido como true, este campo conterá o sentimento agregado expresso para esta entidade no documento fornecido.

Tipo

O tipo da entidade. Para a maioria dos tipos de entidade, os metadados associados são uma URL da Wikipédia ( wikipedia_url ) e um MID do Knowledge Graph ( mid ). A tabela abaixo lista os campos associados para entidades que possuem metadados diferentes.

Enumerações
UNKNOWN Desconhecido
PERSON Pessoa
LOCATION Localização
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 quaisquer elementos adicionais que apareçam no texto:

  • number - o número real, dividido em seções de acordo com a convenção local
  • national_prefix - código do país, se detectado
  • area_code - região ou código de área, se detectado
  • extension - ramal telefônico (a ser discado após a conexão), se detectado
ADDRESS

Endereço

Os metadados identificam o número da rua e a localidade, além de quaisquer elementos adicionais que apareçam no texto:

  • street_number - número da rua
  • locality - cidade ou vila
  • street_name - nome da rua/rota, se detectado
  • postal_code - código postal, se detectado
  • country - país, se detectado<
  • broad_region - área administrativa, como o estado, se detectado
  • narrow_region - área administrativa menor, como um condado, se detectada
  • sublocality - usada em endereços asiáticos para demarcar um distrito dentro de uma cidade, se detectada
DATE

Data

Os metadados identificam os componentes da data:

  • year - ano de quatro dígitos, se detectado
  • month - número do mês de dois dígitos, se detectado
  • day - número do dia de dois dígitos, se detectado
NUMBER

Número

Os metadados são o próprio número.

PRICE

Preço

Os metadados identificam o value e currency .

Menção de Entidade

Representa uma menção a uma entidade no texto. Atualmente, são aceitas menções a nomes próprios.

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

object ( TextSpan )

O texto de menção.

type

enum ( Type )

O tipo de menção da entidade.

sentiment

object ( Sentiment )

Para chamadas para [AnalyzeEntitySentiment][] ou se AnnotateTextRequest.Features.extract_entity_sentiment for definido como true, este campo conterá o sentimento expresso para esta menção da entidade no documento fornecido.

Tipo

Os tipos de menções suportados.

Enumerações
TYPE_UNKNOWN Desconhecido
PROPER Nome próprio
COMMON Substantivo comum (ou substantivo composto)