关键字：微信公众平台 微信开放平台 语义理解 semantic
作者：方倍工作室
原文：http://www.cnblogs.com/txw1958/p/weixin-semantic-analysis.html
微信开放平台语义理解接口调用（http请求）简单方便，用户无需掌握语义理解及相关技术，只需根据自己的产品特点，选择相应的服务即可搭建一套智能语义服务。
第一步：创建应用
请到“管理中心”创建应用，点击“创建移动应用”或者“创建网站应用”，填写相关资料，然后将该应用提交审核，只有审核通过的应用才能进行开发。
注册完毕，我们会在 7 个工作日内完成审核工作。审核通过之后，开放平台将分配给该移动应用全局唯一的AppID和AppSecret。
第二步：根据AppID和AppSecret获得access token
调用接口：
http请求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
参数说明：
| 参数 | 是否必须 | 说明 |
|---|---|---|
| grant_type | 是 | 获取access_token填写client_credential |
| appid | 是 | 应用的appid |
| secret | 是 | 应用的appsecret |
返回说明：
正常情况下，微信会返回下述JSON数据包。
{ "access_token":"ACCESS_TOKEN", "expires_in":7200 }
| 参数 | 说明 |
|---|---|
| access_token | 获取到的凭证 |
| expires_in | 凭证有效时间，单位：秒 |
错误时微信会返回错误码等信息，JSON数据包示例如下（该示例为AppID无效错误）:
{ "errcode":40013, "errmsg":"invalid appid" }
第三步：使用access token调用语义理解接口
输入说明：
http请求方式: POST（请使用https协议）
https://api.weixin.qq.com/semantic/semproxy/search?access_token=YOUR_ACCESS_TOKEN
POST数据格式：JSON
POST数据例子：
{ "query":"查一下明天从北京到上海的南航机票", "city":"北京", "category": "flight,hotel", "appid":"wxaaaaaaaaaaaaaaaa", "uid":"123456" }
输入参数说明：
| 参数 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| access_token | 是 | String | 根据appid和appsecret获取到的token |
| query | 是 | String | 输入文本串 |
| category | 是 | String | 需要使用的服务类型，多个用“,”隔开，不能为空 |
| latitude | 见接口协议文档 | Float | 纬度坐标，与经度同时传入；与城市二选一传入 |
| longitude | 见接口协议文档 | Float | 经度坐标，与纬度同时传入；与城市二选一传入 |
| city | 见接口协议文档 | String | 城市名称，与经纬度二选一传入 |
| region | 见接口协议文档 | String | 区域名称，在城市存在的情况下可省；与经纬度二选一传入 |
| appid | 是 | String | Appid,开发者的唯一标识 |
| uid | 否 | String | 用户唯一id（非开发者id），用户区分应用下的不同用户（建议填入用户openid），如果为空，则无法使用上下文理解功能。appid和uid同时存在的情况下，才可以使用上下文理解功能。 |
返回说明：
正常情况下，微信会返回下述JSON数据包。
{ "errcode": 0, "query": "查一下明天从北京到上海的南航机票", "type": "flight", "semantic": { "details": { "start_loc": { "type": "LOC_CITY", "city": "北京市", "city_simple": "北京", "loc_ori": "北京" }, "end_loc": { "type": "LOC_CITY", "city": "上海市", "city_simple": "上海", "loc_ori": "上海" }, "start_date": { "type": "DT_ORI", "date": "2014-03-05", "date_ori": "明天" }, "airline": "中国南方航空公司" }, "intent": "SEARCH" } }
返回参数说明：
| 参数 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| errcode | 是 | Int | 表示请求后的状态 |
| query | 是 | String | 用户的输入字符串 |
| type | 是 | String | 服务的全局类型id，详见协议文档中垂直服务协议定义 |
| semantic | 是 | Object | 语义理解后的结构化标识，各服务不同 |
| result | 否 | Array | 部分类别的结果 |
| answer | 否 | String | 部分类别的结果html5展示，目前不支持 |
| text | 否 | String | 特殊回复说明 |
更多详细内容与协议说明，请查看：语义理解接口协议文档
代码实现
<?php /* 方倍工作室 http://www.fangbei.org/ CopyRight 2014 All Rights Reserved 微信开放平台接口SDK */ /* require_once('weixin.class.php'); $weixin = new class_weixin(); */ define('APPID', "wxed782be999f86eab"); define('APPSECRET', "72edec63779f7aa16a3a33447e2c7-fb"); class class_weixin { var $appid = APPID; var $appsecret = APPSECRET; //构造函数，获取Access Token public function __construct($appid = NULL, $appsecret = NULL) { if($appid && $appsecret){ $this->appid = $appid; $this->appsecret = $appsecret; } //1. 本地写入 $res = file_get_contents('access_token.json'); $result = json_decode($res, true); $this->expires_time = $result["expires_time"]; $this->access_token = $result["access_token"]; if (time() > ($this->expires_time + 3600)){ $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=".$this->appid."&secret=".$this->appsecret; $res = $this->http_request($url); $result = json_decode($res, true); $this->access_token = $result["access_token"]; $this->expires_time = time(); file_put_contents('access_token.json', '{"access_token": "'.$this->access_token.'", "expires_time": '.$this->expires_time.'}'); } } public function semantic_search($record) { $data = urldecode(json_encode($record)); $url = "https://api.weixin.qq.com/semantic/semproxy/search?access_token=".$this->access_token; $res = $this->http_request($url, $data); return json_decode($res, true); } //HTTP请求（支持HTTP/HTTPS，支持GET/POST） protected function http_request($url, $data = null) { $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); if (!empty($data)){ curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, $data); } curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE); $output = curl_exec($curl); curl_close($curl); return $output; } //日志记录 private function logger($log_content) { if(isset($_SERVER['HTTP_APPNAME'])){ //SAE sae_set_display_errors(false); sae_debug($log_content); sae_set_display_errors(true); }else if($_SERVER['REMOTE_ADDR'] != "127.0.0.1"){ //LOCAL $max_size = 500000; $log_filename = "log.xml"; if(file_exists($log_filename) and (abs(filesize($log_filename)) > $max_size)){unlink($log_filename);} file_put_contents($log_filename, date('Y-m-d H:i:s').$log_content."\r\n", FILE_APPEND); } } }
接口调用
$weixin = new class_weixin(); $record = array('query' => "查一下明天从北京到深圳的深航机票", 'city' => "北京", 'category' => "flight,hotel", 'appid' => $weixin->appid, 'uid' => "" ); $result = $weixin->semantic_search($record);
结果返回
{ "errcode" : 0, "query" : "查一下明天从北京到深圳的国航机票", "semantic" : { "details" : { "airline" : "中国国际航空公司", "answer" : "已帮您预定2015-12-19,从北京市出发，前往深圳市的航班。", "context_info" : { "isFinished" : "1", "null_times" : "0" }, "end_loc" : { "city" : "深圳市", "city_simple" : "深圳", "loc_ori" : "深圳", "modify_times" : "0", "province" : "广东省", "province_simple" : "广东|粤", "slot_content_type" : "2", "type" : "LOC_CITY" }, "hit_str" : "查 一下 明天 从 北京 到 深圳 国航 机票 ", "start_date" : { "date" : "2015-12-19", "date_lunar" : "2015-11-09", "date_ori" : "明天", "modify_times" : "0", "slot_content_type" : "2", "type" : "DT_ORI", "week" : "6" }, "start_loc" : { "city" : "北京市", "city_simple" : "北京|京", "loc_ori" : "北京", "modify_times" : "0", "slot_content_type" : "2", "type" : "LOC_CITY" } }, "intent" : "SEARCH" }, "type" : "flight" }
原文：http://www.cnblogs.com/txw1958/p/weixin-semantic-analysis.html
