空间数据共享平台商用数据集调用方式

香港空间数据共享平台（Common Spatial Data Infrastructure，简称 CSDI，俗称”空间数据共享平台”）由发展局空间数据办事处牵头建设，自 2022 年底上线以来持续扩充数据资源，已成为香港地理空间数据的统一门户。平台同时服务公众与商业用户，前者可免费浏览与下载开放数据，后者则可通过专门的数据集目录与 API 服务接入更丰富的商用资源。对于有意进入香港市场、需要在地图与空间分析层面做本地化的内地企业、开发者与研究机构而言，CSDI 是一项值得关注的基础设施。

核心价值：以政府权威空间数据为底座，统一坐标、统一格式、统一调用入口，降低企业接入香港地理信息资源的门槛。

一、CSDI 平台整体架构

CSDI 并非单一的”下载站”，而是一套分层的数据基础设施，由三个相互衔接的部分组成。

1. 平台门户（Portal）

门户是普通用户与企业用户的统一入口，提供数据集检索、地图预览、元数据查看、API 文档浏览等功能。数据集按主题划分为建筑、地籍与发展、地形、人口、社会经济、交通与运输、环境等大类，每类下细分为数十到数百组具体数据集。

2. 开放数据空间（Open Data）

凡标注为”开放”的数据集，均可免登录直接下载，常见格式包括 CSV、GeoJSON、Shapefile、KML 等。开放数据多用于公众服务、教育研究及非商业应用，是公众最常接触的部分。

3. 商用数据集目录（Business Dataset）

商用数据集目录收录了具备较高商业价值或更新频次较高的数据资源，例如详细地籍资料、规划申请数据、交通流量统计等。这部分数据往往附带特定的许可条款，调用方式与开放数据有所不同，是本文的重点。

二、开放数据集与商用数据集的区别

对内地读者而言，第一步要先分清”开放”与”商用”的边界。下表列出主要差异（具体范围以官方最新公布为准）：

维度	开放数据集	商用数据集
访问门槛	无需注册	通常需以机构账户申请，部分需签署许可
调用方式	直接下载或匿名 API	注册 API Key，调用受配额限制
数据深度	概要性、聚合性数据为主	字段更细、分辨率更高、覆盖更全
商用许可	多数允许商业用途，但需注明来源	通常附带专门许可，须按条款使用
更新频率	年级或半年级	部分数据集近实时或按月更新
收费情况	免费	大部分免费，个别高精度数据集可能收费

简言之，开放数据集适合做原型验证与基础可视化，商用数据集则面向需要长期、稳定接入并嵌入商业产品的企业用户。

三、调用前的准备工作

内地企业接入 CSDI 商用数据集，建议按以下顺序做好准备：

1. 注册平台账户

前往 CSDI 门户注册个人或机构账户。机构账户需提供商业登记资料、经办人授权文件等，审批周期通常为数个工作日（以官方最新公布为准）。

2. 申请 API Key

API Key 是访问商用数据集的凭证。登录后在”开发者中心”或”API 管理”模块创建应用，填写用途说明、预计调用量与系统对接方式。平台审核通过后，会发放一串唯一 Key。

3. 阅读数据集元数据

每个数据集都附有元数据页面，包含字段说明、坐标系、更新频率、覆盖范围、引用方式与许可条款。务必在调用前完整阅读，避免因字段理解偏差导致业务逻辑错误。

4. 确认坐标系

香港常用的坐标系包括 WGS84（EPSG:4326） 与 HK1980 Grid（EPSG:2326 / 3855 在部分场景亦可使用）。如需将 CSDI 数据与内地常用坐标系对接，建议提前规划转换方案。

四、四种主流调用方式

CSDI 提供多种接入途径，企业可按自身系统架构选择：

1. 直接下载（Download）

适用于一次性使用或低频场景。在数据集详情页点击下载链接，获取 ZIP 包或单文件。商用数据集的下载通常仍需登录并接受许可。

2. REST API

最常用的调用方式。通过 HTTP GET/POST 请求，按参数筛选数据集，返回 JSON 或 GeoJSON 格式。典型请求示例结构如下（实际接口以官方文档为准）：

基础地址：https://portal.csdi.gov.hk/api/v1/
鉴权参数：API Key 置于请求头或查询字符串
通用参数：数据集 ID、筛选条件、返回格式、分页信息

REST API 适合做实时查询、地图可视化与轻量级分析。

3. OGC 标准服务（WMS / WFS / WMTS）

CSDI 部分地图类数据集支持 OGC（Open Geospatial Consortium） 标准服务接口，可直接在 GIS 软件或前端地图库（如 Leaflet、Mapbox、OpenLayers）里作为底图叠加图层使用，无需自行渲染瓦片。

4. 批量数据订阅（Bulk Subscription）

针对需要持续同步大规模数据集的企业，可申请批量数据订阅服务。平台会按约定周期（如每日、每周、每月）将增量数据包推送至企业指定的存储位置。该方式适合做离线分析、BI 报表与历史归档。

五、典型商用数据集清单

以下为内地企业较常关注的几类数据集（具体清单与字段以官方最新公布为准）：

类别	代表数据集	典型用途
地籍与地块	土地用途分区、地块边界、不动产成交资料	选址分析、投资可行性评估
建筑	建筑物高度、楼龄、用途分类、3D 城市模型	智慧楼宇、保险风控
交通	道路网、实时交通流、公共交通线路与站点	物流路径规划、出行 APP
规划	城市规划委员会图则、规划申请记录	开发前期调研
人口与社会经济	小区统计、人口分布、商业活动指数	市场选址、人流分析
环境与气象	空气质量、台风路径、降雨数据	灾害风险评估、户外作业调度

注意：部分数据集涉及个人住址、敏感设施或商业机密，仅供政府内部或受授权机构使用，企业调用前需逐项核实许可范围。

六、合规与许可要点

内地企业在使用 CSDI 商用数据时，建议重点关注以下合规事项：

来源标注：绝大多数数据集要求在最终产品或报告中注明”资料来源：香港空间数据共享平台”。
二次分发限制：部分数据集禁止原样转售或以数据集本身作为商品对外提供。
更新同步：若数据涉及定期更新，企业须建立内部更新机制，避免使用过期版本导致决策偏差。
数据安全：API Key 须妥善保管，避免泄露到前端代码或公开仓库；建议通过服务端中转调用。
跨境传输：将香港地理数据回传内地服务器或境外云平台时，须同时遵守《个人资料（私隐）条例》以及企业所在地的数据出境监管要求。

七、调用流程速查

为方便内地团队快速上手，整理一份精简流程清单：

访问 CSDI 门户，注册机构账户并通过审核
进入数据集目录，筛选”商用”标签，浏览元数据
选定数据集后，在”开发者中心”申请 API Key
按官方文档构造 REST 或 OGC 请求，进行本地联调
在测试环境中验证字段、坐标系与返回格式
小流量上线，监控调用配额与响应延迟
接入正式业务系统，建立数据更新与异常告警机制

八、常见问题速答

Q：内地公司能否直接注册并调用？ 可以。平台对注册主体没有地域限制，内地企业凭商业登记证或同等资质文件即可申请机构账户。
Q：商用数据是否一定收费？ 多数商用数据集当前阶段为免费，但附带许可条款。少数高精度或定制化数据集可能收取数据处理费用，具体以官方公布为准。
Q：调用频率是否受限？ 是。API 通常设有每秒调用次数（RPS）或每日调用次数上限，企业可按需申请提升配额。
Q：能否将数据嵌入自有 SaaS 产品对外提供服务？ 视许可条款而定。部分数据集允许嵌入并对外提供服务，但禁止将原始数据原样对外转售；建议签署正式许可或向平台方咨询确认。
Q：旧版本的 API 会否失效？ 平台升级时通常会保留旧版本一段时间的并行期，企业应订阅平台公告，及时迁移。

香港空间数据共享平台为商业用户提供了较为系统的接入体系，从开放数据到商用数据集、从直接下载到 OGC 标准服务，覆盖了不同规模与复杂度的应用场景。内地企业在落地香港业务时，可将 CSDI 作为权威空间数据底座，结合自有数据形成差异化分析能力。需要留意的是，数据许可、坐标系转换与 API 配额是实际落地中最容易踩坑的三个环节，建议在项目早期即纳入技术评审。

如需了解更多香港营商环境、数据资源与人才政策的实用指南，欢迎持续关注香港大全——我们专注于为内地读者提供赴港工作、创业、生活与学习的全方位信息。