주소에서
지도로
여러 서비스가 함께 쓰는
한국 주소·지도 API, Mapmoro.
주소의 출처와 기준일을 보존하고, 고객 서버의 인증과 브라우저의 지도 접근을 분리합니다.
Pilot · 실데이터 승인 대기
지도를 준비하고 있습니다.
서버에서 시작하기
TypeScript서버 키는 고객 서비스의 서버에만 둡니다. 입력 주소는 URL 대신 요청 본문으로 전달합니다.
@mapmoro/server-sdk
import { MapmoroClient } from '@mapmoro/server-sdk';
const client = new MapmoroClient({
apiKey: process.env.MAPMORO_API_KEY,
baseURL: 'https://api.mapmoro.onmoro.com',
});
const result = await client.geocode(address, 5);Node 서버에서 실행하는 예제입니다.
API 레퍼런스
v1정확 조회와 범위가 제한된 검색을 제공합니다. 응답의 출처·데이터 버전과 일치 유형을 함께 확인하세요.
| 메서드 | 경로 | 역할 |
|---|---|---|
| POST | /v1/geocode | 주소 → 후보와 출입구 좌표 |
| GET | /v1/addresses/{id} | 주소 상세와 출처 |
| GET | /v1/roads/search | 지역 + 도로명 prefix 검색 |
| GET | /v1/regions | 법정동·행정동 계층 |
| GET | /v1/usage | 현재 앱의 사용량 |
| POST | /v1/map-sessions | 단기 지도 접근 서명 |
후보는 최대 20개입니다. 인증 실패 401 · 권한 부족 403 · 한도 초과 429 · 데이터 미준비 503.
지도는 짧은 세션으로
고객 서버
서버 API Key지도 세션
버전·만료 범위 제한브라우저
MapLibre + PMTiles
서버 API Key지도 세션
버전·만료 범위 제한브라우저
MapLibre + PMTiles
서버가 발급받은 단기 서명을 브라우저에 전달합니다. SDK는 스타일·sprite·glyph와 PMTiles의 Range 요청에 서명을 적용합니다. API 키를 폐기해도 기존 지도 세션은 만료 전까지 유효할 수 있습니다.
지도 세션 발급은 현재 비활성 상태입니다. 공개 playground는 제공하지 않습니다. 실제 지도 릴리스와 서버 연동 검증을 마친 뒤 활성화합니다.
서버 키 파일과 지도 릴리스를 설정한 로컬 개발 환경에서만 사용할 수 있습니다.
데이터가 말하는 범위까지
- 정부 주소 데이터
- 자료 제공 승인과 외부 API 활용 조건을 확인한 후 사용합니다. 현재 화면의 지도는 실제 주소 품질의 증거가 아닙니다.
- 배경지도
- OSM 기반 타일과 정부 주소 DB를 별도로 관리합니다. 실제 OSM·한글 glyph·sprite 릴리스 검증은 대기 중입니다.
- 이번 범위
- 전문검색, POI, 경로 탐색, 정밀 역지오코딩, 공개 회원가입과 결제는 후속 범위입니다.