Skip to content

RunChuck/Running-Handai-GPX-Viewer

Repository files navigation

🏃‍♂️ 팀척을 위한 GPX 뷰어

팀 내부에서 사용하기 위한 GPX 파일 경로 시각화 도구입니다.

🎯 사용법

  1. 파일 업로드

    • 드래그 앤 드롭으로 GPX 파일을 업로드하거나
    • 드롭존을 클릭해서 파일 선택
  2. 경로 확인

    • 업로드된 파일 목록에서 원하는 경로 클릭
    • 지도에서 경로가 파란색으로 표시됨
  3. 추가 기능

    • 📍 현재 위치 버튼: 내 위치로 지도 이동
    • 🗑️ 삭제 버튼: 불필요한 파일 제거
    • ↔️ 사이드바 접기/펼치기

⚡ 주요 기능

  • 여러 파일 관리: 한 번에 여러 GPX 파일 업로드 가능
  • 드래그 앤 드롭: 간편한 파일 업로드
  • 현재 위치: GPS 기반 위치 확인
  • 반응형 UI: 사이드바 접기로 지도 영역 확대
  • 카카오맵 연동: 정확한 한국 지도 데이터

🛠️ 기술 스택

  • React 18 + TypeScript
  • Emotion styled-components
  • 카카오맵 API
  • Vite

🔑 환경 설정

카카오맵 API 키가 .env.local에 설정되어 있습니다.

VITE_KAKAO_MAP_API_KEY=***

📝 지원하는 파일 형식

  • GPX 파일: 표준 GPS Exchange Format
  • 필수 요소: <rtept> 태그와 lat, lon 좌표
  • 선택 요소: 경로명, 고도 정보

🐛 문제 해결

파일이 업로드되지 않는 경우:

  • GPX 파일 형식인지 확인
  • 파일 크기가 너무 크지 않은지 확인

지도가 표시되지 않는 경우:

  • 브라우저 새로고침
  • 카카오맵 API 키 확인

현재 위치가 작동하지 않는 경우:

  • 브라우저 위치 권한 허용 필요

팀 내부용 도구 | 문의사항은 인경에게 😗