为了给用户提供最佳的语音交互体验,百度地图提出一种语音助手深度互通方案,该方案打破了各语音助手之间的屏障,构建起一个繁荣的语音助 手互通生态。
线上域名:https://api.map.baidu.com
方法路径:baidumapvoice/v2/check
请求示例:https://api.map.baidu.com/baidumapvoice/v2/check
https://api.map.baidu.com/baidumapvoice/v2/check?pname=xxx&ak=xxxxxxxxxxXXXXXXXXXXXXXXXXXXXXXX&query=E58EBBE4BA94E98193E58FA3E59CB0E99381E7AB99E98094E5BE84E8A5BFE4BA8CE69797&caller=7b22pb223a22vivo222c22mb223a22V1836A222c22os223a229%222c22pcn223a22com.vivo.agent222c22ver223a2231000222c22map_info22%3a7b22app223a22com.baidu.BaiduMap222c22processState22%3a02c22versionCode223a9382c22versionName223a2220.20.20%227d7d&callee=iLTmEGYURKSx xV%2ByJ%3DKOzwaB9iR5Vc5Q1Vm3D%2Fx bKKm 5n%2BA_CK8JuoBV5aHa7Ba14mxb5oP_cuM54JAiy-FzVSFXtjKVpVPYNpEGVfaZgJNO3%2Bq%2B39Vajsr3fn5G3D50c3D2Bz2FlpGnEJMrkip7kQVVoZP3%3DemWE2OLShzFTHRDokPcx-E8nK8kpGuVVz1WEsOD_JDb4SOZgANI-rlY3lEau0BabjMVpVPYFdEgkDyg%3DpCOVdwl4UOm6KxQ9%2Bml%2BqZ6TeNGKU%3DLdAzOJxDL4pFj8eF3D3DeN7%3D5gX XOGWUOZzUBm4JDL4uBgCIF&3D3DeN7%3D5hXLmDQpDhj2i_vlHlY43Ehoaq0ydL7l%2BG%2F4XEjofaWvuB9ohpJ3jV_qCN40NZ0ChQHBBzVpHinK5LIq0lz7SA6MaDpiRLp_hNYFYkpMIOWsILdqfpVnKkXpGD7lzZViImlBBNpd_Gzqi_5o0ywo30owmr4pGLXtKG2F%3DHDb4SOZgiBe7_xxLKEXqZrWBgZK3D5ZnAmDYpgHnmCNCo0C79RVjVCzGlG5Klhh5yXq%2FUHOguJYv7jlVoj8gMaqK&3DeLDb5_2qIH
结果示例:
{"errno":0,"errstr":"ok","data":{"voiceStatus":1,"tips":"好的,交给小度语音","token":"Svw_Jf63IcJTQY8l_/TtKtbY35eR+UG3fGH_QXA23zKuKh1sT=qiZ+Pvi=eSh5x22sUs+vx2jkBu+KNo0LC2KvySj6bEwUq_fHfW5uXV4NJYJg+lRz2=j","query":"开始导航"}}
| 参数名 | 必选 | 类型 | 值 | 描述 |
|---|---|---|---|---|
| pname | 是 | string | xxx_xxx | 调用者产品名称,双方约定,格式:品牌名_产品名 |
| ak | 是 | string | xxxxxxxxxxxx | 服务鉴权密钥,百度开放平台申请配额及 QPS |
| query | 是 | string | 去五道口地铁站途径西二旗 | 用户查询 query |
| caller | 是 | string | {"pb":"xx","mb":"V1829A","os":"Android28","pcn":"com.xxx.xxx","ver":"2.5.0.3"} | 调用者(系统语音)场景信息,json string 格式,具体格式和字段见下表 |
| callee | 是 | string | iLTmEGYURKSx_xV+yJ=KOzwaB | 被调用者(地图小度语音)场景信息,调用者(系统语音)从地图客户端获取,对调用者透明 |
| 参数名 | 必选 | 类型 | 值 | 描述 |
|---|---|---|---|---|
| Pb | 是 | string | xxx | 手机品牌 |
| Mb | 是 | string | V1829A | 手机型号 |
| Os | 是 | string | Android28 | 设备系统版本号Build.VERSION.RELEASE |
| Pcn | 是 | string | com.xxx.agent(示意) | 助手包名 |
| Ver | 是 | string | 2.5.0.3 | 助手版本 |
| Ctm | 是 | string | 1578918651425 | 客户端当前时间毫秒数 |
| map_info | 是 | object | 地图状态信息(包含下面 4 个参数,判断地图未启动 or 前后台) | |
| map_info.app | 是 | string | com.baidu.BaiduMap | 地图包名 |
| map_info.processState | 是 | string | 0,1,2 | 地图进程状态。0:未启动,1:前台,2:后台 |
| map_info.versionCode | 是 | string | 938 | 地图版本代码 |
| map_info.versionName | 是 | string | 10.19.8 | 地图版本号 |
数据格式:json
结果示例:
{"errno":0,"errstr":"ok","data":{"status":1,"tips":"好的,交给小度语音","token":"VX8xx/MA7SaZVmyOVOcOYY1JQbjA=dPl7dbFpkIFssbB8+RBab4xSDdCJb7x/EiDtYrCUEeF-zsBpsemlQSDYWeY6NKNMZ+k7TufpDJIt4aJrftOYnAPk","query":"去五道口地铁站途径西二旗"}}
参数说明:
| 参数名 | 必选 | 类型 | 值 | 描述 |
|---|---|---|---|---|
| errno | 是 | int | 0,... | 错误代码,0 成功,非0失败 |
| errstr | 是 | string | ok,… | 错误描述 |
| data | 是 | object | 返回数据 | |
| data.status | 是 | int | 0,1,2,3 | query鉴权结果:0 不支持 1 支持 2 当前场景不支持 3 当前场景暂不开放 |
| data.tips | 否 | string | 小度暂不支持该技能,好的交给小度语音,小度当前场景暂不支持该技能,小度当前场景暂不开放该技能 | query鉴权结果提示文案 |
| data.token | 是 | string | A6AIt3l-sKlk7PYVtwpclXy | 端上鉴权密钥,调起小度时传给小度,小度请求服务时回传 |
| data.query | 是 | string | 去五道口地铁站途径西二旗 | 查询query |
错误码说明:
| errno | errstr | 描述 |
|---|---|---|
| 0 | ok | 请求成功 |
| 1000 | 参数错误x.y | x.y 参数错误 |
| 200 | 鉴权错误:ak鉴权失败 | 鉴权错误:ak鉴权失败 |
下一篇
本篇文章对您是否有帮助?