Entity

Rappresenta una frase nel testo che è un'entità nota, ad esempio una persona, un'organizzazione o una località. L'API associa informazioni, come la salienza e le menzioni, alle entità.

Rappresentazione JSON 
{
  "name": string,
  "type": enum (Type),
  "metadata": {
    string: string,
    ...
  },
  "salience": number,
  "mentions": [
    {
      object (EntityMention)
    }
  ],
  "sentiment": {
    object (Sentiment)
  }
}
Campi
name

string

Il nome rappresentativo dell'entità.
type

enum (Type)

Il tipo di entità.
metadata

map (key: string, value: string)

Metadati associati all'entità.

Per la maggior parte dei tipi di entità, i metadati sono un URL di Wikipedia (wikipedia_url) e un MID Knowledge Graph (mid), se disponibili. Per i metadati associati ad altri tipi di entità, consulta la tabella Tipo di seguito.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
salience

number

Il punteggio di salienza associato all'entità nell'intervallo [0, 1,0].

Il punteggio di salienza di un'entità fornisce informazioni sull'importanza o sulla centralità dell'entità rispetto al testo dell'intero documento. I punteggi più vicini a 0 sono meno salienti, mentre quelli più vicini a 1,0 sono molto salienti.
mentions[]

object (EntityMention)

Le menzioni di questa entità nel documento di input. Al momento l'API supporta le menzioni di nomi propri.
sentiment

object (Sentiment)

Per le chiamate a AnalyzeEntitySentimentRequest o se AnnotateTextRequest.Features.extract_entity_sentiment è impostato su true, questo campo conterrà il sentiment aggregato espresso per questa entità nel documento fornito.

Tipo

Il tipo di entità. Per la maggior parte dei tipi di entità, i metadati associati sono un URL di Wikipedia (wikipedia_url) e un MID Knowledge Graph (mid). La tabella seguente elenca i campi associati per le entità con metadati diversi.

Enum
UNKNOWN Sconosciuto
PERSON Persona
LOCATION Località
ORGANIZATION Organizzazione
EVENT Evento
WORK_OF_ART Opera d'arte
CONSUMER_GOOD Prodotto di consumo
OTHER Altri tipi di entità
PHONE_NUMBER

Numero di telefono

I metadati elencano il numero di telefono, formattato in base alle convenzioni locali, oltre a eventuali elementi aggiuntivi visualizzati nel testo:

  • number: il numero effettivo, suddiviso in sezioni in base alle convenzioni locali
  • national_prefix - codice paese, se rilevato
  • area_code - regione o prefisso, se rilevato
  • extension - estensione telefonica (da comporre dopo la connessione), se rilevata
ADDRESS

Indirizzo

I metadati identificano il numero civico e la località, oltre a eventuali elementi aggiuntivi visualizzati nel testo:

  • street_number - numero civico
  • locality - città
  • street_name - nome della via/della strada, se rilevato
  • postal_code - codice postale, se rilevato
  • country - country, if detected<
  • broad_region - area amministrativa, ad esempio la provincia, se rilevata
  • narrow_region - area amministrativa più piccola, ad esempio una contea, se rilevata
  • sublocality: se rilevato, viene utilizzato negli indirizzi asiatici per delimitare un quartiere all'interno di una città
DATE

Data

I metadati identificano i componenti della data:

  • year - anno a quattro cifre, se rilevato
  • month: numero del mese a due cifre, se rilevato
  • day - numero di giorno a due cifre, se rilevato
NUMBER

Numero

I metadati sono il numero stesso.
PRICE

Prezzo

I metadati identificano value e currency.

EntityMention

Rappresenta una menzione di un'entità nel testo. Al momento sono supportate le menzioni di nomi propri.

Rappresentazione JSON 
{
  "text": {
    object (TextSpan)
  },
  "type": enum (Type),
  "sentiment": {
    object (Sentiment)
  }
}
Campi
text

object (TextSpan)

Il testo della menzione.
type

enum (Type)

Il tipo di menzione dell'entità.
sentiment

object (Sentiment)

Per le chiamate a AnalyzeEntitySentimentRequest o se AnnotateTextRequest.Features.extract_entity_sentiment è impostato su true, questo campo conterrà il sentiment espresso per questa menzione della persona giuridica nel documento fornito.

Tipo

I tipi di menzioni supportati.

Enum
TYPE_UNKNOWN Sconosciuto
PROPER Nome proprio
COMMON Nome comune (o nome composto)