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 probabilidad y las menciones, con las entidades.

Representación JSON 
{
  "name": string,
  "type": enum (Type),
  "metadata": {
    string: string,
    ...
  },
  "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 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" }.
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. 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 consumidores
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 según la convención local, además de los elementos adicionales que aparecen 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)
  },
  "probability": number
}
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.
probability

number

Puntuación de probabilidad asociada con la entidad.

La puntuación muestra la probabilidad de que la mención de la entidad sea el tipo de entidad. La puntuación está en el rango [0, 1].

Tipo

Los tipos de menciones admitidos

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