访问级别

每个服务和地图方案都有一个访问级别，决定谁可以读取它。

三种级别

级别	控制台说明	谁能读取
公开	任何人无需登录即可访问	任何人
API Key	持有本工作空间 API Key 的程序，或工作空间成员	带有本工作空间有效 API Key 的请求；或已登录、对该工作空间有读权限的用户
私有	仅工作空间成员登录后访问	已登录、对该工作空间有读权限的用户

• 新建的服务与地图方案默认私有。 要给外部网页或程序使用，请改为「公开」或「API Key」。
• 「有读权限」指：平台管理员，或在该工作空间有读权限的成员（含工作空间所有者）。
• 公开的服务不看 Key：请求即使带了无效、已撤销或其他工作空间的 Key，也照常返回。
• 私有的服务只能在登录了控制台的浏览器里访问（如控制台的预览）。第三方程序请使用「API Key」级别。
• 一个 API Key 只对它所在工作空间里「公开」或「API Key」级别的服务与方案有效，对其他工作空间的服务无效。API Key 的创建与使用见 API Key 与来源白名单。

在哪里设置

• 服务：发布时在发布向导的「服务设置」、图层的发布面板或地图的发布面板中选择「访问级别」；发布后在服务详情的「设置」页签修改并保存。服务详情的标题旁有级别徽标。
• 地图方案：在「制图资源 → 底图方案」的方案菜单中点「分享…」，见地图方案与工作台。
• 不属于任何工作空间的平台公共服务，只有管理员可以修改级别。

写操作

要素服务的编辑接口（applyEdits、addFeatures、updateFeatures、deleteFeatures）不受访问级别影响，一律按写操作判断：

• 必须登录，且是平台管理员或对服务所在工作空间有写权限；API Key 不能用于写操作。
• 这些接口只接受 POST，用 GET 或 HEAD 访问返回 HTTP 405，错误码 METHOD_NOT_ALLOWED，并带 Allow: POST 响应头。

改级别后多久生效

变更	生效时间
服务的访问级别	最长约 30 秒。由公开改为非公开后，这段时间内仍可匿名读取
地图方案的访问级别	通常立即生效，最长约 30 秒
工作空间成员与权限	最长约 30 秒
新建、撤销 API Key	通常立即生效，最长约 30 秒
API Key 到期	立即

缓存与 CDN

• 非公开服务与方案的成功响应带 Cache-Control: private，告诉 CDN 与代理不要缓存；非公开服务的响应另带 Vary: X-GeoBridge-Token（用请求头传 Key 时地址相同、内容因 Key 而异）。如果你在平台前面加了 CDN 或缓存代理，必须让它尊重 Cache-Control: private，否则可能把非公开服务的瓦片发给匿名用户。
• 从公开改为 API Key 或私有后，CDN 与浏览器中已缓存的公开瓦片在缓存有效期内仍可能被匿名取到（动态瓦片 5 分钟，预切瓦片默认最长 1 小时）。需要立即生效时，请清除 CDN 中该服务的缓存。
• 同一浏览器切换登录账号后，浏览器缓存里上一个账号读过的私有瓦片最长还会保留 5 分钟。