Google Maps 商家采集¶

你可以按关键词 + 地区创建 Google Maps 采集任务，随后在主面板查看任务状态、采集进度和商家数据。

本文只描述当前已经实现的主流程。网站是否可访问、Google Maps 页面变化和目标商家公开信息是否完整，都会影响最终结果。

这项功能能做什么¶

一次选择一个或多个关键词。
一次选择一个或多个国家，并按州 / 省或城市范围采集。
把多国、多地区合并成一个地图任务，统一查看进度。
暂停、继续、结束或删除任务。
查看商家、官网、邮箱和电话数据；官网、邮箱、电话提供去重列表。
在账号权限允许时批量导出商家数据。

使用前准备¶

开始前请确认：

已安装并启用当前 Chrome 扩展。
浏览器能够正常访问 Google Maps。
点击扩展图标后，可以打开主面板。

创建第一条地图任务本身不要求先登录，但登录状态和地图会员状态会影响本地数据量与批量导出能力。

从哪里进入¶

你可以从以下任一入口开始：

点击扩展图标，在弹窗中选择 创建任务。
点击扩展图标，选择 打开主面板，再点击左侧的 创建任务。
在主面板的任务页面，点击右上角的 创建任务。

完成一次采集¶

flowchart TD
    A[打开扩展或主面板] --> B[点击创建任务]
    B --> C[选择关键词和地区]
    C --> D[提交地图任务]
    D --> E[任务排队或开始运行]
    E --> F[查看进度和采集数量]
    F --> G[进入数据查看结果]
    G --> H[按账号权限批量导出]

创建地图任务¶

1. 选择地图任务¶

打开创建窗口后，停留在 地图任务 页签。另一个 官网任务 页签用于直接粘贴网址挖掘邮箱、社媒和电话，不属于本文主流程。

2. 设置关键词¶

选择类别或填写你要找的商家关键词。可以同时添加多个关键词。

如果没有设置，界面会提示：

请设置类别或关键词

3. 选择地区¶

至少选择一个国家，并继续选择州 / 省或城市；也可以选择整国，再由系统加载该国的地区列表。

搜索深度支持：

州 / 省级：按州或省范围创建搜索。
城市级：把城市范围也加入任务。

如果没有选择地区，界面会提示：

请选择地区

如果选择结果无法转换成具体地区，界面会提示：

未能创建任务（请检查是否选了具体州/城市）

4. 确认任务规模¶

创建窗口会显示关键词数、国家数和地区数。多国选择仍会合并成 1 个任务，方便统一管理。

单个地图任务最多可写入 50,000 个地区条目。超过时，界面会在“创建失败：”后显示实际数量和上限，并要求按国家或州 / 省拆分。其他创建失败也会尽量显示后台返回的具体原因，请优先按原提示处理。

5. 创建任务¶

点击 创建任务。创建成功后会看到类似提示：

任务已创建（N 个地区）
任务已创建（N 国 / N 个地区，合并为 1 个任务）

看懂任务状态¶

状态	表示什么	你可以怎么做
排队中	正在等待可用运行槽位	等待前面的任务完成，或调整地图采集并发上限
进行中	系统正在采集	查看进度、暂停或结束任务
已暂停	当前任务暂时不再继续	点击继续
已完成	所有计划地区已经处理完成	查看数据或删除任务记录
已结束	任务被手动提前结束	已采集数据仍保留，可查看或删除
被拦截	当前采集受到页面拦截	按界面提示处理后再继续

主面板允许把全局地图采集并发上限设置为 1–10，新安装默认值是 2。这个值不是单纯的“任务数量”：当前实现既用它限制可进入运行态的地图任务批次，也用它限制全局同时打开的 Google Maps 采集页（Tab）数量；多个任务会共享这些采集槽位，其余任务排队。你可以在任务页或设置中调整。

管理任务¶

暂停和继续¶

单个任务可以点击暂停或继续。
页面有可操作任务时，会显示 全部暂停 或 全部继续。

查看详细进度¶

点击任务卡片中的 进度 X/Y · 采集 Z 条，可以查看关键词 × 地区的处理详情。

结束任务¶

选择 结束任务 后，任务不再继续运行，任务记录会标记为 已结束，已经采集的商家数据会保留。

删除任务¶

删除前会出现独立确认窗口。你可以选择：

只删除任务记录，保留已经采集的商家数据；
请求同时删除该任务对应的商家数据。

确认前请看清选择，批量删除时同样会应用所选的数据处理方式。

当前删除边界： 商家数据的级联删除目前是尽力执行。任务记录会先删除；如果后续商家数据删除失败，界面仍可能显示任务删除成功，相关商家数据可能残留。不要把这个选项当作经过结果核验的数据擦除机制；如删除结果关系到合规或数据清理，请在操作后另行核查本地数据。

数据过滤：跳过无邮箱商家¶

设置页 数据过滤 → 必填类 有一个「跳过无邮箱商家」开关。它跟同组其他几个「跳过无网址商家」「跳过无电话商家」不一样——不是勾选后立刻生效，因为创建任务时地图搜索刚命中商家的那一刻，还完全不知道这个商家有没有邮箱（邮箱要等后续挖掘官网才会出现）。

第一步：这条商家的邮箱结果算不算「定论」

flowchart TD
    A[官网挖掘阶段结束] --> B{官网抓取完整跑完了吗}
    B -- 跑完了 --> C[定论：看有没有邮箱]
    B -- 没有官网 --> K[未定论 → 保留]
    B -- 命中域名黑名单 --> K
    B -- 官网是社媒链接 --> K
    B -- 打不开 / 超时 / 稍后重试 --> K

第二步：定论之后才轮到开关

flowchart TD
    C[定论：官网跑完了] --> D{找到邮箱没有}
    D -- 找到了 --> E[保留，写入邮箱]
    D -- 没找到 --> F{开关勾选了吗}
    F -- 没勾 --> G[保留，邮箱字段留空]
    F -- 勾了 --> H[回读数据库核实]
    H --> I[库里真没有 → 整行删除]
    H --> J[库里其实有 → 保留]

几个容易踩的点：

生效时点：不是「创建任务时」，是「这条商家的官网挖掘阶段结束」的那一刻。挖掘期间列表里可能仍然看到这些商家（状态是待挖掘 / 挖掘中），并不代表开关没生效。
只有一种情况算「确认没有」：官网抓取完整跑完了，但没有找到邮箱。注意判的只是邮箱 —— 这条商家可能有电话、有社媒，只要没邮箱且开关勾选，仍会被删。除此之外一律保留：
没有官网 —— 保留。想要过滤这类商家请用同组的「跳过无网址商家」，那才是表达这个意图的开关。
命中域名黑名单 —— 保留。黑名单的意思是「不去挖这个域名」，不是「这家没有邮箱」。
官网填的是社媒链接（Facebook / Instagram / WhatsApp 等）—— 保留，而且这些链接会被自动存进对应的社媒字段（WhatsApp 还会提取出号码）。社媒本身就是有效的触达渠道。
网站打不开、超时、被反爬拦、稍后重试 —— 保留。这轮没拿到结果不等于没有。
处置方式是整行删除，不是隐藏：判定为「确认没有邮箱」且开关勾选时，这条商家会从本地数据里彻底删除，不是标记、不是隐藏，也无法在界面里恢复。
删除前有一道核实：即使判定说「确认没有」，系统仍会回读一次数据库——如果那一行里实际存着邮箱，就不删，也不会用空值覆盖它。核实失败（读不到）时同样保守保留。
如果不希望被误删任何商家，建议先关闭这个开关跑一遍任务，人工核对邮箱缺失情况后再决定是否开启。

查看采集结果¶

点击任务的 查看数据，或进入左侧数据，可以看到：

商家列表：每行一个商家，可包含店铺名称、分类、评分、评论数、详细地址、官网、电话、国家、省 / 州、城市、邮编、坐标和地图链接等字段。
官网列表（去重）：在当前加载窗口内，按官网 URL 的小写形式去重；不会自动合并协议、www 或尾斜杠不同的 URL。
邮箱列表（去重）：在当前加载窗口内，去掉首尾空白并转为小写后比较，同时过滤明显损坏的邮箱值。
手机列表（去重）：在当前加载窗口内，去掉非数字字符后比较。

如果启用了官网挖掘，官网记录还会显示：

状态：待采集、采集中、已完成或失败；
可能发现的邮箱、电话；
Facebook、Instagram、LinkedIn、Twitter、YouTube、WhatsApp 等社媒入口。

数量为什么对不上？ 官网、邮箱和电话列表都从当前加载的商家窗口派生并去重。同一个官网可能对应多家商家，同一个邮箱或电话也可能重复出现，因此这些列表的数量不一定等于商家数量。单任务筛选最多加载最近 50,000 行；全局视图分别最多加载 50,000 条“已完成”和 50,000 条“待采集”记录，超出窗口或处于其他官网采集状态的记录可能不会计入当前派生列表。

翻页与每页条数¶

商家列表底部可以翻页，也可以切换 每页条数。

切换每页条数会自动跳回第 1 页。 这是有意为之：停在原页码会让你落到一个越界的空白页（例如在第 20 页把每页条数从 20 改成 100，原第 20 页已不存在）。
只翻页、不改每页条数时，页码正常保留。
云端数据与本地数据两个表格现在行为一致。

导出结果¶

在商家数据页选择数据后，可以点击导出。

当前代码中的批量导出规则是：

有效地图会员可以确认批量导出；
未登录时，界面会要求先登录；
已登录但没有有效地图会员时，界面会提示升级。

套餐和权限可能继续调整，请以操作时界面显示为准。

当前数据量限制¶

当前额度检查由已打开的主面板执行。当主面板检测到本地总量达到以下条件时，会触发全局暂停，暂停所有正在运行的地图任务，并提示账号操作：

账号状态	本地数据达到	当前处理
未登录	1,000 条	暂停所有正在运行的地图任务并提示登录
已登录但没有有效地图会员	2,000 条	暂停所有正在运行的地图任务并提示升级

主面板没有打开时，当前代码没有提供同等的独立后台额度守门，因此不要把这两个数字理解成任何运行状态下都必然生效的后台硬上限。它们只用于说明当前实现，不代表永久套餐承诺；后续版本若调整账号策略，应同时更新本节。

常见提示与处理¶

提示	通常原因	现在怎么做
请设置类别或关键词	没有填写搜索目标	添加至少一个类别或关键词
请选择地区	没有选择国家或地区	重新选择国家，并确认州 / 省或城市范围
未能创建任务（请检查是否选了具体州/城市）	地区选择没有生成可用范围	重新勾选具体州 / 省或城市
`加载 {国家} 地区列表失败：{错误}。请重试或检查网络`	网络或地区接口请求失败	按提示检查网络后重试
`无法解析 {国家} 地区数据（API 响应格式异常，请尝试更新版本或反馈给开发者）`	地区接口返回格式异常	更新扩展后重试；仍失败时反馈给开发者
`复制失败：{原因}`	商家详情里点复制时，浏览器拒绝了剪贴板权限，或页面不在安全上下文（非 HTTPS）	按提示里的具体原因处理：在浏览器站点设置里允许剪贴板，或手动选中文本复制
`创建失败：单任务地区数超上限（实际值 > 50,000）…`	单个任务写入的地区条目超过 50,000	按国家或州 / 省拆成多个任务
`创建失败：{后台返回消息}`	后台返回了其他创建错误	按完整消息处理；不要只按“任务过大”排查
被拦截	Google Maps 页面限制了当前采集	按界面提示处理，不要连续重复创建同类大任务

不保证什么¶

不保证每个商家都有官网、邮箱、电话或社媒账号。
不保证所有公开字段都能被稳定读取；网络、网站反爬和页面结构变化都可能造成失败或缺字段。
不保证 Google Maps 页面升级后旧版本扩展仍可继续采集。
不把规划中的云端共享或服务端能力视为当前已完整可用功能。

自己验证一遍¶

完成下面这组操作，可以确认主流程是否正常：

打开主面板，进入任务。
创建一个关键词少、地区范围小的地图任务。
确认任务出现 排队中 或 进行中 状态。
点击进度文字，确认能看到关键词 × 地区详情。
等任务产生数据后，点击 查看数据。
分别打开商家、官网、邮箱和手机列表，确认去重口径符合预期。
暂停并继续任务，确认状态会变化。
测试结束任务或删除任务前，仔细确认是否保留商家数据。