로컬 Exif 지리 지도 📍

강력하고 프라이버시 중심의 브라우저 기반 도구로, 사진에서 GPS 데이터를 시각화하고 분석할 수 있습니다. 이미지를 드래그 앤 드롭하여 대화형 지도, 히트맵, 고도 프로필 및 여행 통계를 생성하세요.

이유?

저는 항상 제 사진을 분석하고 지도로 만들 수 있는 자체 호스팅 도구를 원했습니다. 그러다 크로아티아 휴가를 갔는데, 바람이 제 해먹을 치명적인 적으로 삼기로 결정했습니다. 새벽 2시, 잠도 못 자고 약간 바람에 지친 채 해변으로 물러나 완전히 미친 사람처럼 휴대폰으로 이 앱의 전체 코어를 코딩했습니다.

여전히 아름다운 재앙입니다—바닷바람, 불면증, 그리고 의심스러운 인생 선택으로 구동됩니다. 하지만 놀랍게도 대부분은 실제로 작동합니다.

바이에른어(제가 직접 고통스럽게 번역했습니다. 제가 그 특정 종류의 이상한 사람이기 때문입니다)를 제외한 모든 번역은 AI, 주로 EuroLLM과 Claude가 처리했습니다. 따라서 독일어가 뇌졸중을 겪는 로봇처럼 읽힌다면 그 이유를 알 수 있습니다.

📸 스크린샷

대화형 지도	다크 모드	고도 프로필	Overpass 가져오기

✨ 기능

📷 이미지 분석

• 드래그 앤 드롭 업로드: 사진을 사이드바에 드롭하여 GPS 데이터 추출
• EXIF GPS 추출: 이미지 메타데이터에서 GPS 좌표, 타임스탬프, 고도를 자동으로 읽음
• 고아 사진 동기화: 새로운! GPS 데이터가 없는 사진은 업로드된 GPX 트랙의 타임스탬프와 일치하면 자동으로 지도에 배치됨 (테스트 필요)
• 일괄 처리: 수천 장의 이미지 처리 가능 (최대 50,000장 이상 테스트 완료)
• 진행 상황 추적: 이미지 처리 중 실시간 진행률 표시줄

대화형 매핑

• 12개 이상의 지도 스타일: OpenStreetMap, Esri Satellite/Terrain, CartoDB (light/dark/voyager), OpenTopoMap, OPNV (transport), OpenRailwayMap 등
• 트랙 사용자 지정:
  • 선 스타일: 실선, 점선, 또는 점선
  • 시각적 요소: 조정 가능한 선 색상, 두께, 투명도
• 트랙 포인트:
  • 마커: 사용자 지정 모양 (원, 사각형, 별 등), 색상, 크기 및 테두리
  • 타임스탬프: 모든 포인트에 영구 타임스탬프 레이블 표시 전환
  • 방향 화살표: 조정 가능한 크기/간격으로 이동 방향 시각화
• 자동 추적: "팔로우 모드"가 재생 중 지도를 현재 위치에 중앙 정렬

📍 관심 지점 및 OpenStreetMap 데이터

• POI 편집기: 지도에서 아무 곳이나 클릭하여 이름과 설명이 있는 사용자 지정 웨이포인트 추가
• OpenStreetMap 데이터: Overpass API에서 가까운 POI 직접 로드 ("서버 사용 중" 처리 포함):
  • 관광: 전망대, 박물관, 호텔, 호스텔, 정보 센터, 명소
  • 음식 및 음료: 레스토랑, 카페, 패스트푸드, 바, 펍, 비어가르텐
  • 물: 식수, 샘
  • 봉우리: 산봉우리 (미터 단위 고도 포함)
  • 역사: 성, 유적지, 기념물, 기념비, 고고학 유적지
  • 자연: 캠핑, 오두막, 자연 보호 구역 (NSG), 경관 보호 구역 (LSG), 조류 보호 구역 (VSG), FFH 지역
  • 교통: 버스 정류장, 기차역
• 정보 상자: POI를 클릭하여 세부 정보 확인:
  • 이름 및 유형
  • 고도 (가능한 경우)
  • 웹사이트 링크
  • 위키피디아 링크 (자동 감지된 언어)

🔥 히트맵

• 밀도 시각화: 가장 많은 시간을 보낸 위치 확인
• 5가지 색상 구성표: Fire, Cool, Earth, Marine, Twilight
• 조정 가능한 매개변수: 강도, 반경, 블러, 투명도

📈 고도 프로필

• 대화형 차트: 차트를 클릭하면 지도에서 위치가 강조 표시되고 정확한 통계 확인
• 확대/축소 및 이동: Chart.js 기반 대화형 고도 그래프
• 통계: 전체 고도 상승/하강, 최소/최대 고도
• 반응형: "고도 프로필로 이동" 링크 및 상세 분석을 위한 확장 가능한 사이드바

▶️ 애니메이션

• 재생 제어: 시간 경과에 따른 여정 재생/일시 중지
• 조정 가능한 속도: 0.5배 ~ 5배 재생 속도
• 팔로우 모드: 카메라가 현재 위치를 자동으로 따라감
• 트레일 효과: 재생 중 경로 히스토리 시각화

📊 통계

• 총 거리: 계산된 트랙 길이 (km)
• 지속 시간: 첫 번째 사진부터 마지막 사진까지의 시간 범위
• 평균 속도: 이동 속도 계산
• 포인트 수: 이미지 및 트랙의 GPS 포인트 수

📅 타임라인

• 시간순 보기: 시간 순서대로 정렬된 모든 트랙 포인트 확인
• 위치로 이동: 타임라인 항목을 클릭하여 지도에서 탐색

💾 내보내기 옵션

• PNG 내보내기: 현재 지도 보기를 고품질 PNG 이미지로 한 번 클릭 다운로드 (모든 활성 레이어, 히트맵, 마커 포함)
• GPX 내보내기: 분석된 사진 트랙을 Strava, Garmin, Komoot, Google Earth와 호환되는 표준 GPX 파일로 내보내기
• 백업: 큐레이팅된 지도 데이터를 저장하여 나중에 사용

🌐 다국어 지원

11개 언어 지원:

• 🇬🇧 영어
• 🇩🇪 독일어
• 🇮🇹 이탈리아어
• 🇭🇷 크로아티아어
• 🇵🇱 폴란드어
• 🇪🇸 스페인어
• 🇺🇦 우크라이나어
• 🇳🇱 네덜란드어
• 🇸🇪 스웨덴어
• 🇳🇴 노르웨이어
• 바이에른어

🎨 UI/UX

• 다크 모드: 밝은 테마와 어두운 테마 간 전환 (기본값은 어두움)
• 반응형 디자인: 데스크톱 및 모바일 브라우저에서 작동
• 접이식 섹션: 확장 가능한 패널로 사이드바 구성
• 토스트 알림: 사용자 친화적인 피드백 메시지

🔒 프라이버시 우선

사진이 기기를 떠나지 않습니다!

모든 GPS 추출 및 처리는 완전히 브라우저 내에서 이루어집니다. 어떤 이미지도 서버에 업로드되지 않습니다. 유일한 네트워크 요청은:

• 지도 타일 로드 (OpenStreetMap과 같은 타일 제공자로부터)
• 선택 사항: OSM POI 데이터 로드 (Overpass API에서)

즉, 개인 사진과 위치 데이터는 100% 비공개로 유지됩니다. 또한 앱에서 로깅이 전혀 없습니다.

🛠️ 기술 스택

📦 설치 및 사용법

요구 사항

• PHP 8.2 이상
• 최신 웹 브라우저 (Chrome, Firefox, Safari, Edge)

설치

1. 저장소를 클론하거나 (ZIP으로 다운로드하여 압축 해제)
2. 웹 서버가 public/ 디렉터리를 가리키도록 구성

배포

프로덕션 사용의 경우 PHP를 지원하는 모든 웹 서버 (Apache, Nginx with PHP-FPM 등)에 배포

📁 프로젝트 구조

gps-track-viewer/
├── public/                 # Web root
│   ├── assets/
│   │   ├── js/            # Application JavaScript
│   │   │   ├── app.js     # Main application logic
│   │   │   └── TrackParser.js  # GPX/KML parsing
│   │   └── styles.css     # Application styles
│   ├── lib/               # PHP classes
│   │   ├── Assets/        # Asset handling
│   │   ├── Security/      # Session & security
│   │   ├── View/          # Template rendering
│   │   └── Config.php     # Configuration
│   ├── templates/         # PHP templates
│   │   └── app.php        # Main application template
│   ├── vendor/            # Frontend libraries (Leaflet, etc.)
│   ├── index.php          # Application entry point
│   └── router.php         # Development server router
└── README.md

⚠️ 제한 사항

• GPS 데이터 필요: GPS EXIF 데이터가 포함된 사진만 지도에 표시됩니다
• 브라우저 메모리: 매우 큰 배치 (50,000장 이상)는 RAM이 제한된 기기에서 느릴 수 있습니다
• 타일 제공자: 일부 지도 스타일은 사용량 제한이 있거나 저작자 표시가 필요할 수 있습니다
• OSM 데이터: Overpass API 쿼리는 과부하를 방지하기 위해 요청당 약 300개의 POI로 제한됩니다

🤝 기여하기

기여를 환영합니다! 이슈와 풀 리퀘스트를 자유롭게 제출해 주세요.

🙏 크레딧

GPS Track Viewer는 거인의 어깨 위에 세워졌습니다. 다음 놀라운 오픈 소스 프로젝트의 개발자와 기여자분들께 감사드립니다:

• Leaflet - 대화형 지도 (BSD 2-Clause)
• Leaflet.heat - 히트맵 플러그인 (BSD 2-Clause)
• exifr - 빠른 EXIF 추출 (MIT)
• Chart.js - 아름다운 차트 (MIT)
• dom-to-image - PNG 내보내기 (MIT)
• OpenStreetMap - 지도 데이터 (ODbL)

☕ 프로젝트 지원

이 프로젝트가 유용하고 지원하고 싶다면: Bitcoin (BTC): bc1q3lz8vxpk0rchqn6dq8g08rkcqts425csuvnjr2477uzdenak5n8sfds2ke

📬 연락처

질문, 제안 또는 버그 신고는 GitHub에 이슈를 열어 주세요.