根据部分地名获取 Yelp 地点自动补全建议
查看 Yelp 商家、评论与餐厅数据 的全部接口 →在必填的 query 字符串中输入部分地名，例如 Beverly Hills，即可请求地点建议。文档描述的建议范围包括城市、街区和地区。此接口用于地理位置输入建议，不用于商家名称搜索、商家匹配、地址验证或地理边界查询。 目前没有此接口的实测响应，提供的 HTTP 200 示例也是空对象。文档虽然描述了地点建议，但没有确认具体响应键名、列表嵌套结构、建议类型、排序规则、标识符、坐标、结果数量上限或分页方式，不应默认存在这些字段。 可使用建议帮助用户先选择地点名称，再单独进行商家查询或地理信息审核。需要追溯时，应同时保留原始查询和所选建议。文档没有保证建议结果可直接用作 Yelp 活动页面的城市短名称，建议地点也不能证明某家商家确实位于那里。
API 功能
单参数输入部分地名 通过唯一必填的 query 字符串，根据用户输入的地名请求建议，文档示例为 Beverly Hills。
覆盖三类地点名称建议 文档描述的范围涵盖城市、街区和地区，但尚未确认响应中的类型标签、地理坐标或边界数据。
先选地点再查询商家 在商家查询之前提供独立的地点选择步骤。地点建议不能展示为已匹配商家，也不能据此推断门店记录。
保留可复核的地点选择记录 在审核流程中同时保留用户原始输入和所选建议，而不是将建议名称视为权威地理边界或地址验证结果。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/yelp/location-autocomplete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/location-autocomplete?key=<API_KEY>&query=Beverly+Hills'
curl -X GET 'https://api.opendata-api.com/api/project/yelp/location-autocomplete?key=<API_KEY>&query=Beverly+Hills'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 在餐厅查询表单中先展示地点建议，再单独发起名称与地点组合查询，并明确选择地点不代表已经匹配到商家。
- 为门店审计队列规范分析人员输入的地理名称，同时保留原始查询和所选建议，供后续复核。
- 让编辑为本地指南标注地点时比较城市、街区与地区建议，不根据名称推断地图边界或坐标。
- 在多地点调研资料收集流程中加入人工审核的地点选择步骤，再构建针对具体商家的查询请求。
常见问题
query 应该填写什么？
填写部分地名，类型为必填字符串，文档示例为 Beverly Hills。请求定义没有规定最少字符数，也没有额外的国家筛选参数。
此接口返回商家还是地点建议？
文档说明此接口提供地点建议，包括城市、街区和地区。建议不等于商家匹配结果，也不能证明某家餐厅或门店位于该地点。
结果是否包含坐标、边界或地址验证信息？
现有资料无法确认。目前没有此接口的实测响应，提供的 HTTP 200 示例也是空对象，因此不能默认存在具体键名、坐标、边界或验证状态。
能否将地点建议直接传给活动搜索的 city 参数？
不能未经检查就直接使用。活动搜索需要 Yelp 活动页面的城市短名称或活动链接，而此接口响应中的标识符与格式尚未验证。文档没有说明建议的地点名称就是活动页面的城市短名称。
会返回多少条建议？是否支持翻页？
现有文档没有确认建议数量、排序保证或分页字段。query 是唯一有文档说明的请求参数，空对象示例也无法验证结果列表的结构。