Entity

表示文本中已知实体（例如用户、组织或位置）的短语。API 会将显著性和提及等信息与实体关联。

JSON 表示法 
{
  "name": string,
  "type": enum (Type),
  "metadata": {
    string: string,
    ...
  },
  "salience": number,
  "mentions": [
    {
      object (EntityMention)
    }
  ],
  "sentiment": {
    object (Sentiment)
  }
}
字段
name

string

实体的代表性名称。
type

enum (Type)

实体类型。
metadata

map (key: string, value: string)

与实体关联的元数据。

对于大多数实体类型，元数据是维基百科网址 (wikipedia_url) 和知识图谱 MID (mid)（如果有）。对于与其他实体类型关联的元数据，请参阅下面的“类型”表。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
salience

number

在 [0, 1.0] 范围内的与实体关联的显著性得分。

通过实体的显著性得分，可了解该实体在整个文档文本中的重要性或向心性。分数接近 0 表示不太显著，而接近 1.0 则表示非常显著。
mentions[]

object (EntityMention)

输入文档中此实体的提及。API 目前支持专有名词提及。
sentiment

object (Sentiment)

对于对 AnalyzeEntitySentimentRequest 的调用，或者如果 AnnotateTextRequest.Features.extract_entity_sentiment 设置为 true，此字段将包含在提供的文档中对该实体表达的总体情感。

类型

实体的类型。对于大多数实体类型，关联的元数据是维基百科网址 (wikipedia_url) 和知识图谱 MID (mid)。下表列出了具有不同元数据的实体的关联字段。

枚举
UNKNOWN 未知
PERSON 用户
LOCATION 位置
ORGANIZATION 组织
EVENT 事件
WORK_OF_ART 艺术作品
CONSUMER_GOOD 消费类商品
OTHER 其他类型的实体
PHONE_NUMBER

电话号码

元数据列出根据当地惯例设置格式的电话号码，以及文本中出现的任何其他元素：

  • number - 实际数字，按照当地惯例分为多个部分
  • national_prefix - 国家/地区代码（如果检测到）
  • area_code - 地区或区域代码（如果检测到）
  • extension - 在连接后拨打的电话分机号（如果检测到）
ADDRESS

地址

元数据标识门牌号和市行政区，以及文本中出现的任何其他元素：

  • street_number - 门牌号
  • locality - 城市或城镇
  • street_name - 街道/路线名称（如果检测到）
  • postal_code - 邮政编码（如果检测到）
  • country - 国家/地区（如果检测到）
  • broad_region - 行政区，例如州（如果检测到）
  • narrow_region - 较小的行政区，例如县/郡（如果检测到）
  • sublocality - 在亚洲地址中用于区分城市内的区（如果检测到）
DATE

日期

元数据标识日期的组成部分：

  • year - 用四位数表示的年份（如果检测到）
  • month - 用两位数表示的月份（如果检测到）
  • day - 用两位数表示的日期（如果检测到）
NUMBER

数字

元数据本身就是数字。
PRICE

价格

元数据标识 value 和 currency。

EntityMention

表示文本中实体的提及。目前支持专有名词提及。

JSON 表示法 
{
  "text": {
    object (TextSpan)
  },
  "type": enum (Type),
  "sentiment": {
    object (Sentiment)
  }
}
字段
text

object (TextSpan)

提及文本。
type

enum (Type)

实体提及的类型。
sentiment

object (Sentiment)

对于对 AnalyzeEntitySentimentRequest 的调用，或者如果 AnnotateTextRequest.Features.extract_entity_sentiment 设置为 true，此字段将包含在提供的文档中此实体提及所表达的情感。

类型

支持的提及类型。

枚举
TYPE_UNKNOWN 未知
PROPER 专有名词
COMMON 普通名词（或复合名词）