gmplot 项目教程

1. 项目的目录结构及介绍

gmplot 项目的目录结构相对简单，主要包含以下几个部分：

gmplot/
├── gmplot/
│   ├── __init__.py
│   ├── gmplot.py
│   └── ...
├── examples/
│   ├── basic_plot.py
│   ├── ...
├── tests/
│   ├── test_gmplot.py
│   └── ...
├── .gitignore
├── LICENSE
├── README.md
└── setup.py

目录结构介绍

• gmplot/: 核心代码目录，包含项目的所有源代码。
  • __init__.py: 初始化文件，使目录成为一个 Python 包。
  • gmplot.py: 主要功能实现文件，包含地图绘制的核心逻辑。
• examples/: 示例代码目录，包含如何使用 gmplot 的示例脚本。
  • basic_plot.py: 基本的绘图示例。
• tests/: 测试代码目录，包含项目的单元测试。
  • test_gmplot.py: 针对 gmplot 功能的单元测试。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• setup.py: 项目安装脚本。

2. 项目的启动文件介绍

gmplot 项目的启动文件主要是 gmplot/gmplot.py，这个文件包含了所有地图绘制的主要功能和类。

启动文件介绍

• gmplot.py:
  • 定义了 GoogleMapPlotter 类，用于创建和管理 Google 地图。
  • 提供了多种绘图方法，如 scatter、plot、heatmap 等，用于在地图上绘制数据点、路径和热力图。

3. 项目的配置文件介绍

gmplot 项目没有专门的配置文件，所有的配置和参数都是通过代码中的方法和类实例化时传递的。

配置文件介绍

• 配置主要通过代码实现，例如：
  • 在创建 GoogleMapPlotter 实例时，可以指定地图的中心位置、缩放级别等参数。
  • 在调用绘图方法时，可以传递数据点和样式参数。

from gmplot import GoogleMapPlotter

# 创建地图绘制器
gmap = GoogleMapPlotter(37.766956, -122.438481, 13)

# 绘制散点图
gmap.scatter([37.766956], [-122.438481], 'red', size=50, marker=False)

# 生成地图 HTML 文件
gmap.draw("map.html")

以上代码展示了如何创建一个地图绘制器，并在地图上绘制散点图，最后生成一个 HTML 文件来显示地图。