谷歌地图附近搜索 API:按城市名定位,复用经纬度查多个关键词
| 同一个中心查询 N 个行业词 | 定位次数 | HTTP 请求次数 |
|---|---|---|
| 每个行业词都调用定位并搜索 | N | N |
| 首次定位并搜索,之后改用附近搜索 | 1 | N |
| 先单独定位,再查询所有行业词 | 1 | N + 1 |
前提是所有查询确实共用一个经过检查的搜索中心。这张表只计算逻辑工作量,不是延迟测试、费用测算或商家覆盖率报告。对海外门店调研而言,先确定“哪些条件变化会让中心失效”,比一开始就设计全城采集循环更实际。
先算重复定位次数,不把复用经纬度说成减少 HTTP 请求
只有城市名时,可以从定位并搜索开始;已有坐标时,则可直接查附近商家。同一个城市要分别查多个行业,首次保留坐标后,每个新关键词仍然需要一次请求,只是不再重复解析地点。
如果业务要求先人工确认城市中心,再拉取任何商家,单独定位的方案会多一次请求。这不是浪费,而是把确认地点作为独立步骤。不能仅凭“少定位几次”推导出固定的速度提升或费用节省,现有观察并未证明这些指标。表中的次数也不包含网络重试和主动更换中心的情况。
按城市名定位并搜索:location 与商家列表 data 是同级字段
平台调用使用公开操作 ID locate-and-search,不是标题里的路径拼写。下面保留已观察成功的公开地点查询条件,适合先理解请求结构;将密钥占位符替换为自己的平台密钥,并在服务端保管,避免写入共享链接或日志。
curl --get 'https://api.opendata-api.com/api/project/google-maps-extractor/locate-and-search' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'query=attorney in Philadelphia, PA, USA' \
--data-urlencode 'limit=3' \
--data-urlencode 'offset=0' \
--data-urlencode 'country=us' \
--data-urlencode 'language=en' \
--output first-search.json
复制示例、打开页面都不会自动发送请求。主动执行后,先检查 HTTP 状态,再看网关 code/message/data。进入网关 data 后,才是本接口的执行 status、商家 data 数组和定位 location 对象。不要把网关成功直接等同于拿到了可用坐标。
已保存的成功响应中,经纬度字段为 location.latitude 与 location.longitude。这里的 location 与商家数组同级,不在第一条商家记录里面。后续构造请求时,将这两个数值映射到 lat 与 lng,并检查类型、有限性及范围;不要从地点名称猜坐标。成功的商家列表可以为空,不需要为了保存中心而虚构一条商家。
固定 lat/lng 更换行业关键词,别把 limit、offset、zoom 传给附近搜索
确认中心后,使用公开操作 search-nearby。下面经纬度来自前述费城查询的保存结果;换了城市,应使用新会话中检查过的定位结果,不能继续沿用示例坐标。
curl --get 'https://api.opendata-api.com/api/project/google-maps-extractor/search-nearby' \
--data-urlencode 'key=YOUR_API_KEY' \
--data-urlencode 'query=attorney' \
--data-urlencode 'lat=39.9525839' \
--data-urlencode 'lng=-75.1652215' \
--data-urlencode 'country=us' \
--data-urlencode 'language=en'
同一中心查其他行业时,保留经纬度对,单独更换 query 发起下一次请求。这样比较的是“同一位置附近的不同关键词结果”,不是把关键词变化当作续页。
附近搜索只公开 country、language、lat、lng、query。组合查询中的 limit、offset、zoom 不能照搬过来,也没有 radius、翻页令牌或类型筛选参数。不要因为别的地图产品支持某个字段,就假定这里也支持。部分相关接口使用 lang,而定位、附近搜索和商家详情使用 language,调用层最好按操作维护参数表,避免用一个通用语言字段盲目转发。
只想确认城市坐标时,先用 /query_locate 而不是获取商家列表
若输入地点可能有歧义,可先调用公开操作 query-locate,例如提交 New York City, NY, USA。它返回执行状态与顶层 location,不要求有商家 data 数组;也不同时获取初始商家列表。
这种方案适合需要审核目标地区的调研后台。界面保留用户地点文字、国家背景和定位中心,确认之后才启动附近搜索。定位接口还提供可选的经纬度背景及 zoom,但一个相关 GPS 点不是邮政地址校验结果,更不是行政区域多边形。自动补全可以更早辅助输入,但不能仅凭它返回建议数组,就假定已取得可直接复用的坐标或商家标识符。
切换城市或国家后,旧搜索中心必须失效
把中心当成一次地点选择的状态,而不是永久缓存。只换行业词时,可以保留中心;换城市、国家、街区或目标区域时,应清空旧中心并重新确认。即使城市名称相同,用户从市中心转为某个郊区,地点意图也已经改变。
还要处理异步响应顺序:用户已经选了第二座城市,第一座城市较慢的响应才到达,不能覆盖新选择。可给地点选择增加版本号,接受响应前检查它是否仍对应当前版本。这是客户端状态控制,不代表接口保证坐标缓存时间或定位结果稳定不变。
城市中心点附近搜索,不等于采集全城商家
围绕一个点反复换关键词,只能得到这些请求实际返回的附近结果,不能据此计算全城商家总量、证明行政范围内无遗漏,或声称具备完整分页。覆盖研究需要另行设计可解释的采样方法,不能把中心点复用当作全城抓取策略。
后续详情、评论与图库也应保持各自边界:用选定的 business_id 查询详情时,可选属性可能为 null;评论和照片通过 next_token 到 next_page_token 续页,并不是附近搜索的分页方式。照片分类是图库筛选,不是商家经营类型。拿到照片数据还需另外确认图片权利。保留实际返回记录和查询背景,比把有限候选名单包装成完整数据库更可靠。