사이 — 두 장소 사이의 거리
출발지와 도착지를 Nominatim으로 검색하고, 사용자가 선택한 두 좌표의 직선거리를 계산하는 한국어 반응형 웹앱입니다. 도로/도보 거리가 아닙니다. 지도에서 보기는 선택한 좌표를 OpenStreetMap 길찾기에 전달하며, 그 지도에 표시되는 이동거리와 앱의 직선거리는 다릅니다.
실행
Node.js 22 이상에서 별도 패키지 설치 없이 실행합니다.
npm run dev
# http://localhost:3000
npm test
npm run build
환경변수, Redis, API 키, 데이터베이스, 서버 함수가 필요하지 않습니다. 빌드 결과는 dist/입니다. 검색은 브라우저에서 외부 HTTPS API로 이루어지므로 인터넷 연결이 필요합니다. 외부 폰트에 접속하지 못하면 시스템 글꼴로 표시됩니다.
GitHub → Vercel
- 이
distance-app 폴더의 내용만 새 GitHub 저장소의 루트에 올리는 것을 권장합니다. 기존 QR 앱과 node_modules, dist, release는 올리지 마세요.
- Vercel에서 Add New → Project → Import Git Repository를 선택합니다.
- Framework Preset: Other, Build Command:
npm run build, Output Directory: dist로 설정합니다. vercel.json에도 설정되어 있습니다.
- 환경변수는 추가하지 않고 Deploy합니다.
- 기존 QR 프로젝트 전체를 올렸다면 Vercel의 **Root Directory를
distance-app**으로 지정합니다.
검색 방식과 공용 API 제한
배포 전에 반드시 Nominatim 공용 서버 이용정책을 확인하세요. 사용자가 지정한 Nominatim 공용 서버는 소규모 사용을 위한 서비스이며, 앱 전체 사용자를 합쳐 최대 초당 1회가 적용됩니다. 자동완성·대량 검색은 허용되지 않습니다. 서비스 제공이 중단되거나 제한될 수 있습니다.
이 앱은 검색 버튼/Enter로만 조회합니다. 브라우저 내 요청을 직렬화하고 최소 1.1초 간격을 적용하며, 검색 결과를 최대 80개·24시간 브라우저에 캐시합니다. 주소를 포함한 검색어가 Nominatim으로 전송되므로 개인정보나 민감한 정보를 입력하지 마세요. 브라우저 캐시는 해당 기기의 사이트 데이터 삭제로 지울 수 있습니다. OSM 저작자 표시와 정책 링크를 화면에 포함했습니다. HTTP Referer로 배포 출처를 전달하므로 Referer를 제거하는 프록시/브라우저 설정에서는 사용하지 마세요.
별도 공유 저장소가 없는 정적 앱은 여러 사용자·탭의 총 요청량을 전역으로 제한할 수 없습니다. 이 구성은 소규모 개인 사용에 맞습니다. 방문자가 늘어나는 공개 서비스에서는 공용 서버를 그대로 사용하지 말고, 자체 호스팅 또는 이용량을 허용하는 Nominatim 호환 서버로 전환해야 합니다. Redis 없이도 앱은 실행되지만, 이것이 공용 서버의 전역 요청 한도를 보장한다는 뜻은 아닙니다.
검색 서버는 /config.json의 searchEndpoint에서 읽습니다. 실행 중인 앱은 새로고침 시 설정을 다시 읽으므로 앱 JS 수정 없이 설정 파일만 교체할 수 있습니다. 대체 서버는 jsonv2 검색 API, 브라우저 CORS, HTTPS를 지원해야 합니다. Vercel 정적 파일 교체에는 재배포가 필요합니다.
검색 결과는 OpenStreetMap에 등록된 장소이며 모든 실제 장소를 포함하거나 최신 상태를 보장하지 않습니다. 정확한 주소와 지역명을 함께 입력하고 결과를 확인하세요.
검증
npm test는 알려진 지점 사이의 거리, 동일 지점, 지구 반대편 좌표, 지도 URL 및 잘못된 API 데이터 처리를 확인합니다. 배포 후에는 실제 장소 두 곳 검색 → 결과 선택 → 거리 확인 → 지도 링크 순서로 확인하세요.
장소 데이터 © OpenStreetMap contributors, ODbL. Nominatim Search API 문서.
