发布二维数据服务

1352字约5分钟

2025-3-25

通过数据处理的流程我们大概了解了目前二维相关的影像、地形、模型都是瓦片形式的静态资源文件，如果我们需要发布为服务，只需要通过HTTP方式发布后，平台即可调用。

1. 准备好离线地图数据

1.1 准备数据

可以下载mars2d-data示例数据测试数据放在本地电脑的 D:\mars2d-data\目录
如果是购买了Mars2D离线数据时，按离线数据的使用教程，拷贝好数据到本地电脑。

1.2 拷贝数据到服务器

将数据拷贝到电脑的D:\mars2d-data\目录，如果没有数据，也可以直接建立该目录，并按数据类型分子目录后放各类数据，目录效果如下：

如果需要放其他盘或其他目录时，在后续流程参考已有配置修改D:\nginx\conf\host\localhsot_80.conf配置即可。

1.3 解压压缩包数据（如有）

如果是网盘交付的数据时，进入 mars2d-data 根目录和各子目录中(3dtiles、terrain、tile等)找到所有 rar 压缩包，解压各压缩包至当前目录中（注意:右击所有压缩包解压至当前文件夹），为了节省空间，解压完成后，请删除所有 rar 压缩包。

2. Nginx软件安装

如果您服务器已安装有其他可以发布web前端静态资源的http容器，可以跳过此步骤，直接按您说熟悉的技术路线发布网站，如 IIS、Tomcat、NodeJS 等均可。

2.1 下载nginx软件

nginx下载地址（已配置好conf文件，包括跨域设置）

解压nginx.rar至D盘根目录，解压后效果如下

2.2 安装注册至window服务

为了开机自启动服务，打开“命令说明.txt”复制nginx-service.exe install命令进行安装操作。

如果没有放在D盘根目录，修改nginx-service.xml里的目录路径为实际安装路径。
默认端口为80，如有冲突请修改D:\nginx\conf\host\localhsot_80.conf文件

如果不需要注册window服务，单次启动输入start nginx命令即可。

2.3 启动nginx服务

通过window服务中启动nginx服务，访问http://localhost/校验服务是否正常启动。

2.4 测试服务是否正常

可以测试任意一个文件，如果浏览器可以正常访问，说明服务是发布成功的。

比如文件路径为D:\mars2d-data\tile\img\0\0\0.jpg,

对应的服务url地址为：http://localhost/mars2d-data/tile/img/0/0/0.jpg

如果图片正常显示，说明服务发布成功了。

特定数据格式，也可以在对应代码中测试服务URL

XYZ底图时：可以参考教程加载XYZ数据步骤

2.5 发布自己的数据（将各种工具处理后的数据放在目录中）

当后续项目中处理好的自己数据时，可以参考下面步骤来进行发布。我们以示例数据中大雁塔倾斜摄影数据 D:\mars2d-data\3dtiles\qx-dyt\目录为例做讲解。

我们将 qx-dyt 大雁塔数据，放在D:\mars2d-data\子目录后，文件路径为D:\mars2d-data\3dtiles\qx-dyt\tileset.json

对应的服务url地址为：http://localhost/mars2d-data/3dtiles/qx-dyt/tileset.json

3. 修改项目源码中配置

3.1. 批量替换URL

使用 vscode 等编辑工具打开所有交付源码包，在批量替换功能中，批量全字匹配 data.mars2d.cn 替换为 192.168.0.87/mars2d-data （我们假设电脑IP为：192.168.0.87 具体以您发布的实际IP和端口地址为准）

3.2. 修改config.json配置离线底图

（1）当存在离线底图时，可以按下面示例修改basemaps配置

{
  "center": {}, //已忽略其他参数值 
  "basemaps": [
    {
      "name": "离线影像地图",
      "icon": "https://data.mars2d.cn/img/thumbnail/basemap/google_img.png",
      "type": "tile",
      "url": "//localhost/mars2d-data/tile/googleImg/{z}/{x}/{y}.jpg",
      "minimumLevel": 0,
      "maximumLevel": 13,
      "show": true
    }, 
  ],
  "operationallayers": [] //已忽略其他参数值
}

可以参考离线数据示例代码和效果体验。

4.非Nginx服务时，注意事项

4.1. 设置mimeMap

DotNet：IIS的功能视图添加MIME设置或下载 web.config 放在站点根目录即可。

<mimeMap fileExtension=".json" mimeType="application/json" />
<mimeMap fileExtension=".czml" mimeType="application/json" />
<mimeMap fileExtension=".terrain" mimeType="application/octet-stream" />
<mimeMap fileExtension=".b3dm" mimeType="application/octet-stream" />
<mimeMap fileExtension=".pnts" mimeType="application/octet-stream" />
<mimeMap fileExtension=".cmpt" mimeType="application/octet-stream" />
<mimeMap fileExtension=".i3dm" mimeType="application/octet-stream" />
<mimeMap fileExtension=".gltf" mimeType="application/octet-stream" />
<mimeMap fileExtension=".glb" mimeType="application/octet-stream" />

Java：Tomcat的web.xml配置

<mime-mapping>
    <extension>json</extension>
    <mime-type>application/json</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>czml</extension>
    <mime-type>application/json</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>terrain</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>b3dm</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>pnts</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>i3dm</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>cmpt</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>gltf</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>glb</extension>
    <mime-type>application/octet-stream</mime-type>
</mime-mapping>

4.2. 允许跨域

根据技术栈自行百度在服务端加下允许跨域。

跨域问题的理解，可以参考教程加载外部资源的跨域问题