全部服务产品
开发者频道
服务升级
登录
语音助手互通
下载开发文档
背景说明

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

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

线上域名:https://api.map.baidu.com
方法路径:baidumapvoice/v1/check
请求示例:https://api.map.baidu.com/baidumapvoice/v1/check

https://api.map.baidu.com/baidumapvoice/v1/check?
pname=xxx
&ak=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
&query=%E5%8E%BB%E4%BA%94%E9%81%93%E5%8F%A3%E5%9C%B0%E9%93%81%E7%AB%99%E9%
80%94%E5%BE%84%E8%A5%BF%E4%BA%8C%E6%97%97
&caller=%7b%22pb%22%3a%%22%2c%22mb%22%3a%22V1836A%22%2c%22os%22%3a%
229%22%2c%22pcn%22%3a%%22%2c%22ver%22%3a%2231000%22%2c%22m
ap_info%22%3a%7b%22app%22%3a%22com.baidu.BaiduMap%22%2c%22processState%22%
3a0%2c%22versionCode%22%3a938%2c%22versionName%22%3a%2220.20.20%22%7d%7d
&callee=iLTmEGYURKSx_xV%2ByJ%3DKOzwaB9iR5Vc5Q1Vm%3D%2Fx_bKKm_5n%
2BA_CK8JuoBV5aHa7Ba14mxb5oP_cuM54JAiy-FzVSFXtjKVpVPYNpEGVfaZgJNO3%2Bq%
2B39Vajsr3fn5
G%3D5Oc%3D%2Bz%2FlpGnEJMrkip7kQVVoZP3%3DemWE2OLShzFTHRDokPcx-
E8nK8kpGuVVz1WEsOD_JDb4SOZgANI-rlY3lEau0BabjMVpVPYFdEgkDyg%
3DpCOVdwl4UOm6KxQ9%2Bml%2Bq
Z6TeNGKU%3DLdAzOJxDL4pFj8eF%3D%3DeN7%3D5gX_XOGWUOZzUBm4JDL4uBgCIF%3D%3DeN7%
3D5hXLmDQpDhj2i_vlHlY43Ehoaq0ydL7l%2BG%2F4XEjofaWvuB9ohpJ3jV_qCN40NZ0ChQ
HBBzVpHinK5LIq0lz7SA6MaDpiRLp_hNYFYkpMIOWsILdqfpVnKkXpGD7lzZViImlBBNpd_Gzqi
_5o0ywo3Oowmr4pGLXtKG%2F%3DHDb4SOZgiBe7_xxLKEXqZrWBgZK%3D5ZnAmDYpgHnmCNC
o0C79RVjVCzGlG5Klhh5yXq%2FUHOguJYv7jlVoj8gMaqK%3DeLDb5_2qIH</span>

结果示例:

{
"errno":0,
"errstr":"ok",
"data":{
"status":1,
"tips":"好的,交给小度语音",
"token":"xxxx",
"query":"去五道口地铁站途径西二旗"
}
}
上行参数
参数名必选类型描述
pnamestringxxx_xxx调用者产品名称
akstringxxxxxxxxxxxx服务鉴权密钥,百度分配
querystring去五道口地铁站途径西二旗查询query
callerstring{"pb":"xx","mb":"V1829A","os":"Android28","pcn":"com.xxx.xxx","ver":"2.5.0.3"}调用者(小V)场景信息,json string格式,具体格式和字段见下表
calleestringiLTmEGYURKSx_xV+yJ=KOzwaB被调用者(小度)场景信息,调用者(小x)从小度端获取,对调用者透明
caller调用者(小x)场景信息参数说明【小x客户端自己获取】
参数名必选类型描述
pbstringxxx手机品牌
mbstringV1829A手机型号
osstringAndroid28设备系统版本号
pcnstringcom.xxx.agent(示意)助手包名
verstring2.5.0.3助手版本
ctmstring1578918651425客户端当前时间毫秒数
map_infoobject地图状态信息
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":"xxx",
"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请求成功
2000服务不可用服务不可用
1000参数错误x.y参数错误x.y
1001鉴权错误:ak鉴权失败鉴权错误:ak鉴权失败

上一篇

上下车提醒

下一篇

距离和面积计算

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