篇二·深度检索地图API实战教程:快速接入与示例代码

25 阅读7分钟

游客在聊天框里写下:“给我一份北京三日游攻略,喜欢历史与胡同美食,预算适中。”直接把这条输入交给普通检索,会出现一堆独立景点,但不会告诉你怎样安排每天、交通如何衔接、哪里该避开高峰。深度检索的目标是把“复杂问题”——像写攻略这样的任务,变成一份结构化、可执行的答案。

深度检索是什么

深度检索是“会思考和输出过程”的检索:它不仅检索候选项,还会在流式返回中展现推理过程(中间状态),最终产出结构化方案(行程、交通、餐饮建议等)。

技术特征

  • 流式输出(SSE):服务端以事件流形式发送中间思路与最终结果,方便实时展现“思考过程”。

  • 多轮聚合:会考虑时间、交通、开放时间、用户偏好等多维信息进行综合排序与组合。

  • 最终输出:比如每天行程、预计时长、路线建议、替代项与餐饮推荐。

快速上手

1.在百度地图开放平台控制台开启「深度检索」权限并获取AK。

为了正常调用 API ,请先注册成为百度地图开放平台开发者,并申请 Web API平台的 AK。

可前往该链接创建:lbs.baidu.com/apiconsole/…

  • 点击创建应用

  • 勾选深度检索服务后,点击提交即可完成AK创建

2.参考官网文档提供必填参数,如query等进行调用,即可获得SSE流式输出,输出数据中is_end为false时,可以获取reason字段为思考过程,待is_end为true时,即可获取本次检索所召回的POI列表

必填参数如下:

query可以为任意检索词,如“北京三日游攻略”

应用案例

假设我希望获取一份北京市的三日旅游攻略,便可以构造如下请求链接

api.map.baidu.com/api\_place\…

参考官网的python demo对流式输出进行处理,即可获得深度检索对完整北京三日旅游的攻略输出并获取对应POI缩简信息。

开始接收流式数据...

用户想要一份北京市三日旅游攻略,目前已经提供了北京市内多个著名景点的信息,包括颐和园、天坛公园、天安门广场、故宫博物院、八达岭长城、圆明园遗址公园、什刹海公园、景山公园、中国国家博物馆和

紫谷伊甸园。这些景点涵盖了历史文化、自然风光和现代娱乐等多个方面,适合不同兴趣的游客。

为了制定一个合理的三日行程,我需要考虑以下几点:

1. 景点之间的距离和交通便利性,避免行程过于紧凑或浪费时间在交通上。

2. 景点的开放时间和实时活动,确保游客能够参与感兴趣的活动。

3. 景点的热门程度和游客流量,避免在高峰期参观过于拥挤的景点。

4. 游客的兴趣偏好,虽然用户没有明确说明,但可以根据景点的多样性和特色来安排。

首先,我会调用百度

地图的地点搜索推荐能力,查找一些适合三日游的路线推荐或攻略,看看是否有现成的行程可以参考。同时,我也会调用网页和笔记搜索能力,查找最新的旅游攻略和游客评价,以确保推荐的行程是实用和受欢迎的。

此外,部分景点如颐和园和圆明园遗址公园显示“疑似停业或下线”,需要进一步确认它们的实际开放状态。我会调用精确地点查找工具来确认这些景点的最新信息

🤔我重新进行了以下搜索行为:1) 通过百度地图搜索了"北京市三日游路线",获取了北京环球度假区的推荐信息;2) 通过全网网页搜索了"北京三日游推荐"、"北京三日游攻略"和"北京三日游行程",收集了大量详细的行程安排和实用建议;3) 通过百度地图的精确地点搜索功能确认了颐和园和圆明园遗址公园的具体位置和开放状态

目前已经收集了丰富的三日游攻略信息,包括多个经典行程安排、景点开放状态、实用建议和美食推荐。这些信息已经足够为用户制定一个完整的三日游计划。考虑到信息已经非常全面,不需要再继续搜索了。接下来可以根据这些信息为用户整理一份详细的行程建议

# 🌟北京三日游精华攻略

## 🏛️ **文化历史之旅**

**第一天**最适合感受北京的千年文脉:

- **@故宫博物院[4]**: 作为世界文化遗产,这里完整保留了明清两代的皇家气派。建议从午门进入,沿中轴线游览太和殿、乾清宫等核心建筑,**红墙金瓦**随手一拍都是大片。珍宝馆的文物展不容错过!

- **@景山公园[8]**: 故宫北门出来步行5分钟就到。登上万春亭可以**俯瞰紫禁城全景**,夕阳时分尤其震撼。公园内的寿皇殿建筑群也值得一看。

## 🏯 **皇家园林体验**

**第二天**推荐感受皇家园林的恢弘:

- **@颐和园[1]**: 中国现存最大的皇家园林,昆明湖泛舟和长廊漫步是**必体验项目**。近期有荷花文化节(至8月31日),可以乘船穿越西堤藕花深处。

- **@圆明园遗址公园[6]**: 虽然只剩断壁残垣,但通过"时光巴士"XR技术能**重现盛景**,对比古今特别有教育意义。建议从东门进入参观大水法遗址。

## 🚶 **胡同烟火气**

**第三天**深入老北京生活:

- **@什刹海公园[7]**: 夏天划船冬天滑冰,周边胡同藏着**地道京味儿**。推荐坐三轮车听车夫讲老北京故事,宋庆龄故居旁的老槐树有周总理接见外宾的往事。

- **南锣鼓巷**: (无数字索引)虽然商业化但仍有韵味,拐进两侧胡同能找到安静的四合院和手工艺店铺。帽儿胡同的非遗"兔儿爷"彩绘体验很有趣。

## 🍜 **必吃美食推荐**

- **四季民福烤鸭**: 故宫店窗边位能拍角楼夜景,**酥不腻**烤鸭配鱼子酱是创新吃法

- **门框胡同百年卤煮**: 内脏处理干净无腥味,搭配**豆汁焦圈**体验老北京早餐

- **牛街聚宝源涮肉**: 手切羊肉配秘制麻酱,饭后别忘了买白记年糕的**驴打滚**

## ⚠️ **实用小贴士**

1. **提前预约**:故宫/国博需提前7天抢票,周一闭馆

2. **交通建议**:地铁比打车快3倍,下载"亿通行"APP扫码乘车

3. **省时技巧**:故宫走东华门入口避开人流,颐和园从新建宫门进可快速到十七孔桥

4. **特别提醒**:近期@天安门广场[3]8月20-23日暂停开放,@颐和园[1]因暴雨临时闭园至21日,出行前建议再次确认

这样安排既能感受**皇家气派**,又能体验**市井生活**,最后一天如果体力允许,晚上可以去@奥林匹克公园看鸟巢水立方的**璀璨夜景**哦!

搜索结果: {'status': 0, 'message': 'ok', 'results': [{*************}

(返回到POI结果因涉及数据信息不作具体展示,可到开平官网体验效果)

快根据教程开始你的深度检索之旅吧~

更多详情可前往官网技术文档:

lbs.baidu.com/faq/api?tit…