egydata

提供了埃及的结构化地理和时区数据，包括省份、城市、区号和时区工具。

This dataset provides structured geographic and time zone data for Egypt, including provinces, cities, area codes, and time zone utilities.

原始信息汇总

Egydata 数据集概述

数据集基本信息

• 数据集名称：Egydata
• 主要用途：为 Node.js 和浏览器提供结构化的埃及地理和时区数据。
• 核心特性：提供完整的离线数据集，包含埃及省份、城市、固定电话和移动电话区号以及时区实用工具，且零依赖。

数据内容与覆盖范围

• 省份数据：涵盖埃及全部 27 个省份，提供阿拉伯语和英语名称。
• 城市数据：涵盖埃及所有省份的 389 个城市和地区。
• 电话区号数据：涵盖 30 个固定电话和移动电话区号。
• 时区数据：完全支持 Africa/Cairo 时区。

数据结构与访问方式

1. 省份数据

• 数据结构：{ id: number, code: string, name: string, nameEn: string }
• 访问方法：
  • getAll()：获取全部 27 个省份。
  • getByCode(code)：通过省份代码查找省份。
  • getById(id)：通过数字 ID 查找省份。
  • search(query)：通过阿拉伯语或英语名称搜索省份（支持部分匹配，不区分大小写）。

2. 城市数据

• 数据结构：{ id: number, name: string, nameEn: string, governorateCode: string }
• 访问方法：
  • getByGovernorate(govCode)：获取指定省份代码下的所有城市。
  • getById(id)：通过数字 ID 查找城市。
  • search(query)：通过阿拉伯语或英语名称搜索城市（支持部分匹配，不区分大小写）。

3. 电话区号数据

• 数据结构：{ code: string, region: string, regionEn: string }
• 访问方法：
  • getAll()：获取所有埃及固定电话和移动电话区号。
  • getRegion(code)：通过区号查找地区信息。
  • getCode(regionName)：通过地区名称（阿拉伯语或英语）查找区号条目。

4. 时区数据

• 属性与方法：
  • name：IANA 时区标识符，值为 Africa/Cairo。
  • offset：UTC 偏移量，值为 +02:00。
  • now()：获取埃及当前日期/时间（Date 对象）。
  • isDST(date?)：判断夏令时是否生效（可为指定日期判断）。

安装与使用

• 安装命令：npm install egydata
• 导入方式：
  • CommonJS：const { governorates, cities, phoneArea, timezone } = require("egydata");
  • ESM：import { governorates, cities, phoneArea, timezone } from "egydata";

许可证

• 许可证类型：MIT 许可证。

搜集汇总

数据集介绍

构建方式

在构建地理信息系统数据集时，结构化数据的准确性和完整性至关重要。Egydata数据集通过系统化整合埃及官方地理信息，收录了27个省份、389个城市及地区，以及30个固定电话和移动电话区号。该数据集采用模块化设计，将数据划分为省份、城市、电话区号和时区四个独立模块，每个模块均提供双语支持（阿拉伯语和英语），并确保数据来源的权威性。构建过程中注重数据的一致性验证，确保所有条目均符合埃及实际行政划分标准，从而为开发者提供可靠的地理数据基础。

特点

Egydata数据集的特点体现在其全面性和实用性上。数据集覆盖埃及全境的地理行政单元，包括省份代码、城市分布及电话区号映射关系，并集成时区信息。所有数据条目均经过精心组织，支持双向搜索功能，用户可通过阿拉伯语或英语进行模糊查询。数据集采用零依赖设计，适用于Node.js和浏览器环境，提供离线访问能力。其API设计简洁直观，每个模块均配备完整的CRUD操作方法，便于快速集成到各类应用程序中。

使用方法

使用Egydata数据集时，开发者可通过npm包管理器轻松安装，并利用ESM或CommonJS模块系统导入数据模块。数据集提供四种核心功能模块：省份模块支持按代码、ID或名称搜索省份信息；城市模块允许根据省份代码获取所属城市列表；电话区号模块可实现区号与地区的双向查询；时区模块则提供埃及当前时间及夏令时状态判断。所有API方法均返回结构化JSON数据，开发者可直接将这些数据应用于地址验证、区域分析或时区转换等实际场景中。

背景与挑战

背景概述

在数字化与全球化浪潮中，地理信息系统与区域数据标准化成为支撑各类应用开发的基础。Egydata数据集由开发者Ahmed Ashraf创建，旨在为埃及的地理与行政信息提供结构化、离线可用的资源。该数据集涵盖了埃及27个省份、389个城市及地区、30个固话与移动区号，并整合了时区工具，为Node.js及浏览器环境下的埃及相关应用开发提供了便捷的数据支持。其核心研究问题在于解决埃及地理数据在软件开发中的碎片化与获取不便问题，通过提供零依赖的标准化数据包，显著提升了开发效率，并在区域信息化建设中发挥了积极作用。

当前挑战

Egydata数据集所解决的领域问题在于为埃及地理与行政信息管理提供标准化数据源，其挑战包括确保数据的准确性与时效性，例如行政区划变更或区号调整需及时更新，以避免信息滞后。在构建过程中，挑战涉及数据收集与整合的复杂性，需从多源异构信息中提取并验证埃及各省市、区号的官方名称与对应关系，同时处理阿拉伯语与英语的双语标注，以保证数据的一致性与完整性。此外，时区规则如夏令时的变动也需持续跟踪，以维持工具的实用性。

常用场景

经典使用场景

在区域信息学与地理信息系统研究中，Egydata数据集常被用于构建埃及行政区划的标准化数据模型。该数据集整合了埃及27个省份、389个城市及区县的阿拉伯语与英语名称，辅以电话区号和时区信息，为开发者提供了一个结构化的地理数据源。经典使用场景包括在Web应用或移动端服务中，快速实现基于地理位置的下拉菜单、地址自动填充功能，或用于数据分析中的区域分类与聚合，有效支撑了涉及埃及地域的数字化项目开发。

解决学术问题

该数据集解决了地理信息科学中区域数据标准化与可访问性的关键问题。在学术研究中，学者常面临埃及行政区划数据分散、格式不统一或语言障碍的挑战，Egydata通过提供离线、结构化的多语言数据集，简化了地域关联分析、人口统计建模及跨文化比较研究的数据预处理流程。其意义在于促进了中东地区地理信息研究的可重复性与准确性，为区域发展、城市规划等跨学科课题提供了可靠的数据基础。

衍生相关工作

围绕Egydata数据集，衍生了一系列经典的技术工作与开源项目。例如，开发者基于其省份与城市数据构建了埃及专用的地图可视化库，增强了地理数据的交互展示能力；另有研究将其与人口普查数据结合，开发了区域社会经济指标分析工具。在开源生态中，该数据集常被用作测试基准，用于验证多语言地理信息检索算法的性能，推动了相关领域工具链的完善与创新。