发布服务

把数据源中的图层发布成服务后，外部程序才能通过服务地址出图、取切片或查询要素。一个服务可以同时开启多种服务能力，它们共用同一个服务名与访问级别。

服务能力

能力	用途	适用数据
MapServer（地图服务）	服务端出图：按范围出图（export）、切片（tile/{z}/{y}/{x}）、点击识别要素（identify）、图例；兼容 ArcGIS REST 风格，适合 GIS 软件与传统 Web 地图	矢量、栅格影像、栅格切片包
WMTS	标准切片服务，挂在 MapServer 之下，适合各类 GIS 软件	同上
FeatureServer（要素服务）	按属性条件与空间范围查询要素，可输出 GeoJSON	矢量
VectorTileServer（矢量切片服务）	矢量瓦片（PBF）与配套的 MapLibre 样式，前端渲染、缩放顺滑，适合 MapLibre	矢量、矢量切片包
WMS	OGC 标准出图接口（1.1.1、1.3.0），供 QGIS 等软件接入	矢量、栅格影像
WFS	OGC 标准要素接口（1.1.0、2.0.0），只读	矢量
WCS	OGC 栅格下载接口（2.0.1），按原始分辨率取回 GeoTIFF	栅格影像
TMS	TMS 1.0.0 切片，适合 GDAL、Leaflet、OpenLayers	矢量、栅格影像、切片包
OGC API	OGC API 的要素（Features）、矢量与地图瓦片（Tiles）和地图（Maps）	矢量、栅格影像、切片包

• 发布时按数据类型只列出可选的能力，并预先勾选推荐项：矢量数据推荐 MapServer、FeatureServer、VectorTileServer 与 WMTS；栅格影像推荐 MapServer 与 WMTS；栅格切片包（PNG、JPG、WebP）为 MapServer 与 WMTS，矢量切片包（PBF）为 VectorTileServer。
• WMS、WFS、WCS、TMS、OGC API 可选但不默认勾选：其中 WFS 与 OGC API 可以分页导出整层要素，WCS 可以下载原始栅格，开启后公开与 API Key 级别的服务可以被任何持有地址（或 Key）的客户端读取，请按需开启。WCS 只对栅格图层提供（地图发布时地图中有栅格图层才可选）。各协议的地址与用法见 OGC 服务概览。
• 服务能力在发布时决定。发布后要增减能力，需要回到发布来源（图层或地图）重新发布，服务详情里不能直接修改。

MapServer 的切片地址是行号在前：…/MapServer/tile/{z}/{y}/{x}，先 {y} 后 {x}，在 MapLibre、OpenLayers 中配置切片模板时请注意顺序。

三种发布方式

发布向导（推荐）

点控制台左侧导航顶部的「发布服务」（或按 N）打开向导，共四步：

1. 数据源：选择工作空间，然后上传文件、连接数据库或服务，或选用已有的数据源。
2. 选择数据：勾选要发布的图层，可以多选。
3. 服务设置：服务名称、标题、服务能力、样式、访问级别等。选了多份数据时，可以分别发布（每份数据一个服务，名称按前缀生成），也可以合并为一个地图服务（多个图层叠在一个服务里，可调整图层顺序）。
4. 确认并发布：核对后发布。向导会依次创建图层与服务，并自动启动服务。

向导的进度保存在草稿中，中途离开再回来可以继续。

发布单个图层

在「数据到服务 → 图层」中打开一个图层，点「发布」。已发布的图层在「设置」页签修改并保存后，点提示中的「重新发布」让服务生效；重新发布会覆盖原服务的配置（发布前会确认）。

发布多图层地图

在「数据到服务 → 地图」中把多个图层组合成一张地图，在地图详情点「发布服务」，地图中的图层作为同一个服务的多个子图层发布。地图内容变化后点「修改发布」更新服务。

服务名称与地址

• 服务名称只能用小写字母、数字和连字符（如 city-roads），出现在服务地址里，发布后不能修改；标题、描述、关键词、署名等可以在服务详情的「设置」页签修改。
• 服务地址形如 https://map-demo.geobridge.cn/geobridge-mapserver/rest/geodata/services/<服务路径>/<能力>，例如 …/services/city-roads/MapServer。服务放在目录中时，服务路径为 目录/服务名。
• 服务详情的「访问与代码」页签列出各能力的访问地址，并按访问级别生成 MapLibre、OpenLayers 等的接入代码。

启动与停止

• 只有运行中的服务能被访问；停止的服务对请求返回 HTTP 503。
• 通过发布向导发布的服务会自动启动；从图层或地图发布的服务需要手动启动：在「数据到服务 → 服务」列表或服务详情中点「启动」。
• 启动失败时，服务详情会显示原因，修正后点「重新启动」。

访问级别

服务有三种访问级别：公开、API Key、私有。新建的服务默认私有，只有工作空间成员登录控制台后才能访问。要给外部网页或程序使用，请在发布时或在服务详情的「设置」页签中改为「公开」或「API Key」，详见访问级别。

预览

服务详情的「全屏预览」打开服务的地图预览，可以切换 MapLibre GL 与 OpenLayers 两种渲染方式。预览中可以把当前画面保存为服务的初始视角或缩略图，见地图方案与工作台。