analyzeSyntax 方法返回给定文本语言结构的详细信息。Natural Language API 就文本中的每个词法单元提供其内部结构信息(词法)及其在句子(语法)中所起作用的信息。
词态学研究单词内部结构。词态学侧重于如何排列或修饰单词内的元素(词根、根词、前缀、后缀等)以形成不同的含义。举例来说,英语通常在名词末尾添加“-s”或“-es”表示复数,在动词中添加“-d”或“-ed”表示过去式。在形容词中添加后缀“-ly”变成副词(例如,“happy”[形容词]和“happily”[副词])。
Natural Language API 使用词态分析来推断单词的语法信息。
语言之间的语态学差异很大。在诸如俄语之类的语言中,词尾表示单词在句子中的角色(例如,“книга”[书籍 - 主格]变为“книгу”[宾格]充当动词的直接宾语)。这意味着单词顺序变化可以不改变句子的含义,尽管单词顺序不同确实会影响在语境中的适切性。英语和普通话等语言都缺少表示语法格的词缀,更依赖句子中的词序来表示单词各自的作用。因此,语态分析在很大程度上取决于源语言,以及对于该语言支持哪种语态学的了解。
语法研究短语和句子结构。语法和词态共同表示语法关系,其中不同的语言以不同的方式区分它们之间的分工。举例来说,俄语使用词缀表示扮演直接宾语的角色(“книгу”中的“у”),而英语使用词序,其中直接宾语紧跟动词 (read the book)。
analyzeSyntax 响应在 partOfSpeech 字段中返回词法信息并在 dependencyTree 字段中返回单词之间的语法关系。
词性
在语法请求中,词性和词法信息在响应的 partOfSpeech 字段中返回。partOfSpeech 字段包含一组子字段,其中具有词性 (POS) 信息以及更明确的词法信息。下面列出了这些子字段。
tag使用粗粒度 POS 标记(名词、动词等)表示词性,并提供顶层语法信息。如果您希望为后续语言分析创建模式和/或减少歧义(例如,将“train”标记为名词而非动词),则 POS 标签很有用。number表示一个单词的语法数量。在英语中,在可数名词中添加后缀“-s”表示一个以上(例如,“dog + s”表示多于一只狗)。如果不带复数后缀,则通常称为单数形式。有些语言,如阿拉伯语,还有双数的概念。此字段可能包含下列值:SINGULAR表示一个。PLURAL表示多个数量。DUAL表示恰好两个。
person确定一个单词的语法人称。在英语中,“I/me”是第一人称单数,指代说话者(或作者),而“you”以及“she/her 和 he/him”分别指代受众(听话者)和其他人。此字段可能包含下列值:FIRST人称表示说话者。SECOND人称表示目标受众,即听话者。THIRD人称表示非说话者/非听话者。REFLEXIVE_PERSON指示,比方说,主宾相同,如“The cat licked itself”,其中“-self”加在代词后表示反身代词。在俄语和日语中,反身代词是一个独立的代词。(例如,“John loves himself”在俄语中为“Джон любит себя”,其中 себя 是不分性别的“self”;在日语中为“Tarō wa zibun o aisuru”(罗马化版本),其中“zibun”是不分性别的“self”。)请参见反身代词。
gender表示名词的语法性别。此字段可能包含下列值:FEMININE语法性别MASCULINE语法性别NEUTER语法性别
case表示一个单词的语法格及其在短语或句子中的角色。此字段可能包含下列值:ACCUSATIVE格指示及物动词的直接宾语。ADVERBIAL格指示形容词的副词形式。请注意,英语使用不同的词来表示副词 ("well") 和形容词 ("good")。 在英语中,形容词加后缀“-ly”确实能衍生出副词(例如,“happy”与“happily”),但并不被视为“格”。COMPLEMENTIVE格(中文)指示使采用连接结构的可能、描述性或结果性表达意义完整所需的词。DATIVE格指示间接宾语,即接收直接宾语的指示物。在英语中,间接宾语通常通过介词“to”表示,如短语“He gave the ball to Bobby”,其中“Bobby”是间接宾语,是球的接收者。下面是个俄语示例:Иван дал книгу маше(伊万把书给了玛莎),其中“ -e”表示“маше”是间接宾语,而玛莎是书的接收者。GENITIVE格指示所属关系。请注意,英语通常使用“-'s”词缀指示所有,而不是使用所有格。短语末尾可以附加“-'s”词缀(例如,“[The man who ran the bill up]’s wife paid a dear price for his excess.”)。而在此俄语示例中,“-а”将“Антон-”标记为属格:“Гдекнига Антона?”(安东的书在哪里)。俄语中,所有格亦作为“几个”、“少数”等词语的补语出现。例如:Зимой здесь мало снега(“冬天这里很少下雪”)中,“-a”使“снег-”(雪)成为了所有格,因为它是“мало”(“小”)的补语。不涉及所有格。INSTRUMENTAL格指示名词是否是完成某个动作的工具。英语句子“He opened the door with a key”在俄语中为“он открыл дверь ключом”,其中“-om”附加在“ключ” (key) 后面表示工具格。LOCATIVE格指示指代位置的单词。英语没有方位格。NOMINATIVE格与动词的主语有关。在英语中,句子的主语是通过词序指示的。在句子“The girl won the race”中,短语“the girl”是主语,出现在动词“won”的左边。在俄语中,девушка (the/a girl) 可以出现在动词之前或之后:“девушка выиграла гонку”或“гонку выиграла девушка”,其中动词是 выиграла (won)。OBLIQUE格指示一个单词用作动词或介词的宾语。PARTITIVE格指示一个单词的“部分”或缺乏特定的同一性。英语中部分词的例子有“three of my friends”。在俄语中为“трое моих друзей”,其中“трое”指“three of”(而非“три друга”,其中“три”指“three”)。PREPOSITIONAL格指示介词宾语。REFLEXIVE_CASE指示动词的主语与宾语相同。大多数语言不使用反身格,因为这种用法是通过使用特殊的反身代词来表示的(例如“himself”,“myself”等)。RELATIVE_CASE(中文)指示将名词与动词或形容词连接起来的关系从句的补语化成分。示例:工作[的]地方,便宜的餐馆。VOCATIVE格通常在谈话时指示用于称呼某人或某事的名词。
tense表示动词的语法时态,指示动词的提及在时间中的位置。请注意,tense不同于aspect,后者亦涉及动词与时间的关系,但侧重于时间流动特征,而不是其位置。在许多语言中,IMPERFECT和PLUPERFECT时态更准确地指代时和式的特定组合。此字段可能包含下列值:CONDITIONAL_TENSE是更为流行的词法术语“条件语气”的另一种说法。(请参阅下文的CONDITIONAL_MOOD。)FUTURE表示将来发生的动作。请注意,在英语中,将来时通常通过在动词短语前添加单词“will”来表示。PAST表示过去发生的动作。PRESENT表示目前正在发生的动作。IMPERFECT表示动作发生在过去,但没有在该时态的参照系下完成。请注意,在英语中,未完成时通常通过在过去式中添加动词的动名词形式来表示,如“I was walking”。未完成时事件发生在过去,但与过去时的区别是没有完成。PLUPERFECT表示过去发生的动作,并且在那个时态参照系下完成了。举例来说,“I had walked”发生在过去,但在过去式的参照系下也是完成的。
aspect表示动词的语法式,它表现时间流动。tense侧重于动词在时间内的位置,aspect与之不同,它侧重于发生时的时间流动特性。此字段可能包含下列值:PERFECTIVE式表示因为完全发生在过去或将来而“完成”的事件。IMPERFECTIVE式表示因为是连续的或者重复发生而未完成的事件。PROGRESSIVE式表示连续的事件。进行式通常被视为较常见的未完成式(也包括重复)的特例。
mood表示动词的语法语气,语气指示对标的动作的态度。此字段可能包含下列值:CONDITIONAL_MOOD表示不一定的动作。请注意,在英语中,动词形式不是有条件的;而是通过将“would”与动词不定式结合起来指出有条件的行为。IMPERATIVE通过第二人称表示命令或请求。INDICATIVE表示事实的陈述,更常见的名称是“已然语气”。INTERROGATIVE表示疑问。JUSSIVE通过第一或第三人称表示命令或请求。英语并没有弱祈使语气,尽管以真正或暗示性的“Let us”开头的劝告表达了这种弱祈使语气。SUBJUNCTIVE表示与行为有关的不确定性的质量,也称为“非已然”语气(与“已然”陈述语气形成对比)。英语没有特定的虚拟语气;而是用“want”、“wish”、“hope”等词语表达了虚拟语气的意思。
voice表示动词的语法语态,即动作与主语和/或宾语之间的关系。此字段可能包含下列值:ACTIVE语态指示正在执行动作的主语的动作。CAUSATIVE语态表示正对主语产生影响的动作。在英语中,没有直接的使役语态;这种使役是通过使用动词“make”来表示的,如“Mom made me go to school”。PASSIVE语态表示正对主语产生影响的动作。许多情况下,不说出或不知道动作的执行者。
reciprocity表示一个单词的(通常是代词的)互指性,互指性指代词指代句子中其他地方出现的名词短语。此字段可能包含下列值:RECIPROCAL指示代词是互指的。NON_RECIPROCAL指示代词并非互指的。
proper表示名词是否属于专有名称的一部分。请注意,许多专有名称由几个词组成;如果此短语被检测为专有名称,则每个词法单元亦会被检测为专有。(例如,专有名词“Wrigley Field”中的“Wrigley”和“Field”会将其专有特性设置为PROPER。此字段可能包含下列值:PROPER表示此词法单元属于专有名称的一部分。NOT_PROPER表示此令牌不属于专有名称的一部分。
form表示不能完美归入上文所述一组常见形式(tense、mood、