Entity

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

Rappresentazione JSON 
{
  "name": string,
  "type": enum (Type),
  "metadata": {
    string: string,
    ...
  },
  "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 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" }.
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à. 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 - paese, se rilevato
  • 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)
  },
  "probability": number
}
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.
probability

number

Punteggio di probabilità associato all'entità.

Il punteggio mostra la probabilità che la menzione dell'entità corrisponda al tipo di entità. Il punteggio è compreso nell'intervallo [0, 1].

Tipo

I tipi di menzioni supportati.

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