产品服务
解决方案
文档与支持
定价
语音助手互通
下载开发文档
接口说明

为了给用户提供最佳的语音交互体验,百度地图提出一种语音助手深度互通方案,该方案打破了各语音助手之间的屏障,构建起一个繁荣的语音助 手互通生态。

接口协议
1.服务端接口协议
调用方式

线上域名: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=E58EBBE4BA94E98193E58FA3E59CB0E99381E7AB99E9
8094E5BE84E8A5BFE4BA8CE69797
&caller=7b22pb223a22vivo222c22mb223a22V1836A222c22os223a
229%222c22pcn223a22com.vivo.agent222c22ver223a2231000222c22m
ap_info22%3a7b22app223a22com.baidu.BaiduMap222c22processState22%
3a02c22versionCode223a9382c22versionName223a2220.20.20%227d7d
&callee=iLTmEGYURKSx xV%2ByJ%3DKOzwaB9iR5Vc5Q1Vm3D%2Fx bKKm 5n%
2BA_CK8JuoBV5aHa7Ba14mxb5oP_cuM54JAiy-FzVSFXtjKVpVPYNpEGVfaZgJNO3%2Bq%
2B39Vajsr3fn5
G3D50c3D2Bz2FlpGnEJMrkip7kQVVoZP3%3DemWE2OLShzFTHRDokPcx-
E8nK8kpGuVVz1WEsOD_JDb4SOZgANI-rlY3lEau0BabjMVpVPYFdEgkDyg%
3DpCOVdwl4UOm6KxQ9%2Bml%2Bq
Z6TeNGKU%3DLdAzOJxDL4pFj8eF3D3DeN7%3D5gX XOGWUOZzUBm4JDL4uBgCIF&3D3DeN7%
3D5hXLmDQpDhj2i_vlHlY43Ehoaq0ydL7l%2BG%2F4XEjofaWvuB9ohpJ3jV_qCN40NZ0ChQ
HBBzVpHinK5LIq0lz7SA6MaDpiRLp_hNYFYkpMIOWsILdqfpVnKkXpGD7lzZViImlBBNpd_Gzqi
_5o0ywo30owmr4pGLXtKG2F%3DHDb4SOZgiBe7_xxLKEXqZrWBgZK3D5ZnAmDYpgHnmCNC
o0C79RVjVCzGlG5Klhh5yXq%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":"开始导航"
}
}
上行参数
参数名必选类型描述
pnamestringxxx_xxx调用者产品名称,双方约定,格式:品牌名_产品名
akstringxxxxxxxxxxxx服务鉴权密钥,百度开放平台申请配额及 QPS
querystring去五道口地铁站途径西二旗用户查询 query
callerstring{"pb":"xx","mb":"V1829A","os":"Android28","pcn":"com.xxx.xxx","ver":"2.5.0.3"}调用者(系统语音)场景信息,json string 格式,具体格式和字段见下表
calleestringiLTmEGYURKSx_xV+yJ=KOzwaB被调用者(地图小度语音)场景信息,调用者(系统语音)从地图客户端获取,对调用者透明
caller调用者(小x)场景信息参数说明【小x客户端自己获取】
参数名必选类型描述
Pbstringxxx手机品牌
MbstringV1829A手机型号
OsstringAndroid28设备系统版本号Build.VERSION.RELEASE
Pcnstringcom.xxx.agent(示意)助手包名
Verstring2.5.0.3助手版本
Ctmstring1578918651425客户端当前时间毫秒数
map_infoobject地图状态信息(包含下面 4 个参数,判断地图未启动 or 前后台)
map_info.appstringcom.baidu.BaiduMap地图包名
map_info.processStatestring0,1,2地图进程状态。0:未启动,1:前台,2:后台
map_info.versionCodestring938地图版本代码
map_info.versionNamestring10.19.8地图版本号
下行参数

数据格式:json
结果示例:

{
"errno":0,
"errstr":"ok",
"data":{
"status":1,
"tips":"好的,交给小度语音",
"token":"VX8xx/MA7SaZVmyOVOcOYY1JQbjA=dPl7dbFpkIFssbB8+RBab4xSDdCJb7x/E
iDtYrCUEeF-zsBpsemlQSDYWeY6NKNMZ+k7TufpDJIt4aJrftOYnAPk",
"query":"去五道口地铁站途径西二旗"
}
}

参数说明:

参数名必选类型描述
errnoint0,...错误代码,0 成功,非0失败
errstrstringok,…错误描述
dataobject返回数据
data.statusint0,1,2,3query鉴权结果:0 不支持 1 支持 2 当前场景不支持 3 当前场景暂不开放
data.tipsstring小度暂不支持该技能,好的交给小度语音,小度当前场景暂不支持该技能,小度当前场景暂不开放该技能query鉴权结果提示文案
data.tokenstringA6AIt3l-sKlk7PYVtwpclXy端上鉴权密钥,调起小度时传给小度,小度请求服务时回传
data.querystring去五道口地铁站途径西二旗查询query

错误码说明:

errnoerrstr描述
0ok请求成功
1000参数错误x.yx.y 参数错误
200鉴权错误:ak鉴权失败鉴权错误:ak鉴权失败

下一篇

概述

本篇文章对您是否有帮助?