# Google Maps Scraper Pro - 使用说明

## 1. 程序简介

## Google Maps Scraper 和 Corp Email Scraper 是两个独立的工具软件，可独立使用，可组合使用（推荐）

Google Maps Scraper Pro 是一款专业的 Google Maps 商家信息采集工具，支持从 Google Maps 网站批量获取商家信息。 基于 Google 对商家信息的隐私设定，目前最有用和最稳定的商家数据是商家/公司的网站网址。

### 主要功能

- 批量采集 Google Maps 上的商家信息
- 支持全球所有国家/地区的所有城市，程序预设了欧美 93 个国家和地区的所有主要城市。
- 用户可以通过编辑 files 目录里的 country_cities.txt 文件添加或减少国家和城市数据。
- 预设多个行业关键词分类及关键词。
- 用户可以通过编辑 files 目录里的 search_keywords.txt 文件添加或减少关键词分类和关键词数据。
- 灵活的数据筛选条件，是否有网站（程序默认选择有网站），最小评分，最小评论。
- 多种导出格式 (CSV/JSON)
- 开箱即用的现代化图形界面

### 系统要求

- Windows 10+ 操作系统
- 4GB+ RAM（内存）
- 100MB+ 可用硬盘空间
- 已安装 Google Chrome 浏览器
- 网络连接正常（需要 开启 VPN 科学上网），因为访问Google Maps 需要。

## 2. 界面布局

### 界面组件说明

组件 | 说明
--- | ---
菜单栏 | 包含数据管理和许可证相关操作
主题切换 | 可切换亮色/暗色界面主题
模式选择 | 选择"输入模式"或"选择模式（国家模式）"
配置选项 | 设置搜索参数和筛选条件
默认设置 | 默认“搜索策略，有网站，并行数，最小评分，最小评论”一般使用不需要改动。
用户设置01 | ”显示浏览器”默认选中的结果是在程序搜索Google Maps 时用户可以实时看到搜索场景，取消选中，程序会在后台搜索，即不打开浏览器。
用户设置02 | “最大结果”默认设置为1000每条查询，比如 lighting in London, United Kingdom 是一个查询，这个结果数一般满足需要。测试时可以把数值设定为10，这样可以更快的看到结果。
用户设置03 | “最大滚动”默认设置为50，也就是搜索时的“翻页”，一般够用，也可以根据自己具体使用设定，测试可设定为2，这样可以更快看到结果。
控制按钮 | 开始搜索，停止搜索，清空日志，清空输入（对应输入模式），重置选择（对应选择模式），打开数据目录
进度条 | 显示当前搜索进度
日志区域 | 显示程序运行状态和日志信息

## 3. 快速开始

### 3.1 首次使用

1. 下载程序
   - `Google_Maps_Scraper_Pro_V1.6.8` 下载地址
   - https://software.anoralighting.com/software_zip/Google_Maps_Scraper_Pro_V1.6.8.zip，复制链接用浏览器打开即开始下载，或点击上面链接下载。
2. 启动程序
   - 双击 `Google_Maps_Scraper_Pro_V1.6.8.exe` 启动程序
   - 程序启动时会自动检测许可证状态
3. 试用期激活
   - 首次使用会自动激活 7 天免费试用
   - 试用期内可免费使用所有功能,无功能限制。
4. 开始第一次搜索
   方式一：使用输入模式（可复制粘贴搜索查询）
   1. 点击"输入模式"选项卡
   2. 在文本框中输入搜索查询，每行一个，比如 lighting in London, United Kingdom （不分大小些）
   3. 设置搜索参数
   4. 点击"开始搜索"
   5. 搜索过程中建议用户不要主动中断搜索（停止搜索），让程序自动完成搜索工作。
   方式二：使用选择模式
   1. 点击"选择模式"选项卡
   2. 选择关键词分类 → 关键词 → 位置介词 → 国家 → 城市
   3. 设置搜索参数
   4. 点击"开始搜索"
   5. 搜索过程中建议用户不要主动中断搜索（停止搜索），让程序自动完成搜索工作。

## 4. 两种搜索模式

### 4.1 输入模式

适用于：自定义批量查询、手动指定搜索条件

使用方法：

1. 切换到"输入模式"选项卡
2. 在文本框中输入搜索查询，格式如下：

    # 格式示例
    关键词 in 城市, 国家
    关键词 near 城市, 国家

    # 示例
    restaurant in London, United Kingdom
    hotel near Paris, France
    cafe around Berlin, Germany

3. 每行输入一个查询
4. 点击"开始搜索"

注意事项：
- 每行一个查询
- 查询格式：`关键词 + 位置介词 + 城市/国家`
- 支持的介词：`in`, `near`, `around`, `at`, `by`, `off`

### 4.2 选择模式

适用于：按国家/城市分类搜索、内置关键词库（用户可以通过编辑 files 目录里的 search_keywords.txt 文件添加或减少关键词分类和关键词数据。）

使用方法：

1. 选择关键词分类
   - 点击"关键词分类"下拉框
   - 选择行业分类（如：照明，五金，餐饮等）
2. 选择关键词
   - 点击"关键词"下拉框
   - 从分类中选择具体关键词
   - 或选择"所有关键词"批量搜索（需要根据实际网络速度和电脑性能，一般不建议用。）
3. 选择位置介词
   - 默认使用 `in`
   - 可选：`near`, 不常用：`around`, `at`, `by`, `off`
4. 选择国家
   - 点击"国家"下拉框
   - 支持全球所有国家/地区
   - 预制：欧洲、北美、南美、大洋洲主要国家
5. 选择城市
   - 点击"城市"下拉框
   - 选择"所有城市"可搜索该国所有预设城市
   - 或选择特定城市
6. 开始搜索
   - 点击"开始搜索"按钮
   - 程序将自动生成查询列表并开始搜索

## 5. 配置选项详解

### 5.1 搜索策略

策略 | 说明
--- | ---
Standard | 标准模式，仅获取商家基本信息（根据现在Google Maps提供的数据，够用，搜索也更快。）
Detailed | 详细模式，额外获取评论、图片等信息（不建议用）

### 5.2 基本配置

选项 | 说明 | 默认值
--- | --- | ---
有网站 | 仅采集有网站的商家 | 开启
显示浏览器 | 显示浏览器窗口（关闭则隐藏） | 开启
并行数 | 同时执行的搜索任务数 (1-5) | 3
最大结果 | 单个查询最大采集数量 (10-5000) | 1000
最大滚动 | 页面最大滚动次数 (5-200) | 50

### 5.3 筛选条件

选项 | 说明 | 取值范围
--- | --- | ---
最小评分 | 仅采集评分 >= 此值的商家 | 0.0 - 5.0
最小评论 | 仅采集评论数 >= 此值的商家 | 0 - 10000

### 5.4 配置建议

场景 | 推荐配置
--- | ---
快速测试 | 并行数=1, 最大结果=100, 最大滚动=20
常规采集 | 并行数=3, 最大结果=1000, 最大滚动=50
大规模采集 | 并行数=5, 最大结果=2000, 最大滚动=100
高质量数据 | 最小评分=4.0, 最小评论=50

## 6. 许可证管理

### 6.1 菜单说明

在菜单栏点击"许可证"可看到以下选项：

菜单项 | 说明
--- | ---
许可证状态 | 查看当前许可证信息
许可证激活 | 输入激活码激活许可证
许可证迁移 | 将许可证转移到新电脑
解除许可证 | 解除当前设备的许可证绑定

### 6.2 查看许可证状态

1. 点击菜单：许可证 → 许可证状态
2. 可查看：
   - 机器码（16位，用于激活）
   - 许可证状态（未激活/试用期/正式版）
   - 许可证类型
   - 过期时间

### 6.3 激活许可证

1. 点击菜单：许可证 → 许可证激活
2. 输入您的激活码
3. 点击"激活"按钮
4. 激活成功后会显示提示信息

许可证类型说明：

类型 | 说明
--- | ---
试用版 | 免费试用 7 天，无功能限制
正式版 | 按天授权，首次 30 天起售，后续可按天续费。

获取激活码请联系：阿诺拉【Anora】 - 微信: 180 2416 9261

### 6.4 许可证迁移

当需要更换电脑时：

1. 在旧电脑上：许可证 → 许可证迁移
2. 获取当前机器码
3. 在新电脑上使用相同的激活码进行激活
4. 如需协助，请联系客服

### 6.5 解除许可证

在以下情况需要解除许可证：

- 输入新激活码前
- 许可证转移前
- 设备报废后

## 7. 数据导出

### 7.1 导出格式

程序支持以下导出格式：

- CSV - 逗号分隔值，可用 Excel 打开
- JSON - 键值对格式，便于程序处理

### 7.2 导出位置

数据默认导出到 `output` 目录：

    项目目录/
    └── output/
        └── gmaps_search_data_2026-01-15_103015.csv
        └── gmaps_search_data_2026-01-15_103015.json

### 7.3 数据字段

导出的关键数据有以下字段：

字段 | 说明
--- | ---
name | 商家名称
rating | 评分 (1-5)
reviews_count | 评论数量
address | 地址
website | 网站

### 7.4 打开数据目录

点击"打开数据目录"按钮可直接打开 output 文件夹

## 8. 常见问题

### 8.1 启动问题

Q: 程序无法启动？

解决方案：
1. 确认已安装 Google Chrome 浏览器
2. 确认网络连接正常（需要 开启 VPN 科学上网），因为访问Google Maps 需要。

Q: 提示"许可证验证失败"？

解决方案：
1. 点击"许可证"菜单
2. 选择"许可证激活"
3. 输入有效的激活码

### 8.2 搜索问题

Q: 搜索没有结果？

可能原因：
1. 网络连接问题 → 检查网络
2. Google Maps 无法访问 → 开启 VPN 科学上网
3. 尝试更换关键词

Q: 结果数量少于预期？

优化建议：
1. 增加"最大结果"数值
2. 增加"最大滚动"次数
3. 降低"最小评分"和"最小评论"门槛

Q: 程序运行缓慢？

优化建议：
1. 降低"并行数"（建议 1-2）
2. 关闭"显示浏览器"选项
3. 减少"最大滚动"次数
4. 关闭不必要的后台程序

### 8.3 导出问题

Q: 导出文件为空？

解决方案：
1. 确认搜索成功完成
2. 检查日志区域是否有错误信息
3. 确认 output 目录有写入权限

Q: Excel 打开乱码？

解决方案：
1. 在 Excel 中通过"数据 → 自文本，分隔符号，逗号（只选择），常规 "

### 8.4 其他问题

Q: 如何联系我们？

微信：180 2416 9261
联系人：阿诺拉 (Anora)

Q: 程序闪退？

解决方案：
1. 更新 Chrome 浏览器到最新版本
2. 更新程序到最新版本
3. 清理缓存文件后重试

## 附录

### A. 快捷操作

按钮 | 功能
--- | ---
开始搜索 | 启动批量搜索任务
停止搜索 | 立即停止正在运行的搜索
清空日志 | 清空日志显示区域
清空输入 | 清空搜索输入内容
重置选择 | 恢复选择模式的下拉选项
打开数据目录 | 打开 output 文件夹

### B. 数据管理菜单

菜单项 | 功能
--- | ---
搜索状态 | 查看当前搜索进度和状态
重置状态 | 清空所有搜索状态
重新加载 Files | 重新读取关键词和国家城市数据
退出程序 | 关闭程序

### C. 日志查看

日志区域显示程序运行信息：

- INFO - 正常操作信息
- DEBUG - 调试信息，非错误
- WARNING - 警告信息
- ERROR - 错误信息