feat: 지도 나침반(OSM/위성) 추가 + 측점 검색·마커 정확도 개선 + POI/영상 수정

- 지도 기반 나침반(노스업, 현재위치, 시야 역삼각형): 호버 확대·휠 줌·클릭 위성전환, OSM/Esri 타일 서버 프록시(/api/tile)
- 스테이션 검색: 실제 측점(chain) 기준 이동, 없으면 '측점 없음' 안내
- 역 마커: 직교 투영 측점 일치 시에만 표시, 미도착 종점은 추가 방식
- POI 팝업 겹침/재등장·라벨 정합 수정
- 영상 fps 데이터 기반 자동 산출
- 기술/발표/쉬운설명 문서 추가

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-02 18:03:30 +09:00
co-authored by Claude Opus 4.8
parent e9052143d7
commit e0ff5dd6d0
58 changed files with 9635 additions and 378 deletions
@@ -0,0 +1,39 @@
# 지도 POI → 영상 매핑 기술 — 초등학생용 쉬운 설명 작성
## 작업 내용
"지도상의 POI 좌표를 영상에 매핑한 기술들"을 실제 코드에서 모두 조사·나열하고, 초등학생 눈높이 + SVG 그림으로 설명하는 문서를 신규 작성.
### 1. 실제 구현 기술 조사
- [geoProjection.ts](../../client/src/utils/geoProjection.ts) 전체 정독 + [StationOverlay.tsx](../../client/src/components/overlay/StationOverlay.tsx)의 POI 처리부 분석
- 매핑 파이프라인을 구성하는 12개 기술 식별:
1. 좌표계 변환 (proj4, EPSG:4326→5186 한국 TM)
2. ENU 월드 3D 좌표 (East-North-Up)
3. 지오이드 높이 보정 (정표고↔타원체고, 대전≈25.8m)
4. 자세 회전 행렬 (yaw/pitch/roll → R_b2w/R_w2c)
5. 상대 위치 벡터 (대상−드론, offX/Y/Z)
6. 핀홀 카메라 원근투영 (Xc/Zc·f/sensor)
7. 화각(초점거리 24mm·센서 36×20.25)
8. 카메라 뒤 클리핑 (Zc<CLIP_Z)
9. POI 표고 추정 (최근접 중심선 nearestCL / 드론−24m)
10. 거리 필터 (수평거리 distH<MAX_RANGE 1000m, 앞/옆 fwd/side)
11. 역투영 보정 (worldFromPixel/solveZForPixelY/groundPointFromPixel + focal 역산)
12. object-fit:cover 정규좌표→화면 변환
### 2. 쉬운설명 문서 작성
- 신규 파일: [docs/쉬운설명_지도POI를_영상에_붙이는기술.md](../쉬운설명_지도POI를_영상에_붙이는기술.md)
- 기존 쉬운설명 문서 스타일 계승, SVG 삽화 14개 + 비유 중심 서술
- 기술 한눈에 보기 표 → 각 기술별 그림 상세 → 전체 요약 → 특허포인트 → 용어사전
### 3. HTML/PDF 변환
- `scripts/md2docs.sh`로 변환 완료 (PDF 137KB)
## 산출물
- `docs/쉬운설명_지도POI를_영상에_붙이는기술.md` (33KB)
- `docs/쉬운설명_지도POI를_영상에_붙이는기술.html` (41KB)
- `docs/쉬운설명_지도POI를_영상에_붙이는기술.pdf` (137KB)
---
**소요 시간**: 15분
**Context 사용량**: input 130k / output 18k tokens