tumgis/3dcitydb-web-map

3D City Database Web Map Client Docker镜像

该仓库包含基于官方https://hub.docker.com/_/node/%E6%9E%84%E5%BB%BA%E7%9A%84https://github.com/3dcitydb/3dcitydb-web-map/%E7%9A%84Dockerfile%E3%80%82%E8%8E%B7%E5%8F%963D Web客户端Docker镜像请访问https://hub.docker.com/r/tumgis/3dcitydb-web-map/ DockerHub页面。如需快速上手，可查看"快速开始"部分。

特殊功能

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

镜像版本/标签

所有镜像标签列表可在DockerHub的https://hub.docker.com/r/tumgis/3dcitydb-web-map/tags/%E6%9F%A5%E7%9C%8B%E3%80%82%E9%95%9C%E5%83%8F%E6%A0%87%E7%AD%BE%E7%94%B1%E5%A4%9A%E4%B8%AA%E6%A0%87%E8%AF%86%E7%BB%84%E6%88%90%EF%BC%8C%E8%AF%B4%E6%98%8E%E5%A6%82%E4%B8%8B%EF%BC%9A

• latest - 基于3D Web客户端最新稳定版本的稳定版，从https://github.com/tum-gis/3dcitydb-web-map-docker/tree/master%E5%88%86%E6%94%AF%E6%9E%84%E5%BB%BA%E3%80%82
• devel - 包含最新功能的开发版，从https://github.com/3dcitydb/3dcitydb-web-map/tree/devel%E5%88%86%E6%94%AF%E6%9E%84%E5%BB%BA%E3%80%82
• alpine - 基于Alpine Linux的轻量级版本。其他镜像均使用Debian操作系统。特定版本的Alpine镜像命名如alpine-v1.9.0。
• experimental - 基于https://github.com/3dcitydb/3dcitydb-web-map/tree/master%E6%9C%80%E6%96%B0%E6%8F%90%E4%BA%A4%E6%9E%84%E5%BB%BA%E7%9A%84%E7%89%88%E6%9C%AC%E3%80%82
• 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镜像：

• https://github.com/tum-gis/3dcitydb-postgis-docker/
• https://github.com/tum-gis/3dcitydb-wfs-docker/

注意： 本仓库所有内容均处于开发阶段。如遇到任何问题或有建议/改进，请通过https://github.com/tum-gis/3dcitydb-web-map-docker/issues%E5%88%9B%E5%BB%BAissue%E5%8F%8D%E9%A6%88%E3%80%82

什么是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官方主页 https://github.com/3dcitydb 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的https://github.com/tum-gis/3dcitydb-docker-postgis#data-storage-and-persistence%E6%A6%82%E8%BF%B0%E3%80%82

以下示例说明如何托管3DCityDB-Web-Map-Client和示例数据集。
假设已使用3DCityDB导入/导出工具创建了一些用于测试的glTF数据。若未创建，可使用https://github.com/3dcitydb/3dcitydb-web-map/tree/master/examples/glTFRailwaySceneLoD3Example/Railway_Scene_LoD3%E6%8F%90%E4%BE%9B%E7%9A%84%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE%E9%9B%86%E3%80%82%E6%9C%AC%E7%A4%BA%E4%BE%8B%E5%81%87%E8%AE%BE%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE%E9%9B%86%E5%AD%98%E5%82%A8%E5%9C%A8Docker%E4%B8%BB%E6%9C%BA%E7%9A%84%60/home/docker/data/%60%E7%9B%AE%E5%BD%95%EF%BC%9A

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。

!https://github.com/tum-gis/3dcitydb-web-map-docker/blob/master/images/data-listing-01.png

如何构建

要从本仓库的Dockerfile构建3DCityDB-Web-Map-Client Docker镜像，需从本仓库下载源代码并运行docker build命令。按照以下步骤构建3DCityDB-Web-Map-Client Docker镜像，或使用https://github.com/tum-gis/3dcitydb-web-map-docker/blob/master/build.sh%E8%84%9A%E6%9C%AC%E3%80%82

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