# 2026-07-14 POI 원거리 밀림 — 지면고도 z 우선순위 교정

**소요 시간**: 7분
**Context 사용량**: input 3490k / output 3k tokens

## 문제 (제보)

POI 가 멀리 있을 때는 계속 밀리다가 화면 하단(근거리)에서는 잘 맞음.

## 원인 — 높이(표고) 오차의 전형적 시그니처

근거리는 위치(djmd 프레임 동기, 정확)가 지배해 맞고, 원거리는 각도·높이 오차가 증폭됨.
코드상 지면고도(gz)가 **POI 자체 실측 z 보다 '최근접 중심선(도로) 높이 스냅'을 우선** —
회덕(철도, POI z 미보유) 시절의 규칙이 남아, 도로에서 떨어진 지물(마을회관·산 등)이
도로 높이로 붙어 원거리에서 수 m 높이 오차 → 접근하며 서서히 제자리로 미끄러지는 증상.

## 수정 — StationOverlay.tsx

- gz 우선순위 교정: 보정값(드래그) → **POI 자체 z(실측)** → 중심선 z → 경로표고 앵커
- 편집 모드 초기 표고(baseZ/groundZ)도 동일 규칙으로 통일
- z 없는 데이터셋은 기존 폴백 그대로(무영향)

## 잔여 안내

- 수정 후에도 '모든' POI 가 원거리에서 같은 방향으로 균일하게 밀리면 = 짐벌 피치 바이어스
  (로그가 정수 -15 로 고정 기록) → 카메라 파라미터 Pitch± 를 ±0.5° 내에서 미세 조정
- 드론높이 모드 사용 중이면 지면고도 모드(OFF) 권장 — 평면 근사가 원거리 오차의 또 다른 원인

## 검증

- tsc+vite 빌드 통과, 새 번들(index-BiwO87gk.js) 서빙
