sourcepole/qwc-feature-info-service

QWC FeatureInfo Service 镜像文档

概述

QWC FeatureInfo Service是QGIS Web Client（QWC）生态系统的核心服务组件，专注于提供地理空间数据要素信息查询功能。该服务接收来自前端地图应用的要素查询请求，从配置的数据源中提取要素属性，并以结构化格式返回结果，是WebGIS应用中实现地图要素交互查询的关键服务。

核心功能与特性

• 要素查询处理：接收并解析地图点击坐标对应的要素查询请求，支持点查询、框选查询等多种模式
• 多数据源支持：兼容PostGIS、Shapefile、WFS等多种地理数据来源，通过配置文件定义数据连接
• 查询模板定制：允许通过HTML/JSON模板自定义查询结果的展示格式，支持条件过滤和属性映射
• 服务集成能力：与QWC生态系统其他服务（如QWC Map Service、QWC OGC Service）无缝集成，共享数据源配置
• 权限控制：支持基于QWC Security Service的访问权限控制，确保要素数据的安全访问

使用场景与适用范围

• WebGIS应用前端交互：为地图应用提供"点击查看详情"功能，如不动产查询、设施管理系统
• 地理数据门户：作为公共地理数据平台的查询接口，向用户提供空间要素属性浏览
• 企业GIS系统集成：嵌入定制化GIS解决方案，实现业务数据与空间数据的关联查询
• 移动GIS应用后端：为移动端地图应用提供要素信息查询API支持

使用方法与配置说明

前提条件

• Docker Engine 19.03+
• 已部署QWC核心服务（如QWC Config Service、QWC Database）或独立配置数据源
• 网络环境需允许服务与数据源（如数据库、WFS服务）之间的通信

Docker Run 部署示例

bash
docker run -d \
  --name qwc-feature-info-service \
  -p 5012:5000 \
  -v /path/to/local/config:/srv/qwc_service/config \
  -e QWC_CONFIG_SERVICE_URL=http://qwc-config-service:5010 \
  -e DB_HOST=postgis-db \
  -e DB_PORT=5432 \
  -e DB_NAME=qwc_db \
  -e DB_USER=qwc_user \
  -e DB_PASSWORD=secure_password \
  qwc-feature-info-service:latest

Docker Compose 配置示例

yaml
version: '3'
services:
  qwc-feature-info-service:
    image: qwc-feature-info-service:latest
    container_name: qwc-feature-info-service
    ports:
      - "5012:5000"
    volumes:
      - ./config:/srv/qwc_service/config
    environment:
      - QWC_CONFIG_SERVICE_URL=http://qwc-config-service:5010
      - DB_HOST=postgis-db
      - DB_PORT=5432
      - DB_NAME=qwc_db
      - DB_USER=qwc_user
      - DB_PASSWORD=secure_password
      - LOG_LEVEL=INFO
    depends_on:
      - qwc-config-service
      - postgis-db

配置参数说明

环境变量

数据源配置

通过挂载配置目录中的datasources.yaml文件定义数据源连接，示例：

yaml
datasources:
  - name: postgis_db
    type: postgis
    connection: "dbname='qwc_db' host='postgis-db' port='5432' user='qwc_user' password='secure_password'"
  - name: wfs_service
    type: wfs
    url: "http://ogc-service/wfs"
    version: "2.0.0"

查询模板配置

在配置目录的templates子目录中放置HTML/JSON模板文件，自定义查询结果格式，示例模板（feature_info.html）：

html
<div class="feature-info">
  <h3>{{ layer_name }}</h3>
  <table>
    {% for key, value in attributes.items() %}
      <tr>
        <th>{{ key }}</th>
        <td>{{ value }}</td>
      </tr>
    {% endfor %}
  </table>
</div>

服务接口

• 查询接口：GET /feature_info?map_id={map_id}&x={x}&y={y}&crs={crs}
  • 参数说明：map_id（地图配置ID）、x/y（查询坐标）、crs（坐标参考系）
  • 返回：HTML/JSON格式的要素属性数据

注意事项

• 确保数据源连接参数正确，网络可达
• 生产环境中建议通过QWC Config Service管理配置，避免直接暴露敏感信息
• 高并发场景下可配置服务水平扩展，配合负载均衡器使用