谷歌地图信息抓取工具

从地区和行业关键词出发，把地图上的商家整理成可分析、可跟进的资料清单。谷歌地图信息抓取工具适合需要寻找海外潜在客户、了解区域商家分布、比较市场情况或开展门店选址研究的用户。

输入目标地区及关键词，例如某个城市的建材门店、汽配商、餐厅或咖啡店，软件依次完成地区定位、分区搜索与商家详情获取，整理名称、地址、电话、官网、评分和商家类型等信息。多个地区可组成任务队列，多个关键词可用英文竖线 | 分隔。

获得商家官网后，可继续抓取网站公开联系信息，补充邮箱、网站电话、社交媒体和即时通讯链接；结果连同来源地区、关键词、采集状态及时间一起进入本机地图库。通过筛选、排序和 CSV 导出，可把地图搜索结果转为后续客户开发与数据分析的基础资料。

本工具采集平台为 Google Maps／谷歌地图。搜索依据关键词与区域条件返回相关 POI，不把相关性搜索等同于商户名称的逐字包含筛选，也不承诺获取某地区全部商家。

标准 CSV 共 18 列：地图资料、官网联系信息、任务来源与时间记录分别列出，方便核对和后续分析。

1. 名称（name）
POI／商家名称。 来源：地图信息。

2. 地址（formatted_address）
商家地址，用于区域核对、业务分组和选址研究。 来源：地图信息。

3. 电话（formatted_phone_number）
地图详情返回的商家联系电话。 来源：地图信息。

4. 网站（website）
商家网站地址，也是后续官网联系信息采集的入口。 来源：地图信息。

5. 网站邮箱（website_email）
从官网页面或邮件链接提取的公开邮箱。 来源：官网补充。

6. 网站社交媒体（website_social_media）
官网链接中的 Facebook、Instagram、LinkedIn、YouTube、X／Twitter、TikTok、Pinterest 等社交账号或页面。 来源：官网补充。

7. 即时通讯链接（instant_messaging）
官网公开的 WhatsApp、Telegram、LINE、Messenger 等链接。 来源：官网补充。

8. 评分（rating）
地图返回的评分，可用于最低评分筛选和数值排序。 来源：地图信息。

9. 评分总数（user_ratings_total）
地图返回的评分数量，可作为评价活跃度的参考。 来源：地图信息。

10. 类型（types）
接口返回的地点类型标签，帮助识别业务类别。 来源：地图信息。

11. Place ID（place_id）
Google 地点标识，用于关联和合并同一商家的记录。 来源：地图信息。

12. 网站电话（website_phone）
从官网 tel: 电话链接提取的号码，与地图电话分开保存。 来源：官网补充。

13. 来源地区（regions）
发现该商家的搜索地区，可汇总多个地区来源。 来源：任务记录。

14. 来源关键词（keywords）
发现该商家时使用的关键词，可汇总多个搜索词。 来源：任务记录。

15. 网站采集状态（website_status）
官网联系信息任务的执行状态，便于筛选和安排后续处理。 来源：任务记录。

16. 更新时间（updated_at）
商家资料在地图库中的最近更新时间。 来源：时间记录。

17. 联系信息来源（contact_sources）
联系信息类型、具体值及对应网页 URL，便于追溯核对。 来源：来源记录。

18. 首次入库时间（created_at）
该商家首次进入本机地图库的时间。 来源：时间记录。

标准 CSV 使用以上 18 个英文字段键作为列名，按表中顺序输出。前 16 项用于地图库列表展示，部分列可受界面显示设置影响；联系信息来源和首次入库时间也可在商家详情中查看。采集内容以 Google 接口返回和官网公开页面为准；官网联系信息需运行网站采集任务后补充。

用地区组织市场，用关键词组织商家类型。单次可设置多个地区和多个关键词，每个地区形成独立任务，便于比较不同城市、行政区域或地标周边的商户情况。地区列表支持分行填写、分号分隔和 UTF-8 TXT 导入。

程序先取得地区的定位范围，再依据 0.5～50 公里的半径设置生成网格搜索点。这里的半径是分区扫描参数，不是用户手绘边界或严格行政区裁剪；可结合结果地址进一步核对业务范围。

关键词翻译为可选功能：支持配置 New API、sub2api 或 DeepSeek；New API／sub2api 可选择 Chat Completions 或 Responses 格式，DeepSeek 使用 Chat Completions。多地区任务翻译时以第一个地区为语言参考，跨语言市场建议分批设置。Google API 与翻译 API 分别配置，分别按相应服务计费。

地图发现商家，官网补充联络线索。已有官网的商家可继续进行网站采集，在首页及识别到的同站联系／关于页面中提取公开邮箱、tel: 电话链接、社交媒体和即时通讯链接。

可识别中文、英文及多种语言的联系页关键词。社交媒体包括 Facebook、Instagram、LinkedIn、YouTube、X／Twitter、TikTok、Pinterest 等；即时通讯包括 WhatsApp、Telegram、LINE、Messenger 等。每项提取值附带来源页面 URL，方便后续核对。

网站采集范围可选“当前筛选结果”或“已选商家”，每个官网最多访问 1～10 页，默认 5 页。同一任务内相同规范化官网地址只建立一组采集步骤，结果回填关联商家；不同路径或参数可能形成不同入口，不等同于所有同域页面只访问一次。

结果逐页保存，后续页面失败不会撤销已保存的页面结果。需要登录或依赖 JavaScript 渲染的内容不属于当前普通网页解析方式的完整覆盖范围；提取的是公开页面信息，不代表联系渠道已验证有效。

把一次搜索变成可持续整理的本机商户资料库。结果、任务和处理步骤保存在 SQLite 地图库中，无需另外安装数据库服务。不同任务命中的同一 Place ID 合并到同一商家记录，同时保留地区和关键词关联；跨任务仍可能产生新的接口请求，去重不代表免除 API 调用费用。

地图库支持搜索名称、地址、电话、官网和邮箱；按来源地区、任务、最低评分、最低评价数、是否有官网／邮箱／电话／即时通讯链接及网站采集状态组合筛选。评分与评价数按数值排序，每页显示 200 条，可分页查看。

双击单元格复制内容，右键查看完整商家记录、原始返回数据及联系信息来源。导出操作覆盖当前筛选条件下的全部分页，并保留当前排序；CSV 为 18 列、UTF-8 BOM 编码，可用 Excel 等软件继续整理。

在“数据库”入口查看文件位置、打开所在目录或备份 SQLite 文件。同一地图库仅允许一个程序窗口打开，以避免任务恢复冲突。API 密钥不写入地图库；Google API Key 在重启后需要重新填写。

任务中心管理地区搜索与官网采集。可查看任务状态、完成步骤、失败数、商家数和创建时间；选择任务后查看结果、继续未完成步骤或取消等待任务。

暂停和停止不会立即中断已经发出的网络请求，而是在当前请求结束并保存后停止后续请求。关闭软件时先暂停并保存；重新打开后由用户在任务中心继续，不会自动启动收费采集请求。

断点按地区定位、区域搜索、商家详情和网站页面等步骤保存，已提交完成的步骤不重复执行。异常退出时尚未提交的请求可能重做；过期分页令牌也可能触发重新搜索，因此不承诺断点恢复完全没有重复请求。

失败清单展示任务、阶段、目标、错误类型、原因和尝试次数。可以仅重试选中的失败步骤，并执行由它们新发现的后续步骤；其他未选失败项不会一起重试。接口权限或配额异常会触发搜索任务暂停，便于处理后继续。

地图与官网承担不同的信息来源角色。商家基础资料来自 Google Maps 相关接口，邮箱、网站电话、社交媒体及即时通讯链接通过官网公开页面补充。请按业务用途核对资料与来源，不把采集到的联系方式视为有效性验证或成交承诺。

搜索结果是业务研究样本。关键词按接口搜索逻辑匹配相关地点，不是商家名称的严格逐字筛选；地区定位范围、半径、服务返回和请求配额都会影响结果，不保证某地区、行业或网站的全量信息。

先确认接口兼容性与成本。当前实现使用 Places Legacy 调用方式；Google Cloud 项目需要具备对应服务权限。可参考 Google 官方 Legacy 服务说明。建议先以小范围任务确认密钥、配额与结果，再扩大地区和关键词数量。

功能边界明确。软件用于资料采集、整理和导出，不自动发送邮件或即时通讯消息，不内置客流预测、热力图或自动选址评分。数据分析与选址决策可结合导出的资料在其他工具中完成；数据的使用与保存应符合所使用服务的规则。