离线地图部署各种问题解答

文档编号	维护人	内容	版本号
2025041601	WA	离线地图部署	V1.0

场景一

基于司空私有化2平台上部署XYZ格式的地图瓦片
（注意：前提条件司空私有化服务器服务正常）

1、地图数据获取

方式一：通过地图下载工具进行地图文件下载，例如 MobileAtlasCreator、水经微图、太乐地图。操作请参考跳转链接。

方式二：将影像 TIF 数据（需含有坐标系）转为 XYZ 格式瓦片集合，操作请参考跳转链接。
说明：
如果需要更多 XYZ 地图瓦片数据知识，请跳转链接进行阅读。

2、地图数据的配置

2.1
把xyz格式的地图瓦片文件拷贝到服务器 ${DATA_ROOT_PATH}/static_data/asset-map/png-tiles/ 目录下（注：DATA_ROOT_PATH为实际部署时数据安装目录，env文件里面配置的地址）。

2.2
修改地图配置文件${DATA_ROOT_PATH}/conf/map/map_config.yaml，修改配置文件可以实现地图数据源的新增/删除/修改。

说明：
XYZ 卫星底图地图瓦片链接的拼接规则
${SERVICE_DOMAIN}:${MAP_CUSTOM_TCP_PORT}/${DATA_ROOT_PATH}/static_data/asset-map/png-tiles/

例如：
卫星瓦片文件存放路径为/data/static_data/asset-map/png-tiles/loudi-xyz/{z}/{x}/{y}.jpg

那么map_config.yaml文件里面配置的卫星瓦片链接就为
${SERVICE_DOMAIN}:${MAP_CUSTOM_TCP_PORT}/${DATA_ROOT_PATH}/static_data/asset-map/png-tiles/loudi-xyz/{z}/{x}/{y}.jpg

XYZ 路网瓦片链接的拼接规则
${SERVICE_DOMAIN}:${MAP_CUSTOM_TCP_PORT}/${DATA_ROOT_PATH}/static_data/asset-map/street-tiles/

例如：
路网瓦片文件存放路径为/data/static_data/asset-map/street-tiles/loudi-xyz/{z}/{x}/{y}.jpg

那么map_config.yaml文件里面配置的路网瓦片链接就为
${SERVICE_DOMAIN}:${MAP_CUSTOM_TCP_PORT}/${DATA_ROOT_PATH}/static_data/asset-map/street-tiles/loudi-xyz/{z}/{x}/{y}.jpg

注意：SERVICE_DOMAIN（司空私有化服务器外网IP）、MAP_CUSTOM_TCP_PORT（默认30813）、DATA_ROOT_PATH（实际部署数据安装目录），以实际部署环境env文件配置为准。

例如：
#vim /data/conf/map/map_config.yaml

数据项的参数说明：

参数名称	参数用途	参数说明
name	界面上显示的名称	使用常规字符串，不含特殊符号，不为空
type	地图上图标类型	 default - 即随安装包默认携带的卫星地图 custom - 表示自定义的离线数据此参数仅影响右下角的地图底图图标样式
link	卫星数据 URL	URL 中的占位符 {z}、{x}、{y} 与发布的数据服务层级关系一致，后缀名与数据服务瓦片格式的后缀名一致。举例：http://myhost.org/services/testdata/{z}/{x}/{y}.png
street_link	配套的街道数据URL	可选项，若数据项无配套路网数据，可省略此选项。配置规则与 link（卫星数据URL）一致
min_z	数据可用最小层级	可选，默认值为0，请提供数据源的真实最小层级，只影响卫星数据。地图缩小到对应级别时，所有小于这个层级的数据都会以这个层级的数据为基准缩放。如果没有配置，小于真实最小层级时会显示为空白。
max_z	数据可用最大层级	可选，无默认值，请提供数据源的真实最大层级，只影响卫星数据。地图放大到对应级别时，所有大于这个层级的数据都会以这个层级的数据为基准缩放。如果没有配置，大于真实最大层级时会显示为空白。

3、离线地图的发布

在 ${部署安装包解压目录}/tool/map/ 路径下执行命令：

访问司空私有化平台验证地图发布是否成功

场景二

独立的服务器上部署XYZ格式的地图瓦片服务
（注意：前提条件地图服务器和司空私有化服务器网络通讯正常）

1、部署前准备

** 1.1
司空私有化平台查看自定义地图用到的容器，登录网关dashboard 页面（自定义地图用到的是30813端口检查这个端口指向的容器）**

1.2
导出地图服务镜像文件
（在司空私有化服务器里面查看地图服务容器用到的镜像然后导出文件导入到要部署的地图服务器）

#docker ps|grep map-server-nginx

#docker inspect map-server-nginx |grep Image

#docker images |grep nginx

司空私有化服务器内找到Nginx镜像
#docker images |grep nginx

使用 docker save 命令导出镜像为一个 .tar 文件
#docker save -o nginx_image.tar harbor.djicorp.com/es310/public/nginx:1.26.1

1.3
在新的地图服务器内导入上面nginx_image.tar 镜像。
（注意：服务器先要安装docker环境版本不低于27.2.0）
使用docker 安装包和脚本安装（司空私有化安装包解压目录下的tool/docker/目录）

安装docker
#bash ./install_docker.sh

检查docker版本
#docker --version

导入Nginx镜像文件到新的地图服务器
#docker load -i nginx_image.tar

2、部署和配置地图服务

** 2.1
在新的地图服务器里面启动容器前先创建需要的配置文件和地图数据。**

在compose.yaml文件内检查司空私有化服务器里面原来地图服务map-service-nginx的配置文件和涉及到的文件为asset-map-nginx.conf 。

拷贝这个文件到新的离线地图服务器内（存放目录自己定义保证足够权限就可以）
然后文件添加如下配置

add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE, PATCH, HEAD, TRACE';
add_header 'Access-Control-Max-Age' '100';

** 2.2
在新的地图服务器里面启动Nginx容器**
#docker run -itd -p 5971:80 -v /mnt/map/loudi-map:/var/png-tiles -v /mnt/map/accst-map/asset-map-nginx.conf:/etc/nginx/nginx.conf harbor.djicorp.com/es310/public/nginx:1.26.1

说明：
-p 5971:80
*将宿主机的 5971 端口映射到容器的 80 端口（Nginx 默认监听 80）

-v /mnt/map/loudi-map:/var/png-tiles
*将本地路径 /mnt/map/loudi-map 里的地图数据挂载到容器的 /var/png-tiles 目录。
容器里的 Nginx 会通过 /var/png-tiles 提供地图瓦片服务。

-v /mnt/map/accst-map/asset-map-nginx.conf:/etc/nginx/nginx.conf
*将本地自定义的 nginx 配置文件挂载到容器的 /etc/nginx/nginx.conf（替换默认配置）。
意味着你用了一个自定义配置文件去控制 nginx 的行为，比如怎样访问 /var/png-tiles

harbor.djicorp.com/es310/public/nginx:1.26.1
*使用指定私有仓库中的 Nginx 镜像（版本 1.26.1）来运行容器。

2.3
司空私有化服务器内重新更新地图配置文件地址指向独立的地图服务器地址（配置具体方法场景一配置方法，修改IP和端口以及实际的XYZ地图瓦片目录名）

司空私有化服务器上重新发布地图

3、验证离线地图服务

登录司空私有化平台验证刚配置的新地图服务

离线地图部署各种问题解答

场景一#

1、地图数据获取#

2、地图数据的配置#

3、离线地图的发布#

场景二#

1、部署前准备#

2、部署和配置地图服务#

3、验证离线地图服务#