QGIS 天地图插件使用教程

QGIS 天地图插件使用教程

qgis-plugin-tianditu Tianditu plugin for QGIS 项目地址: https://gitcode.com/gh_mirrors/qg/qgis-plugin-tianditu

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

qgis-plugin-tianditu/
├── docs/
│   └── tianditu_tools/
├── .gitignore
├── .pylintrc
├── LICENSE
├── README.md
├── pack.py
├── package.json
├── pnpm-lock.yaml
└── tianditu_tools/
    ├── __init__.py
    ├── main.py
    ├── config.py
    └── ...

目录结构介绍

• docs/: 存放项目文档，包括使用说明和API文档。
• tianditu_tools/: 插件的核心代码目录，包含插件的主要功能实现。
• .gitignore: Git忽略文件，指定哪些文件或目录不需要被Git管理。
• .pylintrc: Pylint配置文件，用于代码质量检查。
• LICENSE: 项目的开源许可证文件，本项目使用GPL-3.0许可证。
• README.md: 项目的说明文件，包含项目的基本信息和使用说明。
• pack.py: 打包脚本，用于将插件打包成可分发的格式。
• package.json: 项目的元数据文件，包含项目的依赖信息和版本信息。
• pnpm-lock.yaml: 依赖锁定文件，确保项目依赖的一致性。

2. 项目的启动文件介绍

tianditu_tools/main.py

main.py 是QGIS天地图插件的启动文件，负责初始化插件并加载插件的主要功能。以下是该文件的主要功能介绍：

from qgis.core import QgsApplication
from .tianditu_plugin import TiandituPlugin

def classFactory(iface):
    return TiandituPlugin(iface)

• classFactory: 这是QGIS插件的入口函数，QGIS会调用这个函数来加载插件。iface 是QGIS接口对象，插件通过这个对象与QGIS进行交互。
• TiandituPlugin: 这是插件的主类，继承自QGIS的插件基类。在这个类中，定义了插件的所有功能和界面。

3. 项目的配置文件介绍

tianditu_tools/config.py

config.py 是QGIS天地图插件的配置文件，负责管理插件的配置信息，如天地图API的Key、底图类型等。以下是该文件的主要功能介绍：

class ConfigManager:
    def __init__(self):
        self.config = {}

    def load_config(self):
        # 从文件或数据库加载配置
        pass

    def save_config(self):
        # 保存配置到文件或数据库
        pass

    def set_tianditu_key(self, key):
        self.config['tianditu_key'] = key

    def get_tianditu_key(self):
        return self.config.get('tianditu_key', None)

• ConfigManager: 配置管理类，负责加载和保存插件的配置信息。
• load_config: 从文件或数据库加载配置信息。
• save_config: 将配置信息保存到文件或数据库。
• set_tianditu_key: 设置天地图API的Key。
• get_tianditu_key: 获取天地图API的Key。

通过以上配置文件，用户可以方便地管理插件的配置信息，确保插件的正常运行。

qgis-plugin-tianditu Tianditu plugin for QGIS 项目地址: https://gitcode.com/gh_mirrors/qg/qgis-plugin-tianditu