RealMap Collection

• 리얼맵을 사용하기 위해 필요한 지도 데이터를 모아놓은 컬렉션입니다.

Release Note

v1.1.1

loadMap API 지원 중단 (deprecated)

loadMap 은 번들 크기 문제로 지원이 중단되었습니다. 다음 major 버전에서 제거됩니다.

이 함수는 내부에 모든 지도의 동적 import 를 담고 있어서, 번들러가 실제로 사용하는 지도를 가려낼 수 없습니다. 지도를 하나만 사용해도 전체 지도가 청크로 생성됩니다. (지도 1개만 쓰는 Vite 앱 기준 산출물 35MB, 빌드 중 메모리 부족으로 실패하는 경우도 있습니다)

지도 파일을 직접 import 하는 방식으로 바꿔 주세요. 동작은 같습니다.

// 지금까지 (deprecated)
import { loadMap, MapNamesEnum } from 'realmap-collection';
const krSido = await loadMap(MapNamesEnum['2026-07/kr-sido-low']);

// 필요한 시점에 불러오기 — loadMap 과 동일하게 동작합니다
const krSido = await import('realmap-collection/2026-07/kr-sido-low.geo.json')
    .then((m) => m.default);

// 앱이 시작할 때 함께 불러오기
import krSido from 'realmap-collection/2026-07/kr-sido-low.geo.json';

TopoJSON 은 확장자를 .topo.json 으로 바꾸면 됩니다.

const krSido = await import('realmap-collection/2026-07/kr-sido-low.topo.json')
    .then((m) => m.default);

기존 코드는 계속 동작하며, 이번 버전에서 바뀐 동작은 없습니다. 편집기에서 loadMap 에 지원 중단 표시가 나타납니다.

v1.1.0

전남광주통합특별시 반영 (2026-07 지도 추가)

2026년 7월 광주광역시와 전라남도가 전남광주통합특별시로 통합되어, 이를 반영한 시도·시군구 지도를 개편 시점 경로 2026-07/ 로 추가했습니다.

• 기존 지도 는 통합 전(광주·전남 분리) 상태로 변경 없이 유지됩니다. 지금까지 쓰던 경로를 그대로 사용하면 됩니다.
• 통합이 반영된 지도 는 경로에 개편 시점 2026-07/ 을 붙여 사용합니다. (앞으로의 행정구역 개편도 해당 시점 YYYY-MM/ 경로로 제공됩니다)

// 기존 지도 (광주·전남 분리)
https://unpkg.com/realmap-collection/kr-sido-low.geo.json

// 통합 반영 지도
https://unpkg.com/realmap-collection/2026-07/kr-sido-low.geo.json

npm 모듈로 불러올 때도 동일하게 경로에 2026-07/ 을 붙입니다.

import krSido from 'realmap-collection/2026-07/kr-sido-low.geo.json';

loadMap API로도 불러올 수 있습니다. 개편 시점 지도는 URL·import 경로와 동일한 형태의 이름을 사용합니다.

import { loadMap, MapNamesEnum } from 'realmap-collection';

// 기존 지도 (광주·전남 분리)
const krSido = await loadMap(MapNamesEnum.krSidoLow);

// 통합 반영 지도
const krSido202607 = await loadMap(MapNamesEnum['2026-07/kr-sido-low']);

⚠️ 통합 지도는 행정구역 코드(id)가 변경되었습니다. 지역을 id로 연동하는 경우, 기존 지도와 매핑이 다르므로 주의하세요.

• 시도: 광주(24) · 전남(36) → 전남광주통합특별시(12)

• 시군구: 소속 27개 시군구 코드가 12xxx 로 재부여 (예: 목포시 36010 → 12010)

• 인천광역시의 변경된 행정구역은 추후 반영 예정입니다.

API 추가

• listMaps() — 사용 가능한 모든 지도 이름을 배열로 반환합니다.
• createSubMap() — 지도에서 일부 지역만 골라 부분 지도를 만듭니다. rm-id 또는 지역 이름으로 지정합니다.

import { loadMap, MapNamesEnum, createSubMap } from 'realmap-collection';

const map = await loadMap(MapNamesEnum.krSigunLow);
const areas = createSubMap({ map, targets: ['강릉시', '목포시'], mode: 'include' });

v1.0.16

지도 추가

• 러시아, 우크라이나의 최상위 행정구역 지도가 추가되었습니다.

v1.0.15

한반도 지도

• mapBorders, excludeInternal등의 경계 관련 옵션이 해당 지도에서 적용되지 않던 문제 수정

v1.0.14

시군구 지도

• 더미지역이 나오지 않는 문제 수정

v1.0.13

한반도 지도

• 더미 지역으로 러시아 지역 추가
• 기존 더미 지역 크기 축소

v1.0.12

한반도 지도

• 더미 지역으로 중국, 일본 지역 추가.

v1.0.11

오류 수정

• 새만금 방조제가 특정 지도에서 정상적으로 그려지지 않는 문제 수정

v1.0.10

오류 수정

• 시도, 시군구 북한 접경선에 있던 빈틈(Sliver) 제거.

v1.0.9

오류 수정

• loadMap 관련 타입 오류 수정

v1.0.8

오류 수정

• cdn으로 지도데이터를 가져올 수 없는 문제 수정

v1.0.7

지도 데이터를 가져오는 API가 추가되었습니다.

import { loadMap, MapNamesEnum } from 'realmap-collection';

const map = await loadMap(MapNamesEnum.krDongLow, 'geojson');

• 위와 같이 loadMap을 통해 필요한 지도데이터를 ES 모듈로 로드할 수 있습니다.

v1.0.6

세계지도

• 지역 중앙 좌표 및 줌인 관련 속성이 추가되었습니다.

v1.0.5

일본 지도

• 지도 파일의 용량을 최적화했습니다.

v1.0.4

대륙별 지도

• 지도 파일의 용량을 최적화했습니다.
• 2.41MB -> 245KB

v1.0.3

대륙별 지도

• 남아메리카 대륙 경계의 오류가 수정되었습니다.

v1.0.2

새로운 지도가 추가되었습니다.

• 미국, 일본, 중국 ADM1 지도
• 한반도 지도
• 시도, 시군구, 읍면동 지도
• 대륙별, 국가별 세계지도