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(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 (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 - 감지된 경우 4자리 연도
  • month - 감지된 경우 두 자리 월 번호
  • day - 감지된 경우 2자리 일 수
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 일반 명사 (또는 명사 복합어)