服务发布

服务发布模块主要为用户提供二三维数据切片与服务发布功能，支持对影像、倾斜三维模型、地形、通用三维模型、矢量数据（待上线）、激光点云数据（待上线）进行切片与服务发布，发布成功的服务支持预览与分发使用。

• 发布影像服务详细操作请参考发布影像服务。

• 发布倾斜三维模型服务详细操作请参考发布倾斜三维模型服务。

• 发布地形服务详细操作请参考发布地形服务。

• 发布通用三维模型服务详细操作请参考发布通用三维模型服务。

1. 所有功能

1.1 发布影像服务

支持选择本地影像文件（.tif、.tiff），填写参数后进行影像切片与服务发布。

影像服务发布的具体参数如下：

基础信息：

字段	说明
导入文件	必填，选择本地影像文件（.tif、.tiff）。
服务名称	必填，名称须以小写字母开头，长度4-32，由字母、数字、下划线组成。
备注	选填，可根据实际情况填写。

处理参数：

字段	说明
最大级别	选填，最大级别参数控制瓦片最终能放大到多少级别。默认：自动计算，将根据栅格数据分辨率计算出该值。 支持自行设置，范围 [10, 25]，实际会取设置值和自动计算的最小值。推荐默认值。
服务类型	选填，发布的影像服务中切片索引组织方式，支持WMTS、TMS两种。 WMTS 从 0 级开始，以地图左上角为原点，从左到右为横轴正方向，从上到下为纵轴正方向。 发布的WMTS服务类型其切片索引为{z}/{x}/{y}形式。 TMS以地图左下角为原点，纵轴从下到上为正方向。
投影类型	选填，支持墨卡托和经纬度两种格式。
瓦片大小	选填，切片后影像图片的像素宽高，支持256和512两种。根据常规传统，瓦片大小都是 256，但事实上可以设置512，这样可以在大屏上减少瓦片的请求次数。
背景透明	选填，背景透明用于解决切片之后的数据有白边或者黑边的情况，支持三种方式。自动：自动根据栅格的波段元数据判定哪个波段是透明色，适合元数据信息完整的数据。 第四波段：如果栅格的波段数大于3个，那么强制使用第四波段是透明波段，适合实际数据有第四波段，且确定该波段是透明值的数据。 透明色：无论栅格的波段数是多少，只要读取到的颜色等于此处设定的RGB值，则认为该像素是纯透明的，适合透明信息不完整的数据。

导出数据：

字段	说明
输出路径	必填，用户选择本地文件夹作为输出路径，切片数据会默认存储在用户设置的路径中，便于后续使用。

发布操作：

字段	说明
取消	点击取消，退出当前服务发布流程，且已输入的内容不会被保存。
发布	点击发布，当前内容保存并发布成对应的服务，可在正在发布列表中查看进度。

1.2 发布倾斜三维模型服务

支持选择本地OSGB数据（Data文件夹所在目录），填写参数后进行倾斜三维模型切片与服务发布。

倾斜三维模型服务发布的详细参数说明如下：

基础信息：

字段	说明
导入文件	必填，选择本地OSGB数据（Data文件夹所在目录）。
服务名称	必填，名称须以小写字母开头，长度4-32，由字母、数字、下划线组成。
备注	选填，可根据实际情况填写。

坐标参数：

字段	说明
空间参考	选填，空间参考可以形象的比喻为地理数据的定位系统，其定义了如何识别和放置数据在地球上的具体位置。空间参考用于确定数据的真实位置，此项设置不当将导致处理结果位置不正确甚至处理失败。如果输入文件带有空间参考信息，系统会自动识别，此时不需设置。否则，需要用户根据数据的空间参考人为指定。支持填写ENU坐标、EPSG编码和表示空间参考的PROJ或WKT格式的字符串，点击底部按钮选择后支持自动填充。
零点坐标	选填，指定数据原点相对空间参考的偏移量，分为xyz三个方向，单位米，默认为不偏移(0,0,0)，设置此值可以让数据往相应方向偏移。 一般用于三维模型在某些投影坐标系下坐标非常大，难以操作的问题。 因此会假定数据具有一个偏移位置，那么在该空间参考下：建模的坐标+零点坐标=投影坐标。
输出坐标系	选填，支持选择Mapmost默认坐标系和EPSG: 4978 作为服务输出坐标系。选择Mapmost默认坐标系发布的服务，在Mapmost SDK for WebGL中加载速度会有所提升。

处理参数：

字段	说明
重建顶层	选填，重建顶层功能将根据瓦片空间结构关系采用八叉树重建，因此开启后会加快服务渲染速度，但服务发布时长将增加，默认关闭。
强制双面	选填，强制双面即正反面均渲染纹理。一般无需开启，但对一些异常数据，可能有正反面裁剪引起的漏洞之类出现，可以尝试开启该选项，达到双面渲染的目的。
无光照	选填，开启此选项渲染效果更真实，默认开启。 但因为生成的瓦片不包含法向信息，而部分引擎对于此类数据渲染是黑色的，可以尝试关闭该选项，避免此问题。
纹理格式	选填，默认即jpg格式：原始osgb里的格式。webp：大小约默认 jpg 的 70%，可加快网络传输。ktx2：大小约默认 jpg 的 90%，减少显存消耗5/6，但服务发布时长将增加。

导出数据：

字段	说明
输出路径	必填，用户选择本地文件夹作为输出路径，切片数据会默认存储在用户设置的路径中，便于后续使用。

发布操作：

字段	说明
取消	点击取消，退出当前服务发布流程，且已输入的内容不会被保存。
发布	点击发布，当前内容保存并发布成对应的服务，可在正在发布列表中查看进度。

1.3 发布地形服务

支持选择本地地形文件（.tif），填写参数后进行地形切片与服务发布。

地形服务发布的具体参数如下：

基础信息：

字段	说明
导入文件	必填，选择本地地形文件（.tif）。
服务类型	必填，本次支持的地形格式为Quantized-Mesh
服务名称	必填，名称须以小写字母开头，长度4-32，由字母、数字、下划线组成。
备注	选填，可根据实际情况填写。

处理参数：

字段	说明
三角算法	选填，支持ctb、vcg两种，默认ctb。vcg:基于经典的边塌陷算法的三角网简化算法，其特点是网格结构质量较好，误差小，但处理速度较慢；ctb:基于网格的快速三角网简化算法，其特点是速度快，处理时间大约是vcg的1/60，但误差较大。

导出数据：

字段	说明
输出路径	必填，用户选择本地文件夹作为输出路径，切片数据会默认存储在用户设置的路径中，便于后续使用。

发布操作：

字段	说明
取消	点击取消，退出当前服务发布流程，且已输入的内容不会被保存。
发布	点击发布，当前内容保存并发布成对应的服务，可在正在发布列表中查看进度。

1.4 发布通用三维模型服务

支持选择本地通用三维模型数据（.obj、.fbx），填写参数后进行通用三维模型切片与服务发布。其中EPSG编码搜索和KTX2纹理是高级功能，支持免费试用7天，如需续期或购买可联系客服。

通用三维模型服务发布的详细参数说明如下：

基础信息：

字段	说明
导入文件	必填，选择本地三维模型数据（.obj、.fbx，可以选择多个，但是要保证模型共用同一个中心点坐标）。
服务名称	必填，名称须以小写字母开头，长度4-32，由字母、数字、下划线组成。
备注	选填，可根据实际情况填写。

坐标参数：

字段	说明
空间参考	必填，空间参考可以形象的比喻为地理数据的定位系统，其定义了如何识别和放置数据在地球上的具体位置。空间参考用于确定数据的真实位置，此项设置不当将导致处理结果位置不正确甚至处理失败。如果输入文件带有空间参考信息，系统会自动识别，此时不需设置。否则，需要用户根据数据的空间参考人为指定。支持填写ENU坐标、EPSG编码和表示空间参考的PROJ或WKT格式的字符串，点击底部按钮选择后支持自动填充。
零点坐标	选填，指定数据原点相对空间参考的偏移量，分为xyz三个方向，单位米，默认为不偏移(0,0,0)，设置此值可以让数据往相应方向偏移。 一般用于三维模型在某些投影坐标系下坐标非常大，难以操作的问题。 因此会假定数据具有一个偏移位置，那么在该空间参考下：建模的坐标+零点坐标=投影坐标。
输出坐标系	选填，支持选择Mapmost默认坐标系和EPSG: 4978 作为服务输出坐标系。选择Mapmost默认坐标系发布的服务，在Mapmost SDK for WebGL中加载速度会有所提升。
翻转YZ坐标	选填，如果模型Y轴向上，则打开该开关后Z轴向上，反之亦然，该选项用于解决服务发布后，三维引擎加载时向上轴不一致的问题。

处理参数：

字段	说明
处理器	选填，分为小场景处理器和八叉树处理器。小场景处理器特点是不对输入数据做任何简化和缩放，使用原始精度。但会做合并、压缩、分割等。在保证显示质量不损失的前提下，最大化提升数据加载效率。一般情况使用小场景处理器发布服务，只有在数据处理后无法完成加载，才考虑采用八叉树处理器来创建 LOD，创建LOD对算法要求较高，且运行时间漫长。
最大切片	选填，小场景处理器下支持。该参数控制最大切片大小，单位MB，范围【1-256】。默认20MB，即表示处理过程中如果有一些b3dm超过 20MB，则尝试进行分割。
实例优化数	选填，小场景处理器下支持。该参数表示一个几何体复用次数超过该数值，则使用i3dm方式渲染，反之使用 b3dm。模型复用率越高，i3dm优化意义越大，最好根据数据来匹配调整以达到渲染批次和数据量的平衡。默认为50。
最小级别	选填，八叉树处理器下支持。默认自动：即根据模型数据自动识别，同时支持指定，但建议一般16级，对应精度0.59米，即最多能看清楚半米左右的区别
级别范围	选填，八叉树处理器下支持。级别范围用于确定最大级别，计算公式：最大级别=最小级别+级别范围，其支持取值范围为[0, 8]
LOD 策略	选填，八叉树处理器下支持。重建化简:按照八叉树分块边界对数据分块后在每块内尝试简化。该策略特点是简单适应性强，但简化速度过慢，而且有个别表面法向量不正确.。 尺寸过滤:根据每个对象的大小和当前八叉树级别来计算对象的像素大小，当大于最小像素参数时，将对象存于当前八叉树节点中。 该策略下，每个对象实际并未精简，只是每个对象加载的优先级因其大小而不同，适合构件个数非常多的复杂 BIM 模型。
三角网化简	选填，八叉树处理器下支持。在LOD策略选择重建化简时有效，不开启，将不对几何体重建，但会对纹理重建。开启，可减少顶点个数。如果场景里几何体复杂密度很高，建议开启。
透明模式	选填，小肠经处理器下支持。用户可以强制设置透贴的形式，可以指定是MASK或者BLEND。 【自动】：当模型是混合材质时（半透明+不透明混合），系统自动识别模型透明通道的alpha值，如果alpha值只有0或者255时，使用MASK（适配树叶、格栅等）；如果alpha值在0~255之间时，使用BLEND模式（适配玻璃等）。 【MASK】：当模型材质的透明通道设置错误，导致本应不透明的物体（如树叶、格栅）被误渲染为半透明时，启用此模式可强制将其纠正为“非透即不透”的真实效果。 【BLEND】：当所有模型都是半透明材质（例如玻璃、水面等）时，推荐使用BLEND，可以直接解决透明罩、亚克力、玻璃廊道、薄膜类等半透明材质的渲染问题。

纹理参数：

字段	说明
纹理合并	选填，小场景处理器下支持。纹理合并是对于重复贴图方式的纹理进行的合并优化。
纹理格式	选填，分为默认、basis、webp和ktx2四种。默认：使用 jpg（非透明）或者 png（透明）格式。basis：压缩速度更快，且支持 pc，android，iphone多平台使用。webp：大小约默认 jpg 的 70%，可加快网络传输，但不会减少显存占用。ktx2：大小约默认 jpg 的 90%，减少显存消耗5/6，但服务发布时长将增加。
颜色转纹理	选填，默认关闭，该选项适用于内部几乎没有纹理的BIM 构件，绝大部分构件都是不同颜色，为了能降低渲染批次，则开启。

导出数据：

字段	说明
输出路径	必填，用户选择本地文件夹作为输出路径，切片数据会默认存储在用户设置的路径中，便于后续使用。

发布操作：

字段	说明
取消	点击取消，退出当前服务发布流程，且已输入的内容不会被保存。
发布	点击发布，当前内容保存并发布成对应的服务，可在正在发布列表中查看进度。

1.5 其他类型数据服务发布

矢量、激光点云数据、3DGS模型服务发布功能待上线，敬请期待！这些功能已经在Mapmost Studio离线部署版中上线，如需使用，请联系客服。

2. 正在发布

2.1 服务详情查看

展示正在发布中的任务列表，用户可以查看当前正在发布的服务名称、任务开始时间、服务类型、任务进度等信息。

2.2 服务成果查看

点击任务列表右上角文件夹按钮，可查看成果文件。

2.3 服务删除

点击任务列表右上角删除按钮，可删除正在处理的任务。

3. 发布成功

3.1 服务详情查看

展示发布成功的服务列表，用户可以查看已发布成功的服务名称、服务类型、服务地址、服务发布时间、服务数据大小等信息。

3.2 服务成果查看

点击服务列表中的文件夹按钮，可查看成果文件。

3.3 服务删除

点击服务列表右上角删除按钮，可删除处理完成的服务，删除后服务和成果文件将无法恢复。

3.4 服务地址复制

点击服务列表中的复制按钮，可将该服务的地址复制到剪贴板，方便用户分发使用。 注意：若服务地址中的IP为localhost或127.0.0.1，该服务只能在本机访问，无法在其他设备上访问，若需要在其他设备上访问，需要将服务地址中的IP替换为本机的IPv4地址，例如：192.168.1.100，具体操作方式请参考设置中的IP配置方法。访问设备需要和服务发布设备在同一局域网内。

3.5 服务预览

发布成功的服务支持预览，点击服务列表左侧卡片中的“小眼睛”预览按钮，可预览该服务的渲染效果。

3.6 服务启停

发布成功的服务支持启停，启用状态服务可预览与使用，停用状态服务不可预览与使用。

4. 发布失败

4.1 服务详情查看

展示发布失败的服务列表，用户可以查看发布失败的服务名称、服务类型、服务创建时间等信息。

4.2 服务成果查看

点击服务列表右上角文件夹按钮，可查看成果文件。

4.3 服务删除

支持点击服务列表右上角删除按钮，可删除处理失败的服务。

4.4 服务重新处理

发布失败的服务支持重新处理。

4.5 服务日志查看

处理失败的任务支持查看日志。