用自由文本查询(如行业加城市)搜索谷歌地图商家,同时返回解析出的位置。

查看 谷歌地图数据 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 功能

一次调用完成定位与搜索 查询词会先被解析为地图位置,再列出周边的商家,因此搜索之前不需要单独发起地理编码请求。
用日常语言输入查询 直接输入行业加地点,例如 "attorney in Philadelphia, PA, USA" 或 "restaurant in New York City",不必自己提供经纬度。
每个地点自带联系方式与评分 每条地点记录都带有电话、网站、评分、评论数、按星期划分的营业时间和主营类别,一次响应就足以整理出一份初步的获客名单。
返回解析后的位置对象 location 对象会给出查询被解析到的纬度、经度和缩放级别,可以保存下来,用于后续的周边搜索。
用 limit 和 offset 切片 limit 默认为 20,offset 默认为 0,测试中 limit=5 返回了五个地点。测试调用没有验证 offset 翻页本身。
用缩放级别控制搜索范围 可选参数 zoom 接受 3(缩小)到 21(放大)之间的值,用来设定地图视野的范围,可以分别尝试全城搜索和街道级搜索。
ID 可直接用于商家类接口 每条记录包含 google_id、place_id 和 cid,与商家详情、照片和评论接口文档中 business_id 支持的标识类型一致。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

定位并搜索接口返回什么内容?

返回一个 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。两者都是可选参数,文档没有列出可接受的取值,测试调用也没有传这两个参数。

相关接口

相关指南

查看订阅方案 →