Entité

Représente une expression dans le texte qui est une entité connue, telle qu'une personne, une organisation ou un lieu. L'API associe aux entités des informations telles que la saillance et les mentions.

Représentation JSON 

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

string

Nom représentatif de l'entité.

type

enum(Type)

Type de l'entité.

metadata

map (key: string, value: string)

Métadonnées associées à l'entité.

Pour la plupart des types d'entités, les métadonnées sont des URL Wikipédia (wikipedia_url) et des MID Knowledge Graph (mid), si elles sont disponibles. Pour les métadonnées associées aux autres types d'entités, consultez le tableau "Type" ci-dessous.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
salience

number

Score de saillance associé à l'entité, situé dans l'intervalle [0, 1,0].

Le score de saillance d'une entité fournit des informations sur l'importance ou la centralité de cette entité par rapport au texte dans son ensemble. Les scores plus proches de 0 correspondent à une saillance moindre, alors que les scores plus proches de 1,0 correspondent à une saillance élevée.
mentions[]

object(EntityMention)

Mentions de cette entité dans le document d'entrée. L'API accepte actuellement les mentions de noms propres.

sentiment

object(Sentiment)

Pour les appels à [documents.analyzeEntitySentiment][] ou si AnnotateTextRequest.Features.extract_entity_sentiment est défini sur "true", ce champ contient le sentiment agrégé exprimé pour cette entité dans le document fourni.

Type

Type d'entité. Pour la plupart des types d'entités, les métadonnées sont des URL Wikipédia (wikipedia_url) et des MID Knowledge Graph (mid), si elles sont disponibles. Le tableau ci-dessous répertorie les champs associés pour les entités ayant des métadonnées différentes.

Enums
UNKNOWN Inconnu
PERSON Personne
LOCATION Emplacement
ORGANIZATION Organisation
EVENT Événement
WORK_OF_ART Œuvre d'art
CONSUMER_GOOD Produit grand public
OTHER Autres types d'entités
PHONE_NUMBER

Numéro de téléphone

Les métadonnées contiennent le numéro de téléphone, au format local standard, ainsi que les éléments supplémentaires figurant dans le texte :

  • number : le numéro de téléphone proprement dit, divisé en sections conformément à la convention locale
  • national_prefix : code pays, le cas échéant
  • area_code : indicatif de région ou de zone, le cas échéant
  • extension : extension téléphonique (à composer après connexion), le cas échéant
ADDRESS

Adresse

Les métadonnées identifient le numéro de rue, la localité, ainsi que les éléments supplémentaires figurant dans le texte :

  • street_number : numéro de rue
  • locality : ville
  • street_name : nom de la rue/route, le cas échéant
  • postal_code : code postal, le cas échéant
  • country : pays, le cas échéant
  • broad_region : zone administrative, telle qu'un État, le cas échéant
  • narrow_region : zone administrative plus petite, telle qu'un comté, le cas échéant
  • sublocality : utilisée dans les adresses asiatiques pour identifier un quartier dans une ville, le cas échéant
DATE

Date

Les métadonnées identifient les composants de la date :

  • year : année à quatre chiffres, le cas échéant
  • month : numéro de mois à deux chiffres, le cas échéant
  • day : numéro du jour à deux chiffres, le cas échéant
NUMBER

Nombre

Les métadonnées sont le nombre lui-même.
PRICE

Prix

Les métadonnées identifient la valeur value et la devisecurrency.

EntityMention

Représente une mention d'une entité dans le texte. Actuellement, les mentions de noms propres sont acceptées.

Représentation JSON 

{
  "text": {
    object(TextSpan)
  },
  "type": enum(Type),
  "sentiment": {
    object(Sentiment)
  }
}
Champs
text

object(TextSpan)

Texte de la mention.

type

enum(Type)

Type de la mention d'entité.

sentiment

object(Sentiment)

Pour les appels à [documents.analyzeEntitySentiment][] ou si AnnotateTextRequest.Features.extract_entity_sentiment est défini sur "true", ce champ contient le sentiment exprimé pour cette mention de l'entité dans le document fourni.

Type

Types de mentions acceptés.

Enums
TYPE_UNKNOWN Inconnu
PROPER Nom propre
COMMON Nom courant (ou composé)