RealMap Collection

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

Release Note

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 지도
• 한반도 지도
• 시도, 시군구, 읍면동 지도
• 대륙별, 국가별 세계지도