Entity

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 probabilité et les mentions.

Représentation JSON 
{
  "name": string,
  "type": enum (Type),
  "metadata": {
    string: string,
    ...
  },
  "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 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" }.
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 à AnalyzeEntitySentimentRequest 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é. 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

Phone number

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

Address

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

Number

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

Price

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)
  },
  "probability": number
}
Champs
text

object (TextSpan)

Texte de la mention.
type

enum (Type)

Type de la mention d'entité.
sentiment

object (Sentiment)

Pour les appels à AnalyzeEntitySentimentRequest 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.
probability

number

Score de probabilité associé à l'entité.

Le score indique la probabilité que la mention d'entité corresponde au type d'entité. Le score est compris dans la plage (0, 1].

Type

Types de mentions acceptés.

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