가이드
지역 아이디(Region ID)
개요

지역 아이디(Region ID)

RealMap이 제공하는 지도는 지역마다 rm-id 속성을 갖는다. 맵 시리즈는 이 값으로 데이터와 지역을 연결하므로, 데이터를 지도에 얹으려면 먼저 이 값을 알아야 한다. 아래 표에서 지도를 골라 지역 이름으로 검색하면 된다.

// 데이터의 id가 지도의 rm-id와 같으면 옵션 없이 연결된다.
const data = [{ id: '11', value: 100 }]; // 11 = 서울특별시 (kr-sido)
 
// 데이터 쪽 필드 이름이 다르면 idField로 지정한다.
const series = { idField: 'code' };
 
// 지도 쪽도 rm-id가 아닌 다른 속성으로 붙이려면 mapKeys를 쓴다.
const series2 = { mapKeys: ['b-code', 'code'] };

해상도(high·mid·low)와 포맷(geo.json·topo.json)이 달라도 아이디 체계는 같다. 해상도는 폴리곤의 세밀함만 다르고, 포맷은 같은 속성을 다른 방식으로 담을 뿐이다.

지도이름지역 수행정구역 개편분
국가별 세계지도world256
대륙별 세계지도continent7
대한민국 시도kr-sido172026-07
대한민국 시군구kr-sigun2532026-07
대한민국 읍면동kr-dong3,558
한반도korea31
미국 주usa-state51
일본 도도부현japan-adm147
중국 성·자치구china-adm131
러시아 연방주체russia-adm186
우크라이나 주ukraine-adm125

행정구역 개편분이 있는 지도는 판마다 아이디가 다르다. 자세한 것은 지도(Map)를 참고한다.

지도 기준일: 2026-08-20