애플리케이션에 국제화(I18N) 기능을 추가하고자 하는 개발자라면, ISO-3166 국가 코드 데이터셋은 매우 유용한 도구입니다. 이 데이터셋은 모든 국가의 표준 코드 정보를 제공하며, JSON, XML, CSV 등의 다양한 형식으로 준비되어 있습니다.

데이터셋 링크: ISO-3166-Countries-with-Regional-Codes

국가 코드 데이터셋의 필요성

국제화된 애플리케이션을 개발할 때, 각 국가와 지역을 표준화된 방식으로 처리하는 것이 중요합니다. ISO-3166 데이터셋은 공개된 자료에서 추출한 정보를 바탕으로, 다음과 같은 특징을 제공합니다:

• 표준 준수: ISO 3166-1 국제 표준 기반
• 포괄적인 데이터: 전 세계 249개 국가 및 지역 포함
• 다양한 형식 지원: JSON, XML, CSV 파일 제공
• 즉시 사용 가능: 별도의 가공 없이 바로 프로젝트에 통합 가능

데이터셋 구성 요소

전체 버전 - all/

세부 지리 정보까지 포함된 완전한 데이터셋으로, 아래 항목들을 제공합니다:

• 국가 이름 (영문)
• 두 글자 알파벳 코드 (예: KR)
• 세 글자 알파벳 코드 (예: KOR)
• 숫자 코드
• 지역, 하위 지역, 중간 지역 코드

간소화된 버전 - slim-2/ 및 slim-3/

slim-2 버전: 국가 이름 + 두 글자 코드 + 숫자 코드 slim-3 버전: 국가 이름 + 세 글자 코드 + 숫자 코드

데이터 형식 예시

JSON 형식

[
    {
        "country": "대한민국",
        "shortCode": "KR",
        "longCode": "KOR",
        "numericCode": "410",
        "continent": "Asia",
        "subRegion": "Eastern Asia"
    }
]

실제 적용 사례

• 프론트엔드: 국가 선택기, 주소 입력 폼 구현
• 백엔드: 사용자 위치 분석, 데이터 통계 처리
• 데이터 분석: 지리적 정보 처리 및 리포트 생성

데이터셋 활용 방법

방법 1: 직접 다운로드

프로젝트 디렉토리에서 필요한 버전을 선택하여 다운로드하세요:

• all/all.json: 전체 지리 데이터
• slim-2/slim-2.json: 두 글자 코드 간소화 버전
• slim-3/slim-3.json: 세 글자 코드 간소화 버전

방법 2: 최신 데이터 자동 생성

scrubber.rb 스크립트를 통해 최신 데이터를 쉽게 생성할 수 있습니다.

bundle exec ruby scrubber.rb

데이터 품질 보증

• 신뢰성 있는 출처: UN M49 표준 및 ISO 3166-1 최신 데이터
• 최신 업데이트 확인: LAST_UPDATED.txt 파일 참조

개발자 팁

• 요구 사항에 맞는 적절한 버전 선택
• 정기적으로 데이터셋 업데이트 수행
• 배포 전 데이터 검증 필수

이 데이터셋은 국가별 정보 수집 및 정리 시간을 크게 절약해 줍니다. 전자상거래 플랫폼, 소셜 애플리케이션, 기업 관리 시스템 등 다양한 분야에서 국제화를 지원하는 데 유용합니다.

지금 바로 활용해보세요!