tumgis/3dcitydb-web-map Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

3D City Database Web Map Client Docker镜像

该仓库包含基于官方Node.js Docker镜像构建的3D City Database Web-Map-Client（3D Web客户端）的Dockerfile。获取3D Web客户端Docker镜像请访问tumgis/3dcitydb-web-map DockerHub页面。如需快速上手，可查看"快速开始"部分。

特殊功能

• 登录页面和数据列表，便于3D Web客户端项目创建

镜像版本/标签

所有镜像标签列表可在DockerHub的tumgis/3dcitydb-web-map/tags查看。镜像标签由多个标识组成，说明如下：

• latest - 基于3D Web客户端最新稳定版本的稳定版，从master分支构建。
• devel - 包含最新功能的开发版，从devel分支构建。
• alpine - 基于Alpine Linux的轻量级版本。其他镜像均使用Debian操作系统。特定版本的Alpine镜像命名如alpine-v1.9.0。
• experimental - 基于3DCityDB Web-Map-Client Github master分支最新提交构建的版本。
• v1.1.0、v1.4.0、v1.6.0、v1.6.1、v1.6.2、v1.7.1、v1.8.0、v1.8.1、v1.8.2、v1.8.3、v1.9.0、v1.9.1、v2.0.0 - 使用特定版本（vX.X.X）的3DCityDB Web-Map-Client构建。

使用docker pull tumgis/3dcitydb-web-map:TAG下载指定TAG的最新镜像到系统。例如：docker pull tumgis/3dcitydb-web-map:v1.7.1。

更多3DCityDB Docker镜像

也可查看3D City Database和*3D City Database Web Feature Service (WFS)*的Docker镜像：

• 3DCityDB Docker镜像
• 3DCityDB Web Feature Service (WFS)镜像

注意： 本仓库所有内容均处于开发阶段。如遇到任何问题或有建议/改进，请通过此处创建issue反馈。

什么是3DCityDB-Web-Map-Client

3DCityDB-Web-Map-Client是3DCityDB的基于Web的前端，用于高性能3D可视化和交互式探索任意大型CityGML语义3D城市模型。它使用Cesium Virtual Globe作为3D地理可视化引擎，基于HTML5和WebGL提供硬件加速和跨平台功能，无需额外插件即可在Web浏览器中显示3D图形内容。

3DCityDB-Web-Map-Client的主要功能和特性如下：

• 支持高效显示、缓存、预取、动态加载和卸载大型预样式化3D可视化模型（以从3DCityDB通过导入/导出工具导出的 tiled KML/glTF数据集形式）
• 直观的用户界面，用于添加和移除任意数量的数据层，如3D可视化模型（KML/glTF）、WMS影像层和Cesium数字地形模型
• 支持将3D可视化模型（KML/glTF）与基于云的Google Fusion Table链接，允许查询每个3D对象的专题数据
• 支持与3D可视化模型（KML/glTF）的丰富交互，例如鼠标悬停和点击时高亮3D对象，以及隐藏和显示选定的3D对象
• 支持使用第三方地图服务（如带倾斜视图的Microsoft Bing Maps、Google Streetview以及组合版本DualMaps）从不同视角探索感兴趣的3D对象
• 支持动态激活和停用3D对象（仅glTF支持，KML暂不支持）和Cesium数字地形模型的阴影可视化
• 支持通过生成包含当前相机视角、阴影可视化激活状态、当前加载数据层参数等信息的场景链接，协作创建和共享3DCityDB-Web-Map-Client的工作空间

!3DCityDB

3DCityDB官方主页 3DCityDB Github CityGML 3DCityDB和CityGML实践教程

快速开始

本节介绍如何快速轻松地运行3DCityDB-Web-Map-Client容器。

1. 在系统上安装Docker。
   这是必需步骤。各操作系统的下载和详细说明可在[***]

2. 使用docker run运行3D Web客户端Docker镜像。使用-p <主机端口:容器端口>开关指定3D Web客户端在主机系统上的监听端口。例如，若要在默认http端口=80访问3D Web客户端，使用-p 80:8000。

   bash
   docker run -dit --name 3dwebmap-container -p 80:8000 tumgis/3dcitydb-web-map
   

3. 容器启动后，可通过任何常见Web浏览器访问Docker主机上的3D Web客户端。若使用上述端口设置在本地运行容器，登录页面可通过以下地址访问：
   http://localhost/ 或 [***]

托管数据和3D Web客户端

3DCityDB-Web-Map-Client Docker镜像允许托管要在客户端中使用的数据。所有对运行中3D Web客户端容器的/var/www/data/目录可见的数据将在数据列表中列出，并可用于客户端创建Web可视化。使数据对该目录可用的最佳方式是使用所谓的绑定挂载，即将主机目录映射到容器目录。有关绑定挂载和其他可能选项的更多信息，可查看Docker的数据存储和持久性概述。

以下示例说明如何托管3DCityDB-Web-Map-Client和示例数据集。
假设已使用3DCityDB导入/导出工具创建了一些用于测试的glTF数据。若未创建，可使用此处提供的测试数据集。本示例假设测试数据集存储在Docker主机的/home/docker/data/目录：

text
$ ls -lh /home/docker/data/

-rw-r--r-- 1 root root 9.1K Mar 15 18:36 Railway_Scene_LoD3.json
-rw-r--r-- 1 root root 1.9K Mar 15 18:36 Railway_Scene_LoD3.kml
-rw-r--r-- 1 root root  316 Mar 15 18:36 Railway_Scene_LoD3_collada_MasterJSON.json
drwxr-xr-x 3 root root 4.0K Mar 15 18:36 Tiles

要启动3DCityDB-Web-Map-Client Docker容器并将/home/docker/data/主机目录绑定挂载到/var/www/data/容器目录，运行：

bash
docker run -dit --name 3dwebmap-container -p 80:8000 \
    -v /home/docker/data/:/var/www/data/ \
  tumgis/3dcitydb-web-map

注意：
上述示例中，长命令使用Bash（\）或CMD（^）的行继续符拆分为多行以提高可读性。

数据现在可在数据列表中使用（例如http://myDockerHost/data/）。使用浏览器的“复制链接地址”功能复制3D Web客户端所需的URL。

!数据列表视图

如何构建

要从本仓库的Dockerfile构建3DCityDB-Web-Map-Client Docker镜像，需从本仓库下载源代码并运行docker build命令。按照以下步骤构建3DCityDB-Web-Map-Client Docker镜像，或使用build.sh脚本。

bash
# 1. 使用git下载源代码
git clone https://github.com/tum-gis/3dcitydb-web-map-docker
# 2. 进入刚克隆的源代码文件夹
cd 3dcitydb-web-map-docker
# 3. 构建标记为例如3dcitydb-web-map的Docker镜像
docker build -t tumgis/3dcitydb-web-map .

构建成功后，即可按照上述说明运行镜像。要列出所有本地可用镜像，运行docker images。

构建参数

要使用自定义Tomcat基础镜像、特定3DCityDB WFS版本或自定义Web应用上下文路径构建Docker镜像，需使用docker build --build-arg参数。

注意：
构建过程目前已使用node:10基础镜像和3DCityDB-Web-Map-Client的v1.7.1版本测试通过。

构建示例：

bash
docker build \
    --build-arg "baseimage_tag=9-slim" \
    --build-arg "webmapclient_version=master" \
  -t tumgis/3dcitydb-web-map:9-slim-master .

bash
# 进入alpine目录
cd alpine

# 使用目录中的dockerfile构建
docker build \
    --build-arg "baseimage_tag=21-alpine" \
    --build-arg "webmapclient_version=v2.0.0" \
  -t tumgis/3dcitydb-web-map:alpine-v2.0.0 .

推送到DockerHub：

bash
docker push tumgis/3dcitydb-web-map:alpine-v2.0.0