语义标注

接口简介

语义标注接口是分词完成之后,展示出每个词在当前语境中的语义信息、以及必要的属性。流程如下:

第一步、向服务器传入一段普通文本。
第二步、服务器接收传入文本,并进入HowNet知识库,进行多次循环解析。
第三步、通过多次循环解析,得到每个词语在语境中的语义。
第四步、根据语义将每个词语进行分割,并根据所分割的词语在知识库中获取相应的语义信息,以句为单位按词语的先后顺序放入数组,并返回结果。在线体验>>

接口特性

基于语境的语义标注。语义标注接口是根据当前语境中每个词语所扮演的角色,来给其标注上相应的语义。例如,在“我买了斤苹果”与“我买了个苹果手机”两句中,对于“苹果”的正确分析。前者最终的语义标注为:“水果”,而后者则是“用具或特定牌子”。

接口调用

调用信息

接 口 URL  http://yuzhinlp.com/api/getWordAttribute.do
请 求 方 式 POST
字 符 编 码 UTF-8
请 求 参 数 apiKey 注册用户的认证唯一标识,用户注册登录后即可看到 必填参数
input 需要分析的文本(长度尽量限制于500字以内) 必填参数
返 回 结 果 JSON字符串。若返回成功,则字符串为{"success": 标注结果 },
若返回失败,则字符串为{"error": 错误原因 }

调用演示

1、代码参考
import java.util.ArrayList;
import java.util.List;
import org.apache.http.NameValuePair;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import com.alibaba.fastjson.JSONObject;


public class ApiTest {
	public static void main(String[] args){
		//创建post请求
        CloseableHttpClient httpclient = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost("http://yuzhinlp.com/api/getWordAttribute.do");
        //post请求传入参数
        List<NameValuePair> parameters = new ArrayList<NameValuePair>();
        parameters.add(new BasicNameValuePair("apiKey", YourAPIKey));
        parameters.add(new BasicNameValuePair("input", "知网引领可解释NLP技术发展"));
        CloseableHttpResponse response = null;
        try {
        	UrlEncodedFormEntity formEntity;
			formEntity = new UrlEncodedFormEntity(parameters, "UTF-8");//设置参数编码
        	httpPost.setEntity(formEntity);
            // 执行请求
            response = httpclient.execute(httpPost);
            // 判断返回状态是否为200
            if (response.getStatusLine().getStatusCode() == 200) {
            	//调用结果
            	String content = EntityUtils.toString(response.getEntity(), "UTF-8");
            	System.out.println(content);		            	
	         }
        } catch (Exception e) {
        	// TODO Auto-generated catch block
        	e.printStackTrace();
		} finally {
			try {  
	            if (response != null) {
	                response.close();
	            }
				httpclient.close();
			} catch (IOException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
        }
	}
}
							
2、返回结果
{
    "success": [
        {
            "expressionInSentence": "知网", 
            "partOfSpeech": "noun", 
            "unitId": "205998", 
            "posInChinese": "名词", 
            "unitDefination": "{software|软件:concerning={knowledge|知识},modifier={ProperName|专}}", 
            "unitSpell": "zhi1 wang3", 
            "unitSenceInChinese": "", 
            "unitSenceInEnglish": "", 
            "unitExplainInEnglish": "HowNet"
        }, 
        {
            "expressionInSentence": "引领", 
            "partOfSpeech": "verb", 
            "unitId": "192121", 
            "posInChinese": "动词", 
            "unitDefination": "{expect|期望}", 
            "unitSpell": "yin3 ling3", 
            "unitSenceInChinese": "PlusFeeling|正面情感", 
            "unitSenceInEnglish": "PlusFeeling|正面情感", 
            "unitExplainInEnglish": "eagerly look forward to"
        },..., 
        {
            "expressionInSentence": "。", 
            "partOfSpeech": "pun", 
            "unitId": "010373", 
            "posInChinese": "标点", 
            "unitDefination": "{punc|标点}", 
            "unitSpell": "??", 
            "unitSenceInChinese": "", 
            "unitSenceInEnglish": "", 
            "unitExplainInEnglish": "."
        }
    ]
}							
							
3、分析结果名词对照表
名称 描述
expressionInSentence 输入文本经过词法处理后各定形词语在文本中排列的序号
partOfSpeech 当前词语的词性信息(英文)
unitId 词语在知网词典中的义项ID号
posInChinese 当前词语的词性信息(中文)
unitDefination 当前词语的语义定义
unitSpell 当前词语的拼音信息
unitSenceInChinese 当前词语的情感信息(中文)
unitSenceInEnglish 当前词语的情感信息(英文)
unitExplainInEnglish 当前词语在当前语境中的英文翻译