Entity

Representa una frase en el texto que es una entidad conocida, como una persona, una organización o una ubicación. La API asocia información, como la importancia y las menciones, con las entidades.

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

string

Es el nombre del representante de la entidad.
type

enum (Type)

Es el tipo de entidad.
metadata

map (key: string, value: string)

Son los metadatos asociados con la entidad.

Para la mayoría de los tipos de entidades, los metadatos son una URL de Wikipedia (wikipedia_url) y un MID del Gráfico de conocimiento (mid), si están disponibles. Para ver los metadatos asociados con otros tipos de entidades, consulta la tabla de tipos que aparece a continuación.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
salience

number

Es la puntuación de relevancia asociada con la entidad en el rango [0, 1.0].

La puntuación de importancia de una entidad proporciona información sobre la importancia o centralidad de esa entidad para todo el texto del documento. Las puntuaciones más cercanas a 0 son menos importantes, mientras que las puntuaciones más cercanas a 1.0 son muy importantes.
mentions[]

object (EntityMention)

Las menciones de esta entidad en el documento de entrada. Actualmente, la API admite menciones de nombres propios.
sentiment

object (Sentiment)

En el caso de las llamadas a AnalyzeEntitySentimentRequest o si AnnotateTextRequest.Features.extract_entity_sentiment se establece como verdadero, este campo contendrá el sentimiento agregado expresado para esta entidad en el documento proporcionado.

Tipo

Es el tipo de entidad. Para la mayoría de los tipos de entidades, los metadatos asociados son una URL de Wikipedia (wikipedia_url) y un MID del Gráfico de conocimiento (mid). En la siguiente tabla, se enumeran los campos asociados para las entidades que tienen metadatos diferentes.

Enums
UNKNOWN Desconocido
PERSON Persona
LOCATION Ubicación
ORGANIZATION Organización
EVENT Evento
WORK_OF_ART Obra de arte
CONSUMER_GOOD Producto para usuarios finales
OTHER Otros tipos de entidades
PHONE_NUMBER

Número de teléfono

En los metadatos, se indica el número de teléfono, con el formato que corresponda según la convención local, además de los elementos adicionales que aparezcan en el texto:

  • number: Es el número real, desglosado en secciones según la convención local.
  • national_prefix: Código de país, si se detecta
  • area_code: Código de región o área, si se detecta
  • extension: Extensión telefónica (para marcar después de la conexión), si se detecta
ADDRESS

Dirección

Los metadatos identifican el número de calle y la localidad, además de los elementos adicionales que aparecen en el texto:

  • street_number: Número de la calle
  • locality: Ciudad o pueblo
  • street_name: Nombre de la calle o ruta, si se detecta
  • postal_code: Código postal, si se detecta
  • country: País, si se detecta<
  • broad_region: Área administrativa, como el estado, si se detecta
  • narrow_region: Área administrativa más pequeña, como un condado, si se detecta
  • sublocality: Se usa en direcciones asiáticas para demarcar un distrito dentro de una ciudad, si se detecta.
DATE

Fecha

Los metadatos identifican los componentes de la fecha:

  • year: Año de cuatro dígitos, si se detecta
  • month: Número de mes de dos dígitos, si se detecta
  • day: Número de día de dos dígitos, si se detecta
NUMBER

Número

Los metadatos son el número en sí.
PRICE

Precio

Los metadatos identifican value y currency.

EntityMention

Representa una mención de una entidad en el texto. Actualmente, se admiten menciones de nombres propios.

Representación JSON 
{
  "text": {
    object (TextSpan)
  },
  "type": enum (Type),
  "sentiment": {
    object (Sentiment)
  }
}
Campos
text

object (TextSpan)

El texto de la mención.
type

enum (Type)

Es el tipo de mención de entidad.
sentiment

object (Sentiment)

En el caso de las llamadas a AnalyzeEntitySentimentRequest o si AnnotateTextRequest.Features.extract_entity_sentiment se establece como verdadero, este campo contendrá el sentimiento expresado para esta mención de la entidad en el documento proporcionado.

Tipo

Los tipos de menciones admitidos

Enums
TYPE_UNKNOWN Desconocido
PROPER Nombre propio
COMMON Sustantivo común (o compuesto)