OpenSyria Data Geography

OpenSyria Data Geography 是叙利亚公共非个人行政地理数据的权威存储库，覆盖省、区、子区、城市、城镇、村庄和地点等地理范围，提供版本化的发布工件，支持JSON、NDJSON、CSV、SQL、YAML和XML格式。OpenSyria Data Geography is an authoritative repository of public non-personal administrative geographic data for Syria, covering geographic scopes including governorates, districts, sub-districts, cities, towns, villages and locations. It provides versioned release artifacts and supports multiple formats such as JSON, NDJSON, CSV, SQL, YAML and XML.

原始信息汇总

OpenSyria Data Geography 数据集详情

数据集概述

OpenSyria Data Geography 是公开、非个人的叙利亚行政区划地理数据的权威仓库，主要用于提供稳定的参考数据，不包含实时地图或作战/安全信息。

数据范围

包含的地理层级

• 省（Governorates）
• 区（Districts）
• 次区（Subdistricts）
• 城市、镇、村、地方（Cities, Towns, Villages, Localities）

不包含的数据

• 个人数据、私人地址
• 检查站、军事/安全地点
• 监控相关数据
• 无来源的政治声明
• 专有地图数据
• 无法合法再分发的数据

当前状态

最新公开种子发布版本：v0.1.3

当前种子数据覆盖情况

数据集	记录数
省	14
区	62
次区	272
地方	7,605

支持的导出格式

JSON、NDJSON、CSV、SQL、YAML、XML

当前生成的制品

• governorates
• districts
• subdistricts
• localities

仓库结构

• data/：包含规范数据文件（governorates.json、districts.json、subdistricts.json、localities.json、sources.json）
• schemas/：包含各数据集的 JSON Schema 定义
• scripts/：包含验证、构建、报告、分析等脚本
• imports/：导入相关工作流程
• examples/：示例文件
• fixtures/：机器验证的假数据
• docs/：包含数据模式、覆盖分析、数据质量、字段参考、ID策略、发布清单等文档
• contributions/：贡献者工作流程

数据工作流程

1. 编辑 data/ 下的规范文件
2. 运行验证
3. 构建发布制品
4. 发布 GitHub Release，包含 release-manifest.json 和 artifacts/ 下的文件

贡献模型

贡献仅限于改进已批准的数据集，包括：

• 修正错误值
• 添加缺失记录
• 改进名称、别名、翻译和音译
• 改进来源归属
• 修正行政区划关系
• 修正坐标（当模式已支持坐标时）

新字段、新数据集主题、ID格式变更、验证变更和发布管道变更需要先通过维护者批准的模式提案。

来源政策

每条记录应可追溯到可复用的来源。

首选种子来源

• geoBoundaries：用于行政区划边界
• GeoNames：用于地名和特征参考
• Wikidata：用于公共标识符和交叉验证

OpenStreetMap 数据使用说明

OSM 衍生数据具有 ODbL 共享要求，除非维护者明确批准许可方式，否则不应混入默认的 CC BY 发布中。

工具与命令

主要命令

• pnpm run validate：验证数据
• pnpm run validate:schemas：验证模式
• pnpm run validate:imports：验证导入
• pnpm run release:build：构建发布制品
• pnpm run report:data：数据报告
• pnpm run coverage:data：覆盖分析
• pnpm run match:geonames-localities：GeoNames 匹配

开发工具

• Biome：格式化和检查
• Husky：本地 Git 钩子
• lint-staged：暂存文件检查
• commitlint：符合 Conventional Commit 的消息

许可证

详见 LICENSE.md 文件。

搜集汇总

数据集介绍

构建方式

OpenSyria Data Geography 数据集专注于提供叙利亚行政区划地理的权威公共数据。其构建过程遵循严格的工作流程：首先在 data/ 目录下编辑规范的 JSON 源文件，随后运行验证脚本确保数据符合预定义的 JSON Schema 规范，最后通过发布工具构建并输出多格式的发布产物。数据集覆盖了从省、区、次区到城市、城镇、村庄等七级地理实体，当前种子版本 v0.1.3 已收录 14 个省份、62 个区、272 个次区及 7,605 个居民点。每条记录均可追溯至可复用的权威来源，如 geoBoundaries、GeoNames 或 Wikidata，确保数据的可靠性与可验证性。

特点

该数据集的核心特点在于其高度结构化的体系与严格的质量控制。所有数据均以 JSON 格式存储于规范的源文件中，并附带详尽的 Schema 定义，保证了数据的一致性和可扩展性。数据集不包含个人隐私、军事安全或商业地图等信息，专注于稳定且非敏感的参考数据。发布产物支持 JSON、NDJSON、CSV、SQL、YAML 和 XML 六种格式，极大地方便了不同场景下的集成与应用。此外，项目通过自动化 CI 流程、Commitlint 提交规范及 Husky 本地钩子，确保了每次变更都经过严格验证，维护了数据的高质量与长期稳定性。

使用方法

使用该数据集首先需要克隆仓库并启用 pnpm 包管理器环境，通过 pnpm install 安装依赖。运行 pnpm run validate 可对源数据进行全面验证，确保数据完整性。构建发布产物时，执行 pnpm run release:prepare 指定版本号，再运行 pnpm run release:build，生成的产物存放于 dist/release/ 目录下。用户可以选择所需的格式（如 CSV 或 JSON）直接导入应用，或通过 datasets-api 消费已发布的版本化制品。对于贡献者，需遵循贡献指南，通过修复错误值、添加缺失记录或改进名称翻译等方式参与数据完善，所有贡献均需经过维护者审核并通过源头可追溯的验证流程。

背景与挑战

背景概述

OpenSyria Data Geography项目由Open-Syria社区发起，旨在构建一份公开、非个人化的叙利亚行政地理权威数据集。该项目自2024年发布首个种子版本v0.1.0以来，已逐步完善至v0.1.3，涵盖省份、地区、分区、城市、乡镇、村庄及聚落共7,605条记录。其核心研究问题在于为叙利亚战后重建、人道主义援助及区域规划提供稳定、可验证的行政地理参考数据，填补因长期冲突导致的地理信息碎片化与不可靠性。该数据集通过严格的来源追溯与维护者审查机制，整合了geoBoundaries、GeoNames及Wikidata等多源公开数据，显著提升了叙利亚地理信息的标准化与可复用性，对应急管理、土地治理及学术研究领域产生了重要影响。

当前挑战

数据集面临的核心挑战包括：首先，叙利亚长期动荡导致行政边界频繁变更、聚落数据缺失且来源矛盾，种子数据虽经维护者审核，但仍有已知的覆盖缺口与质量缺陷需通过后续版本修补。其次，构建过程中需严格平衡数据完备性与法律合规性，避免包含军事设施、检查点等敏感信息，同时规避OSM数据的ODbL共享许可与CC BY许可的冲突，确保数据可合法再分发。此外，多语言地名转写、层级关系校正及坐标精度提升等操作依赖人工干预，而贡献模型虽开放但需经维护者批准模式变更，制约了修复效率。最终，如何维持数据时效性以应对叙利亚持续演变的治理结构，成为长期维护中的关键难题。

常用场景

经典使用场景

在冲突与后冲突地区的研究中，行政区划数据的缺失与碎片化一直是制约灾害评估、人道主义响应及重建规划的核心瓶颈。OpenSyria Data Geography 作为叙利亚境内非个人公共行政区划地理数据的权威知识库，系统收录了从省份、区、次区直至村庄、乡镇与聚落等多层级地理实体，并提供标准化标识符与多格式导出接口。研究者可利用该数据集开展叙利亚境内人口分布的空间重构、公共服务可达性分析、行政区划变迁的历时性追踪等经典任务，为理解战时社会空间重组提供坚实的数据基座。

解决学术问题

该数据集直面战乱地区行政地理数据分散、缺乏统一语义体系与版本控制的学术困境。通过构建可溯源、可复现的行政区划参考框架，它解决了跨机构研究数据异构、地名歧义以及空间粒度不匹配等关键问题，使得社会地理学、政治生态学与冲突研究等领域的基础分析得以在一致的地理单元上展开。其意义在于，它为后冲突时期的叙利亚乃至类似地区的治理重建提供了可被审计、可持续迭代的底层地理信息基础设施，推动了从应急响应到长期规划的研究范式衔接。

衍生相关工作

围绕该数据集已衍生出若干关键性学术工程，包括基于其行政区划框架的叙利亚人口迁移模型构建，以及结合遥感影像与开放街道地图（OSM）数据进行的建成区变迁分析。后续工作进一步利用数据集的版本化特性，设计了时序地理编码方案，支持冲突前后地理标识的关联与比对，催生了诸如战时城市萎缩图谱与跨区域贸易路线重构等专题研究。这些衍生产品共同验证了该数据集作为稳固锚点，持续驱动冲突地理、人道主义信息学与计算社会科学交叉创新的能力。