《微信语义理解接口协议文档》由会员分享，可在线阅读，更多相关《微信语义理解接口协议文档（39页珍藏版）》请在金锄头文库上搜索。
1、 微信开放平义理解 接口协议说明v1.0 2014.7.3 目录目录 一、微信语义理解开放平台 . 1 1、概述. 1 2、输入输出协议 . 1 2.1 语义应答协议 1 2.2 语义输入协议 2 2.3 示例说明 2 3、通用协议 . 3 3.1 时间相关协议（datetime） . 3 3.2 地点相关协议（location） . 5 3.3 数字相关协议（number） . 6 4、垂直服务协议 . 8 4.1 生活类 . 9 4.1.1 餐馆服务（restaurant） 9 4.1.2 地图服务（map） . 11 4.1.3 周边服务（nearby） . 12 4.1.4 团购服务（
2、coupon）. 14 4.2 旅行类 . 14 4.2.1 酒店服务（hotel） 14 4.2.2 旅游服务（travel） 15 4.2.3 航班服务（flight） 16 4.2.4 火车服务（train） . 18 4.3 娱乐类 19 4.3.1 上映电影服务（movie） . 19 4.3.2 音乐服务（music） . 20 4.3.3 视频服务（video） 20 4.3.4 小说服务（novel） 21 4.4 工具类 22 4.4.1 天气服务（weather） . 22 4.4.2 股票服务（stock） 23 4.4.3 提醒服务（remind） . 24 4.4.4
3、 常用电话服务（telephone） 25 4.5 知识类 26 4.5.1 菜谱服务（cookbook） . 26 4.5.2 百科服务（baike） 26 4.5.3 资讯服务（news） 27 4.6 其他类 28 4.6.1 电视节目预告（tv） 28 4.6.2 通用指令（instruction）beta 29 4.6.3 电视指令（tv_instruction）beta 31 4.6.4 车载指令（car_instruction）beta . 33 4.6.5 应用服务（app） . 34 4.6.6 网址服务（website） 35 4.6.7 网页搜索（search） 35 5
4、、示例说明 . 36 1 一、一、微信微信语义理解开放平义理解开放平台 1、概述、概述 语义理解， 主要提供从用户自然语言输入到结构化解析的技术实现。 微信语义理解开放 平台是使用先进的自然语言处理技术给用户 （开发者和公众账号） 提供一站式的语义解析方 案。 微信语义理解开放平台覆盖了多个垂直领域的语义场景，接口调用（http 请求）简单方 便，用户无需掌握语义理解及相关技术，只需根据自己的产品特点，选择相应的服务即可搭 建一套智能语义服务。 2、输入输出输入输出协议协议 2.1 语义应答语义应答协议协议 字段名称 是否必须 字段类型 字段说明 errcode 是 Int 用于标识用户请求后
5、的状态 query 是 String 用户的输入字符串 type 是 String 服务的全局类别 id，详见 4 垂直服务协议定义 semantic 是 Object 语义理解后的结构化标识，各个服务不同 result 否 Array 部分类别的结果 answer 否 String 部分类别的结果 html5 展示，目前不支持 text 否 String 特殊回复说明 2.1.1 errcode 错误错误字段说明字段说明 errcode 错误字段说明 0 请求正常，有语义结果 7000000 请求正常，无语义结果 7000001 缺失请求参数 7000002 signature 参数无效 7
6、000003 地理位置相关配置 1 无效 7000004 地理位置相关配置 2 无效 7000005 请求地理位置信息失败 7000006 地理位置结果解析失败 7000007 内部初始化失败 7000008 非法 appid（获取密钥失败） 7000009 请求语义服务失败 7000010 非法 post 请求 2 7000011 post 请求 json 字段无效 7000030 查询 query 太短 7000031 查询 query 太长 7000032 城市、经纬度信息缺失 7000033 query 请求语义处理失败 7000034 获取天气信息失败 7000035 获取股票信息失
7、败 7000036 utf8 编码转换失败 2.2 语义语义输入协议输入协议 字段名称 是否必须 字段类型 字段说明 access_token 是 String 根据 appid 和 secret 获取到的 token，获取方法 请参考：获取 access_token 方法 query 是 String 输入文本串 category 是 String 需要使用的服务类别，多个用,隔开，不能为空 latitude 见说明 Float 纬度坐标， 与经度同时传入； 与城市二选一传入 longitude 见说明 Float 经度坐标， 与纬度同时传入； 与城市二选一传入 city 见说明 Strin
8、g 城市名称，与经纬度二选一传入 region 见说明 String 区域名称， 在城市存在的情况下可省； 与经纬度 二选一传入 appid 是 String App id，开发者的唯一标识。 uid 否 String 用户唯一 id（并非开发者 id） ，用于区分该开发 者下不同用户， 如果为空， 则没法使用上下文理 解功能。appid 和 uid 同时存在的情况下，才可 以使用上下文理解功能。 注： （1）单类别意图比较明确，识别的覆盖率比较大，所以如果只要使用特定某个类别， 建议将 category 只设置为该类别。 （2）对于没有地理位置要求的类别（比如：电影，音乐 等）用户的 cit
9、y 和 region 可以随便指定，不会影响结果。 2.3 示例说明示例说明 示例请求： Post 形式，见示例说明。 示例应答： 语义应答格式采用 json 格式： “errcode”:0, “query”:”查一下明天从北京到上海的南航机票”, “type”:”flight”, “semantic”: 3 “details”: “start_loc”: “type”:”LOC_CITY”, “city”:”北京市”, “city_simple”:”北京”, “loc_ori”:”北京” , “end_loc”: “type”:”LOC_CITY”, “city”:”上海市”, “city_
10、simple”:”上海”, “loc_ori”:”上海” , “start_date”: “type”:”DT_ORI”, “date”:”2014-03-05”, “date_ori”:”明天” , “airline”:”中国南方航空公司” , “intent”:”SEARCH” 3、通用协议通用协议 3.1 时间相关协议时间相关协议（datetime） 时间在语义理解里是很常用的一个字段，协议定义如下： 3.1.1 单时间的描述协议单时间的描述协议 datetime： 字段名称 是否必须 字段类型 字段说明 type 是 String 大类型： “DT_SINGLE” 。 DT_SINGL
11、E 又细分为两个类别：DT_ORI 和 DT_INFER。 DT_ORI 是字面时间，比如： “上午九点” ； DT_INFER 是推理时间，比如： “提前 5 分 钟” date 是 String 格式：YYYY-MM-DD，默认是当天时间 date_ori 是 String date 的原始字符串 time 是 String 24 小时制，格式：HH:MM:SS，默认为 00:00:00 4 time_ori 是 String Time 的原始字符串 示例：明天上午九点 “datetime”: “type”:” DT_ORI”, “date”:”2014-03-05”, “date_ori
12、”:”明天”, “time”: ”09:00:00”, “time_ori”:” 上午九点” 示例：5 小时后（当前时间推后 5 小时） “datetime”: “type”:” DT_INFER”, “date”:”2014-03-04”, “date_ori”:”, “time”: ”15:00:00”, “time_ori”:”5 小时后” 3.1.2 时间段的描述协议时间段的描述协议 datetime： 字段名称 是否必须 字段类型 字段说明 type 是 String 类型： “DT_INTERVAL” date 是 String 格式：YYYY-MM-DD，默认是当天时间 date
13、_ori 是 String date 的原始字符串 time 是 String 24 小时制，格式：HH:MM:SS time_ori 是 String time 的原始字符串 end_date 是 String 格式：YYYY-MM-DD，默认是当前时间 end_date_ori 是 String date 的原始字符串 end_time 是 String 24 小时制，格式：HH:MM:SS end_time_ori 是 String Time 的原始字符串 示例：明天上午九点到后天下午三点 “datetime”: “type”:”DT_INTERVAL”, “date”:”2014-03
14、-05”, “date_ori”:”明天”, “time”: ”09:00:00”, “time_ori”:” 上午九点”, “end_date”:”2014-03-06”, “end_date_ori”:”后天”, “end_time”:”15:00:00”, “end_time_ori”:”下午三点” 3.1.3 重复时间的描述协议重复时间的描述协议 datetime： 字段名称 是否必须 字段类型 字段说明 5 type 是 String 类型： “DT_REPEAT” DT_ REPEAT 又细分为两个类别：DT_RORI 和 DT_RINFER。 DT_RORI 是字面时间，比如：
15、“每天上午九 点” ；DT_RINFER 是推理时间，比如： “工 作日除外” time 是 String 24 小时制，格式：HH:MM:SS time_ori 是 String time 的原始字符串 repeat 是 String 重复标记：0000000 注：依次代表周日，周六，周一；1 表 示该天要重复，0 表示不重复 repeat_ori 是 String date 的原始字符串 示例：每周一三五早上 8 点 “datetime”: “type”:”DT_REPEAT”, “time”: ”08:00:00”, “time_ori”:”早上八点”, “repeat”:”001010
16、1”, “repeat_ori”:”每周一三五”, 3.2 地点相关协议地点相关协议（location） 地点在语义理解里也是很常用的一个字段，协议定义如下： 字段名称 是否必须 字段类型 字段说明 type 是 String 大类型： “LOC” LOC 又细分为如下类别：LOC_COUNTRY、 LOC_PROVINCE、LOC_CITY、LOC_TOWN、 LOC_POI、NORMAL_POI。 country 否 String 国家 province 否 String 省全称，例如：广东省 province_simple 否 String 省简称，例如：广东|粤 city 否 String 市全称，例如：北京市 city_simple 否 String 市简称，例如：北京 town 否 String 县区全称，例如：海淀区 town _simple 否 String 县区简称，例如：海淀 poi 否 String poi 详细地址
