iraqi-data

伊拉克各省、区、分区（子区）数据，提供阿拉伯语、英语和库尔德语名称，包含别名、首府/中心、GPS 坐标、ISO 编码和 p-code 等信息，适用于地址表单、下拉菜单和配送应用；同时支持伊拉克手机号码解析、校验与运营商检测。

原始信息汇总

iraqi-data 数据集概述

基本信息

• 数据集页面：https://github.com/karam-fikre/iraqi-data
• npm 包：https://www.npmjs.com/package/iraqi-data
• 包名：iraqi-data
• 用途：提供伊拉克省、区、子区数据，适用于地址表单、下拉框和配送应用；支持手机号解析、数字转换与第纳尔价格格式化。
• 支持环境：Node.js、浏览器、React、React Native / Expo、Vue。
• TypeScript：包含类型定义。
• 依赖：无。
• 体积：主包含数据约 13 KB gzipped；子区数据约 26 KB，仅在导入时加载。
• 安装：npm install iraqi-data 或 yarn add iraqi-data。
• 语言：阿拉伯语、英语、库尔德语（索拉尼）。
• 拼写兼容：查找和搜索可识别同一地点的不同拼写，如 البصرة、البصره、Basrah、بەسرە 均可找到 Basra。
• 阿拉伯语 README：https://github.com/karam-fikre/iraqi-data/blob/main/README.ar.md
• 许可文件：https://github.com/karam-fikre/iraqi-data/blob/main/LICENSE

数据范围

省级数据

• 共 19 个省：15 个联邦伊拉克省，4 个库尔德斯坦地区省。
• 字段：id、iso、ar、en、ku、region、capital、aliases。
• capital 包含阿拉伯语名、英语名、纬度和经度。
• Halabja 于 2025 年经伊拉克议会批准为第 19 个省；暂无 ISO 3166-2 代码，因此 iso 为 null。
• 坐标来自 OpenStreetMap，Kut 与 Diwaniyah 来自 Wikidata，四舍五入到 4 位小数（约 11 米）；用于地图标记和距离，不作为精确地址。

阿拉伯语	英语	库尔德语	首府	坐标	ISO	区域
بغداد	Baghdad	بەغدا	Baghdad	33.3062, 44.3872	IQ-BG	federal
البصرة	Basra	بەسرە	Basra	30.4952, 47.8091	IQ-BA	federal
نينوى	Nineveh	نەینەوا	Mosul	36.3416, 43.1291	IQ-NI	federal
الأنبار	Anbar	ئەنبار	Ramadi	33.4260, 43.2999	IQ-AN	federal
صلاح الدين	Salah al-Din	سەلاحەدین	Tikrit	34.6158, 43.6786	IQ-SD	federal
كركوك	Kirkuk	کەرکووک	Kirkuk	35.4719, 44.3954	IQ-KI	federal
ديالى	Diyala	دیالە	Baqubah	33.7447, 44.6328	IQ-DI	federal
واسط	Wasit	واسیت	Kut	32.5147, 45.8189	IQ-WA	federal
بابل	Babil	بابل	Hillah	32.4822, 44.4328	IQ-BB	federal
كربلاء	Karbala	کەربەلا	Karbala	32.5984, 44.0158	IQ-KA	federal
النجف	Najaf	نەجەف	Najaf	32.0010, 44.3300	IQ-NA	federal
القادسية	Al-Qadisiyyah	قادسیە	Diwaniyah	31.9892, 44.9247	IQ-QA	federal
المثنى	Muthanna	موسەننا	Samawah	31.3079, 45.2827	IQ-MU	federal
ذي قار	Dhi Qar	زیقار	Nasiriyah	31.0440, 46.2399	IQ-DQ	federal
ميسان	Maysan	مەیسان	Amarah	31.8498, 47.1496	IQ-MA	federal
أربيل	Erbil	هەولێر	Erbil	36.1912, 44.0094	IQ-AR	kurdistan
السليمانية	Sulaymaniyah	سلێمانی	Sulaymaniyah	35.5571, 45.4426	IQ-SU	kurdistan
دهوك	Duhok	دهۆک	Duhok	36.8543, 42.9925	IQ-DA	kurdistan
حلبجة	Halabja	هەڵەبجە	Halabja	35.1792, 45.9874	—	kurdistan

区级数据

• 共 182 个区（أقضية），按省分组，组内按英文名排序。
• 字段：id、governorateId、pcode、ar、en、ku、center、aliases。
• pcode 为 OCHA P-code；若 OCHA 未列为区，则为 null。
• center 为管理该区的城镇，包含阿拉伯语名、英语名、纬度和经度。
• 区数据来源为伊拉克 2024 年人口普查；联邦伊拉克依据 COSIT 2024 年度统计摘要，库尔德斯坦地区依据 2024 年普查与 KRG 划分。
• Kifri、Khanaqin、Shekhan 在普查中被联邦和库尔德省重复统计，此处分别列入 Diyala 与 Nineveh；Akre 与 Bardarash 按 COSIT 列入 Duhok。
• 各省区数量：Baghdad 15，Basra 11，Nineveh 9，Anbar 12，Salah al-Din 11，Kirkuk 4，Diyala 8，Wasit 9，Babil 7，Karbala 6，Najaf 4，Al-Qadisiyyah 13，Muthanna 9，Dhi Qar 15，Maysan 7，Erbil 15，Sulaymaniyah 15，Duhok 7，Halabja 5。总计 182。
• 详细名称、阿拉伯语与库尔德语名、P-code、坐标见：https://github.com/karam-fikre/iraqi-data/blob/main/src/districts.json

子区级数据

• 共 434 个子区：252 个 نواحي，加上 182 个区中心（每个区一个中心）。
• 从 iraqi-data/subdistricts 导入；不导入则不携带其数据。
• 字段：id、districtId、governorateId、pcode、ar、en、ku、isCenter、center、aliases。
• center 在无可靠位置时为 null。
• 顺序与 districts 相同，每个区的中心排在最前。
• 库尔德语子区名称为草稿。

API

省份 API

• governorates: readonly Governorate[]
• getGovernorate(query: string): Governorate | undefined
• searchGovernorates(query: string): Governorate[]
• getGovernoratesByRegion(region: federal | kurdistan): Governorate[]

区 API

• districts: readonly District[]
• getDistrict(query: string): District | undefined
• searchDistricts(query: string, options?: { governorate?: string }): District[]
• getDistrictsByGovernorate(governorate: string): District[]
• getNearestDistrict(lat: number, lng: number, options?: { maxDistance?: number }): District | undefined
• getNearestGovernorate(lat: number, lng: number, options?: { maxDistance?: number }): Governorate | undefined

子区 API

• subdistricts: readonly Subdistrict[]
• getSubdistrict(query: string, options?: { district?: string }): Subdistrict | undefined
• searchSubdistricts(query: string, options?: { district?: string; governorate?: string }): Subdistrict[]
• getSubdistrictsByDistrict(district: string): Subdistrict[]
• getNearestSubdistrict(lat: number, lng: number, options?: { maxDistance?: number }): Subdistrict | undefined

规范化与搜索

• normalize(text: string): string
• 忽略：Hamza 形式 أ إ آ → ا；Taa marbuta 和 alef maqsura ة → ه，ى → ي；Tashkeel 和 tatweel；冠词 البصرة、Al-Basrah、As Sulaymaniyah；在阿拉伯键盘输入的库尔德字母；库尔德语两种 heh；大小写、空格、连字符。
• searchGovernorates、searchDistricts、searchSubdistricts 按包含匹配，排序为精确匹配优先，其次以查询开头，再次其他；空查询返回 []。
• getGovernorate、getDistrict、getSubdistrict 支持 id、ISO 代码、P-code、任意语言全名及别名；部分名称不匹配，需用搜索函数。
• 一个区名可找到其中心；某些子区名在多个区使用，需传 district 选择。

手机号 API

• parseMobile(input: string): MobileNumber | undefined
• isValidMobile(input: string): boolean
• carriers: Record<asiacell | zain | korek, { ar: string; en: string; ku: string }>
• parseMobile 返回 e164、local、international、carrier；carrier 为 asiacell、zain、korek 或 null。
• 接受格式：有或无前导 0；国家码 +964、00964、964、+964 0770...；空格、横线、点、括号；阿拉伯与库尔德数字；不可见方向标记。
• 固定电话等非移动号码返回 undefined。
• 存储 e164，显示 local。

数字与价格 API

• toLatinDigits(text: string): string：阿拉伯与库尔德数字转 0-9，阿拉伯小数点 ٫ 和千分位 ٬ 转 . 和 ,。
• toArabicDigits(text: string): string：0-9 转阿拉伯与库尔德文本使用的数字。
• formatIQD(amount: number, options?: { lang?: ar | ku | en }): string：格式化为伊拉克第纳尔价格，四舍五入到整数，逗号分隔千位，后缀 IQD；lang: ar 或 ku 时为 د.ع；NaN 或 Infinity 抛出 RangeError。

地址下拉与 GPS

• React 示例：使用 governorates 生成省下拉，使用 getDistrictsByGovernorate 生成所选省的区下拉。
• 存储 id（如 baghdad、abughraib），不存储显示名称；id 不变，名称拼写可能后续修正。
• getNearestDistrict、getNearestGovernorate、getNearestSubdistrict 可根据 GPS 坐标填充最近地点。
• 最近地点基于最近中心，不是实际行政边界；边界附近可能选到相邻地区；可传 maxDistance（公里）限制范围。
• 无 maxDistance 时，科威特城可返回 82 公里外的 Faw；纬度或经度非数字或越界时抛出 RangeError。

数据来源与注意事项

• 联邦伊拉克区数据来源：COSIT 2024 年度统计摘要，https://cosit.gov.iq/documents/AAS2024/01.pdf
• 库尔德斯坦地区区数据来源：2024 年人口普查与 KRG 划分。
• 坐标来源：OpenStreetMap，Kut 与 Diwaniyah 来自 Wikidata；坐标四舍五入到 4 位小数（约 11 米）。
• P-code：OCHA P-code；可能为 null。
• 坐标用于地图标记和距离，不作为精确地址；城市中心定义差异可达约 3 公里。
• Halabja 为第 19 个省，暂无 ISO 3166-2 代码。
• 库尔德语子区名称为草稿。
• 查找和搜索使用 normalize 处理拼写差异；存储稳定 id，避免依赖显示名称。

搜集汇总

数据集介绍

构建方式

立足伊拉克行政区划数字化与地址工程的实际需求，iraqi-data 以2024年人口普查及中央统计组织年度统计摘要为基准，将联邦伊拉克与库尔德斯坦地区的省、区、子区重构为层级化数据。每条记录包含稳定标识、ISO或OCHA P-code、阿拉伯语、英语与库尔德语名称、别名及中心坐标，坐标参考OpenStreetMap与Wikidata并保留合理精度；库尔德地区划分依照库尔德斯坦地区政府口径，子区数据按需单独发布，形成可校验、可追溯且便于长期维护的地址数据基础。

特点

面向多语言地址服务、移动表单与本地化应用场景，该数据集在语言覆盖和检索鲁棒性上表现突出。它同时提供阿拉伯语、英语和库尔德语（索拉尼）名称，并通过归一化处理哈姆扎、塔玛尔布塔、阿勒夫·马克苏拉、变音符号、定冠词及库尔德字母输入差异，使同一地名的多种拼写均可检索。内置的手机号解析可识别多种输入形式并返回E.164、本地格式、国际格式及运营商；数字转换与第纳尔格式化适配阿拉伯语键盘。包体轻量、无外部依赖，含TypeScript类型，并支持Node、浏览器、React、React Native/Expo与Vue。

使用方法

在应用集成层面，开发者可通过npm或yarn安装后，从主包导入governorates、getGovernorate、searchGovernorates及区级查询函数，构建省、区级联地址表单；子区数据从iraqi-data/subdistricts按需引入，以控制体积。移动端可调用getNearestDistrict或getNearestGovernorate依据GPS回填地址，同时允许用户修正边界误差。手机号字段宜用parseMobile或isValidMobile校验，将e164存入数据库并以local展示；金额则用formatIQD并结合toLatinDigits与toArabicDigits处理本地数字。建议持久化稳定id，而非显示名称，以应对后续拼写修订。

背景与挑战

背景概述

面向伊拉克多语言行政地名基础设施的iraqi-data数据集，回应了地址系统在地名检索、表单填充与配送场景中的标准化需求。公开仓库由karam-fikre维护，创建时间未在README中明示；核心研究问题在于以稳定标识统一伊拉克19省、182个区与434个次区的阿拉伯语、英语和库尔德语名称，并处理拼写变体、手机号码解析、阿拉伯数字转换与第纳尔格式化。数据源吸纳COSIT 2024统计摘要、库尔德地区政府划分、OCHA P-code及OpenStreetMap与Wikidata坐标，为Node.js、浏览器、React、React Native和Vue应用提供无依赖且含TypeScript类型的轻量支持，对伊拉克电子政务、物流与地址填写具有标准化价值。

当前挑战

伊拉克行政区划的复杂性与多语言拼写变体，使iraqi-data在领域覆盖与数据构建层面承受多重压力。领域问题在于同一地名存在阿拉伯语、库尔德语、英语及多种拼写形态，如البصرة、البصره、Basrah与بەسرە，且2024年普查后新设区增多、Halabja于2025年成为第19省却暂无ISO代码，地址匹配和行政区划同步因此困难。构建过程需整合COSIT、KRG、OCHA与开放地理数据，对齐三语名称、P-code与别名，处理库尔德语名称草稿、坐标中心精度约3公里偏差及最近中心法边界误判；手机号需兼容多种输入格式与运营商识别，数字与货币格式也需适配阿拉伯语与库尔德语键盘。

常用场景

经典使用场景

在伊拉克多语言行政地名与本地化数字身份交织的应用背景下，iraqi-data 最经典的使用场景是为地址表单、下拉选择与配送应用提供权威且可搜索的省—区—次区层级数据。开发者可调用 governorates、getDistrictsByGovernorate 与 getSubdistrictsByDistrict 构建联动菜单，借助 normalize 兼容 البصرة、البصره、Basrah、بەسرە 等异形拼写，并以稳定 id 或 ISO 3166-2 码入库。其同时支持 Node.js、浏览器、React、React Native、Expo 与 Vue，并含 TypeScript 类型，使多语言地址采集与校验在联邦伊拉克及库尔德斯坦地区均可复现。

解决学术问题

面对多语言地名实体对齐、行政单元编码不一致与地址数据质量参差等常见学术问题，iraqi-data 以阿拉伯语、英语和库尔德语三语字段、别名表、OCHA P-code、ISO 3166-2 码及 2024 年人口普查口径，提供了可比较、可追溯的标准化样本。其 normalize 机制处理哈姆扎、台 marbuta、文章冠词、库尔德字母键盘映射与空白连字符差异，降低字符串匹配歧义；经纬度中心点亦支持最近行政区推断。该数据集为地理信息检索、跨语言实体链接、地址解析与本地化人机交互研究提供了可复用的基准资源。

衍生相关工作

围绕伊拉克行政区划数据产品与本地化开发工具链，iraqi-data 的公开数据与 API 设计支撑了一系列工程化衍生工作。基于其省、区、次区层级与稳定标识，开发者可构建地址自动补全、配送范围校验、行政区划可视化、GPS 逆地理编码与多语言地址管理模块；其手机号解析与数字转换能力常被封装为表单验证组件、CRM 数据清洗管道和电商结算插件。OCHA P-code、ISO 3166-2 与人口普查口径的引入，也使该数据集成为 GIS、人道主义响应和本地化研究二次开发的基础构件。