sourcepole/qwc-legend-service

QWC图例图形服务

镜像概述

QWC图例图形服务（qwc-legend-service）是QGIS Web Client（QWC）生态系统的组件之一，专门用于生成和提供地图图例图形。该服务为QWC Web客户端应用提供动态图例生成能力，支持基于QGIS项目配置的图例渲染。

核心功能与特性

• 为QGIS Web Client生成地图图例图形
• 支持基于QGIS项目文件（.qgs）的图例配置
• 通过HTTP接口提供图例图形访问
• 集成QWC生态系统的认证与权限控制（如适用）
• 支持多种图例输出格式（如PNG、SVG等，具体取决于配置）

使用场景与适用范围

• 集成到QWC Web客户端应用中，为地图可视化提供图例展示
• 作为独立服务为基于QGIS的Web地图应用提供图例生成能力
• 适用于需要动态生成地图图例的GIS（地理信息系统）Web项目

使用方法与配置说明

前提条件

• 已安装Docker环境
• 已获取QWC服务配置（通常来自QWC部署包或GitHub仓库）
• 准备好QGIS项目文件（.qgs）及相关图例配置

部署示例

Docker Run命令

bash
docker run -d -p 8080:8080 \
  -v /path/to/your/config:/app/config \
  --name qwc-legend-service \
  sourcepole/qwc-legend-service

Docker Compose配置（示例）

yaml
version: '3'
services:
  qwc-legend-service:
    image: sourcepole/qwc-legend-service
    ports:
      - "8080:8080"
    volumes:
      - ./config:/app/config
    restart: unless-stopped

配置说明

服务配置主要通过挂载的配置目录（通常包含QGIS项目文件、服务配置JSON等）进行。详细配置方法、支持的参数及环境变量，请参考官方GitHub仓库：
https://github.com/qwc-services/qwc-legend-service

注意事项

• 服务依赖正确配置的QGIS项目文件，需确保图例相关图层样式在QGIS项目中已定义
• 生产环境中建议配合QWC的其他服务组件（如qwc-auth-service、qwc-map-viewer）一起部署
• 服务端口可根据实际需求调整，确保与QWC客户端的图例请求地址匹配