프로젝트 소개

이 저장소는 국가, 주, 도시, 우편번호에 대한 포괄적이고 커뮤니티가 유지 관리하는 데이터셋을 제공합니다. JSON, MySQL, PostgreSQL, SQLite, SQL Server, MongoDB, XML, YAML, CSV, GeoJSON, TOON(LLM 최적화), Parquet의 12가지 형식으로 게시됩니다. 데이터에는 ISO2/ISO3 코드, 국가 코드, 수도, 자국어, 시간대(100% IANA 적용 범위), 19개 언어 번역이 포함됩니다. **데이터 규모:** - 6개 지역, 22개 하위 지역 - 250개 국가 - 5,299개 주/지역/지방자치단체 - 153,765개 도시/읍/구 - 844,248개 우편번호(125개국) - 427개 시간대 **사용 옵션:** - **REST API** (`api.countrystatecity.in`): 모든 언어로 데이터를 조회할 수 있으며, 프로토타입용 무료 티어와 프로덕션용 유료 티어가 있습니다. 공식 Python 클라이언트(`countrystatecity-api`) 제공. - **내보내기 도구** (`export.countrystatecity.in`): 브라우저에서 사용자 정의 필드 선택으로 맞춤형 데이터셋을 구축합니다. - **NPM 패키지**: `@countrystatecity/countries`, `-browser`, `-currencies`, `-timezones`, `-translations`, CLI 포함. - **PyPI 패키지**: 국가, 시간대, 통화, 번역, 전화 코드, 지역, 우편 코드에 대한 오프라인 스냅샷. - **직접 다운로드**: 각 GitHub 릴리스에서 gzip 압축 내보내기 제공. - **기타 플랫폼**: 데이터베이스 브라우저, 백과사전, 수정용 커뮤니티 관리자, CLI, Kaggle, Data.world. **기여 방법:** - 쉬운 수정을 위해 커뮤니티 관리자 웹 UI를 사용하거나 `contributions/` 디렉토리 아래의 JSON 파일을 직접 편집합니다. - 새 도시 필수 필드: name, state_id, state_code, country_id, country_code, latitude, longitude. 선택 사항: timezone, wikiDataId, native. - 자동 생성 디렉토리는 편집하지 마십시오. 각 릴리스에서 MySQL에서 재구축됩니다. **라이선스:** 오픈 데이터베이스 라이선스(ODbL v1.0). 상업적 사용, 수정, 재배포가 허용되며 출처 표시가 필요합니다. 파생물은 동일한 라이선스로 공유해야 합니다. **면책 조항:** 커뮤니티 유지 데이터에는 오류가 있거나 지정학적 변화를 따라가지 못할 수 있습니다. 중요한 데이터는 공식 출처로 검증하십시오.