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