依存句法分析
更新时间：2024-02-28
依存句法分析接口
接口描述
依存句法分析接口可自动分析文本中的依存句法结构信息，利用句子中词与词之间的依存关系来表示词语的句法结构信息（如“主谓”、“动宾”、“定中”等结构关系），并用树状结构来表示整句的结构（如“主谓宾”、“定状补”等）。
在线调试
您可以在示例代码中心中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例一
- HTTP方法:
POST - 请求URL:
https://aip.baidubce.com/rpc/2.0/nlp/v2/depparser
（依存句法分析v1即将下线，为了保证业务的正常使用，请尽快迁移至v2版本，即目前文档展示版本）
- URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
- Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
- body请求示例:
{
"text": "今天天气怎么样"
}请求格式
POST方式调用
注意：要求使用JSON格式的结构体来描述一个请求的具体内容。
body整体文本内容可以支持GBK和UTF-8两种格式的编码。
1、GBK支持：默认按GBK进行编码，输入内容为GBK编码，输出内容为GBK编码，否则会接口报错编码错误
2、UTF-8支持：若文本需要使用UTF-8编码，请在url参数中添加charset=UTF-8 （大小写敏感）
请求参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| text | string | 是 | 待分析文本，长度不超过128字符 |
返回格式
JSON格式
默认返回内容为GBK编码
若用户指定输入为UTF-8编码（通过指定charset参数），则返回内容为UTF-8编码
返回参数
| 参数名称 | 类型 | 详细说明 |
|---|---|---|
| log_id | uint64 | 随机数，本次请求的唯一标识码 |
| text | string | 请求中的待分析文本 |
| items | list | 分析文本按词维度的分析结果，数组形式 |
| +id | int | 词的ID |
| +word | string | 词 |
| +postag | string | 词性，请参照下方词性（postag)取值范围 |
| +head | int | 词的父节点ID |
| +deprel | string | 词与父节点的依存关系，请参照下方依存关系标识 |
返回示例
{
"log_id": 12345,
"text":"今天天气怎么样",
"items":[
{
"id":"1", //id
"word":"今天", //word
"postag":"TIME", //POS tag
"head":"2", //id of current word's parent
"deprel":"ATT" //depend relations between current word and parent
},
{
"id":"2",
"word":"天气",
"postag":"n",
"head":"3",
"deprel":"SBV",
},
{
"id":"3",
"word":"怎么样",
"postag":"r",
"head":"0",
"deprel":"HED",
}
]
}词性取值范围
| 标签 | 含义 | 标签 | 含义 | 标签 | 含义 | 标签 | 含义 |
|---|---|---|---|---|---|---|---|
| n | 普通名词 | f | 方位名词 | s | 处所名词 | nw | 作品名 |
| nz | 其他专名 | v | 普通动词 | vd | 动副词 | vn | 名动词 |
| a | 形容词 | ad | 副形词 | an | 名形词 | d | 副词 |
| m | 数量词 | q | 量词 | r | 代词 | p | 介词 |
| c | 连词 | u | 助词 | xc | 其他虚词 | w | 标点符号 |
| PER | 人名 | LOC | 地名 | ORG | 机构名 | TIME | 时间 |
依存关系标识
| 标识 | 含义 | 解释 | 例子 |
|---|---|---|---|
| SBV | 主谓关系 | 主语与谓词间的关系 | 我给他一本书(我-->给) |
| VOB | 动宾关系 | 宾语与谓词间的关系 | 他送了一本书(送-->书) |
| POB | 介宾关系 | 介词与宾语间的关系 | 我把书卖了（把-->书） |
| ADV | 状中关系 | 状语与中心词间的关系 | 我昨天买书了（昨天<--买） |
| CMP | 动补关系 | 补语与中心词间的关系 | 我都吃完了（吃-->完） |
| ATT | 定中关系 | 定语与中心词间的关系 | 他送了一本书(一本<--书) |
| F | 方位关系 | 方位词与中心词的关系 | 在公园里玩耍(公园-->里) |
| COO | 并列关系 | 同类型词语间关系 | 叔叔阿姨(叔叔-->阿姨) |
| DBL | 兼语结构 | 主谓短语做宾语的结构 | 他请我吃饭(请-->我，请-->吃饭) |
| DOB | 双宾语结构 | 谓语后出现两个宾语 | 他送我一本书(送-->我，送-->书) |
| VV | 连谓结构 | 同主语的多个谓词间关系 | 他外出吃饭(外出-->吃饭) |
| IC | 子句结构 | 两个结构独立或关联的单句 | 你好，书店怎么走？(你好<--走) |
| MT | 虚词成分 | 虚词与中心词间的关系 | 他送了一本书(送-->了) |
| HED | 核心关系 | 指整个句子的核心 |