Developer guide

빠른 시작

부모 서비스가 도형을 보내고, 사용자가 편집한 결과를 돌려받는 팝업 지도 편집기입니다. 별도 SDK 설치 없이 postMessage로 연결합니다.

연동 전에 알아둘 세 가지

입력과 출력은 EditorSceneInput v2입니다. GeoJSON FeatureCollection을 그대로 보내지 않고 version + features로 감쌉니다.
일반 편집은 비로그인으로 사용할 수 있습니다. 경계 데이터를 선택할 때만 에디터가 Google 로그인을 요청합니다.
에디터는 부모 서버에 저장하지 않습니다. 부모가 완료 결과를 검증한 뒤 지도·폼에 반영하고, 필요하면 자신의 API로 저장합니다.

로컬에서 실행

Node.js 22 이상과 npm이 필요합니다. 저장소를 받은 뒤 프로젝트 루트에서 실행하세요.

터미널

1npm ci2npm run dev -- --port 4174

http://localhost:4174/demo에서 ‘편집기 새 창으로 열기’를 누르면 부모 지도 → 새 창 편집 → 저장 후 지도 갱신을 확인할 수 있습니다. 다시 열면 직전 저장본으로 편집합니다. 경계 조회를 제외한 편집·문서는 Supabase 설정 없이도 동작합니다.

에디터 주소만 직접 열었다면

부모 창이 없으므로 데이터를 기다리는 화면이 표시됩니다. 데모에서 열거나 부모 서비스에서 INIT을 전달하세요.

필요한 문서로 이동

개발자 문서 안내
하려는 작업	문서	확인할 내용
서비스에 편집기 연결	부모 창 연동	입력 형식, 메시지 검증, 실행 가능한 예제
경계 조회·배포 설정	경계 데이터·인증	로그인 시점, 공개 설정, callback, 접근 제한
기능 범위·QA 확인	편집 동작	선택·그리기·연산, 저장 조건, 단축키