用自由文本查询(如行业加城市)搜索谷歌地图商家,同时返回解析出的位置。
查看 谷歌地图数据 API:商家搜索、评论与照片采集 的全部接口 →一次请求即可把自由文本查询解析为地图位置,再列出该位置周边找到的商家。必填参数 query(例如 "attorney in Philadelphia, PA, USA"),可选参数 country、language、limit(默认 20)、offset(默认 0)和 zoom(3 为缩小视图,21 为放大视图)。响应是一个 JSON 对象,包含 status(成功时为 true)、request_id、地点数组 data、location 对象以及回显的 request_params。在 limit=5 的实际测试调用中,data 返回了 5 个地点,每个地点有 37 个字段:google_id、google_mid、place_id、cid、name、status(五个全部为 OPEN)、address、full_address、detailed_address 对象(district、street、city、zip_code、state、country)、main_category、category_id、categories、latitude、longitude、time_zone、phone、full_phone、website_url、website_domain、按星期给出的 working_hours、rating、reviews_count、featured_photo、about 属性分组、店主相关字段,以及酒店、价格和预订相关字段(样本中的律师事务所这些字段为 null)。location 对象包含 id、name、altitude、latitude、longitude 和 zoom,其中 id 与 name 为 null,zoom 为 7。文档说明,这个方法把 query 定位与周边搜索两个操作合并在了一起,并建议在反复查询同一区域时,复用返回的 location 去调用周边搜索接口。接口文档中公布的响应示例是空对象,因此上述字段均来自实际测试调用。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/google-maps-extractor/locate-and-search API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/google-maps-extractor/locate-and-search?key=<API_KEY>&limit=20&offset=0&query=attorney+in+Philadelphia%2C+PA%2C+USA'
查询结果
使用场景
- 快速原型验证获客搜索,例如一次请求查找丹佛的水管工,然后保留返回的 location,后续批量任务改用周边搜索
- 借助 limit 和 offset,在 20 个候选城市中各取 5 个地点作为样本,用于市场进入对比
- 适用于快速演示或无代码工作流:用户只输入查询词和国家,没有可用的坐标
- 只改变 language 和 country,对比同一个关键词在不同语言或国家下的解析结果
- 在决定哪些城市值得深入扫描之前,先为每个城市抓取前几家商家,填充外联名单
- 按评分和 reviews_count 筛选某个城市的某类商家,为合作伙伴计划挑选口碑好的候选
常见问题
定位并搜索接口返回什么内容?
返回一个 JSON 对象,包含 status、request_id、地点数组 data、location 对象以及回显的 request_params。在 limit=5 的实际测试调用中,data 有五个地点,每个地点 37 个字段,location 包含 latitude、longitude、zoom、altitude、id 和 name。
哪些参数是必填的?
只有 query 必填,示例值为 "attorney in Philadelphia, PA, USA",文档建议使用类似 "restaurant in New York City" 的格式。country、language、limit、offset 和 zoom 为可选参数。
它与单独的 query 定位和周边搜索有什么区别?
它在一次请求中完成这两个步骤。文档建议,如果要反复查询同一区域,先调用一次本接口,保存返回的 location,再用这个 location 调用周边搜索接口,这样更快,因为位置只需解析一次。
limit 和 offset 怎么用?
limit 是返回结果的最大数量(默认 20),offset 用来跳过若干结果(默认 0)。测试调用使用 limit=5,返回了五个地点。offset 翻页和 limit 的最大值都没有测试过,请用你自己的查询验证。
zoom 接受什么范围?
文档给出的范围是 3(缩小)到 21(放大),类型为数字。测试调用没有传 zoom,其 location 对象显示的 zoom 为 7,但它与默认值的关系文档中没有说明。
为什么有些地点字段是 null?
与类别相关的字段在不适用时为空。在样本中的律师事务所里,hotel_stars、hotel_about、price_range、reservation_url 和 order_online_url 为 null,而 phone、website_url、rating 和 working_hours 有值。请对每个字段都做空值判断。
语言参数在这里也叫 lang 吗?
不是。本接口把它命名为 language,而商家照片和评论接口使用的是 lang。两者都是可选参数,文档没有列出可接受的取值,测试调用也没有传这两个参数。