globe 국가 정보 (국기, 수도, 인구) star

데이터가 만들어지는 방식

국가 데이터는 실시간 API로 구축하려고 시도하기 전까지는 이미 해결된 문제처럼 보입니다. 한때 널리 쓰이던 restcountries.com REST 서비스(v2, 이후 v3.1)는 시간이 지나며 불안정해지고 요청 제한이 걸리기 시작해, 이에 의존하던 수많은 프로젝트를 무너뜨렸습니다. 이 도구는 그러한 불안정함을 피하기 위해, GitHub에서 관리되는 약 130KB 크기의 단일 JSON 파일인 오픈 데이터셋 mledoze/countries를 사용합니다. 이 파일에는 모든 국가의 공식 명칭과 현지어 명칭, 번역, 수도, 통화, 국제전화 국가번호, 인접 국가 정보가 담겨 있으며, 요청 제한이 있는 API 엔드포인트가 아니라 jsDelivr CDN을 통해 제공됩니다. 정적 파일이 엣지에 캐시되어 있으므로 조회는 즉시 이루어지고 서비스가 멈추는 일이 없습니다.

실제로 계속 최신 상태를 유지해야 하는 값은 인구 하나뿐이므로, 이 값은 세계은행의 SP.POP.TOTL 지표 — 모든 국가가 매년 세계은행에 보고하는 표준 "총인구" 시리즈 — 에서 별도로 가져옵니다. 요청에는 mrnev=1("가장 최근의 비어 있지 않은 값")이 지정되어 있어, 보고가 느린 국가라도 몇 년씩 지난 고정 연도가 아니라 항상 해당 국가가 실제로 발표한 가장 최근 수치를 받게 됩니다. 국기는 페이지 자체를 가볍게 유지하기 위해 이미지로 번들되지 않고, 필요할 때 flagcdn.com에서 SVG(어떤 크기에서도 선명함) 또는 PNG로 불러옵니다.

이 두 가지 출처를 함께 쓰는 설계는 의도적입니다: 수도, 공용어, 국제전화 국가번호처럼 거의 변하지 않는 사실은 GitHub에서 기여자들이 버전을 관리하고 검토하는 데이터셋에서 가져오고, 해마다 실제로 변하는 유일한 숫자는 이를 전문적으로 추적하는 기관에서 매번 새로 가져옵니다. 데이터 대부분이 안정적이고 아주 일부만 최신 상태를 유지해야 할 때 정적 데이터셋과 실시간 지표를 이렇게 함께 쓰는 방식은 흔한 패턴입니다 — 누군가 페이지를 열 때마다 전 세계 데이터를 통째로 다시 가져오는 일을 피하면서도, 사람들이 가장 신경 쓰는 숫자는 합리적인 수준으로 최신 상태를 유지합니다.

알아두면 좋은 점

• 왜 restcountries.com을 직접 쓰지 않나요? 이 API는 호환성이 깨지는 버전 변경과 다운타임, 접근 제한을 여러 차례 겪었습니다. 버전 관리되는 정적 데이터셋을 쓰면 수도와 같은 기본적인 사실을 위해 제3자의 가동 시간에 의존하지 않아도 됩니다.
• 인구는 실시간이 아닙니다. 세계은행은 각국 통계청이 자체 일정에 따라 보고하는 자료를 취합하며, 보통 1~2년의 시차가 있습니다. "가장 최근의 비어 있지 않은 값"이란 그저 해당 국가가 실제로 발표한 가장 최근 연도를 의미합니다.
• 번역도 같은 데이터셋에서 나옵니다. 현지어 이름과 번역된 국가명은 mledoze/countries에 함께 들어 있어, "Almanya"와 "Germany" 둘 다 검색해도 같은 레코드로 이어지는 이유입니다.
• 국기는 기본적으로 벡터입니다. flagcdn.com의 SVG 국기는 확대하거나 인쇄해도 선명함을 유지합니다. PNG는 SVG를 잘 처리하지 못하는 도구를 위한 대체 옵션으로 제공됩니다.
• 인구밀도는 저장된 값이 아니라 계산된 값입니다. 인구를 면적으로 나누는 계산은 조회 시점에 브라우저에서 이루어지므로, 데이터셋에 박제된 고정값이 아니라 방금 가져온 그 해의 인구 수치를 항상 반영합니다.