需对接高德web服务api实现地理编码与周边搜索闭环:先用geocode接口解析地址为坐标,再以坐标调用around接口按typecode精准检索500米内商户,最后结构化输出名称、地址、距离、电话等字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在扣子(Coze)Bot中实现“用户输入地点名称→自动解析坐标→精准搜索周边商户”的闭环,必须绕过扣子原生插件的模糊匹配限制,直接对接高德地图Web服务API,并严格控制请求参数格式与地理编码链路。
获取高德地图Web服务API Key
访问高德开放平台控制台,使用手机号注册账号→实名认证→创建新应用→在“应用管理”中勾选“Web服务API”→提交审核。审核通过后,在“应用信息”页复制生成的Key值。
【注意:必须选择“Web服务API”类型,而非“JavaScript API”或“iOS/Android SDK”。选错类型会导致后续所有请求返回status=10008(非法key)】
配置扣子HTTP请求插件
进入Bot编辑页→点击左侧“插件”→右上角“+添加插件”→选择“HTTP请求”→填写以下字段:
• 请求URL:https://restapi.amap.com/v3/geocode/geo?address={address}&city=全国&key={your_key}
• 请求方法:GET
• 参数映射:将用户输入的原始地址文本绑定到{address};将上一步获取的Key粘贴进{your_key};city参数固定填“全国”,避免因城市识别偏差漏掉跨市POI。
这一步操作起来很简单,直接把变量名写进URL模板里就行,不需要额外写代码。
构建地理编码→周边搜索双链路
第一步:调用地理编码接口获取经纬度
• 在HTTP插件中设置响应体提取规则:json:geocodes[0].location
• 输出结果示例:116.481028,39.989643(经度在前,纬度在后,逗号为英文半角)
第二步:用该坐标发起周边搜索请求
• 新增第二个HTTP插件,URL填:https://restapi.amap.com/v3/place/around?location={location}&radius=500&keywords={keywords}&types={typecode}&offset=20&key={your_key}
• 关键参数说明:
– radius设为500(米),避免返回过多低相关结果;
– keywords留空,仅靠types精准过滤类别;
– types必须填高德官方分类码(如餐饮填050000,咖啡馆填050101),不能填汉字;
– offset=20确保单次最多拉取20条,防止超时失败。
【若types填汉字(如“咖啡馆”),高德API会静默忽略该参数,返回全量POI,导致结果严重偏离预期】
结构化输出商户信息
方法一:用JSONPath提取关键字段
• 在第二个HTTP插件的“响应体提取”中依次配置:
– 名称:json:pois[0].name
– 地址:json:pois[0].address
– 距离:json:pois[0].distance
– 电话:json:pois[0].tel
方法二:启用“循环遍历”模式批量处理
• 开启插件高级设置中的“循环遍历”,路径填json:pois;
• 每个循环项内分别提取name、address、distance;
• 系统自动拼接成带编号的列表,无需手动写for循环。
这一步做完后,Bot就能把原始JSON里杂乱的20条数据,变成清晰可读的结构化卡片了。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










