Entity

代表文字中已知實體的字詞，例如人物、機構或地點。API 會將機率和提及等資訊與實體建立關聯。

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

string

實體的代表名稱。
type

enum (Type)

實體類型。
metadata

map (key: string, value: string)

與實體相關聯的中繼資料。

如要瞭解與其他實體類型相關聯的中繼資料，請參閱下方的「類型」表格。

包含 "key": value 組合清單的物件。範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
mentions[]

object (EntityMention)

輸入文件中提及這個實體的次數。這個 API 目前支援專有名詞提及。
sentiment

object (Sentiment)

對於 AnalyzeEntitySentimentRequest 的呼叫，或如果 AnnotateTextRequest.Features.extract_entity_sentiment 設為 true，這個欄位會包含在提供文件中，針對此實體所表達的綜合情緒。

類型

實體的類型。下表列出具有不同中繼資料的實體相關欄位。

列舉
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)
  },
  "probability": number
}
欄位
text

object (TextSpan)

提及文字。
type

enum (Type)

實體提及的類型。
sentiment

object (Sentiment)

對於 AnalyzeEntitySentimentRequest 的呼叫，或是如果 AnnotateTextRequest.Features.extract_entity_sentiment 設為 true，這個欄位會包含在提供文件中提及該實體時所表達的情緒。
probability

number

與實體相關聯的機率分數。

分數會顯示實體提及為實體類型的機率。分數介於 (0, 1] 之間。

類型

支援的提及類型。

列舉
TYPE_UNKNOWN 不明
PROPER 專有名詞
COMMON 普通名詞 (或名詞複合詞)