- Google Timeline Visualizer는 내보낸 Timeline JSON을 애니메이션 MP4 여행 동영상으로 변환합니다.
- Android 사용자는 저장소의 최신 GitHub 릴리스에서 APK를 설치합니다.
- iPhone 사용자는 네이티브 애플리케이션을 설치하지 않고 Safari 웹 앱을 엽니다.
- 개인정보 보호 중점: Timeline JSON은 로컬에 유지되며, 지도 타일은 CARTO에 요청됩니다.
- 권장 워크플로: 누락된 기록을 복원하고, 짧은 날짜 범위를 내보낸 다음 미리 보고 렌더링합니다.
google timeline visualizer GitHub Repository 개요
google timeline visualizer github repository는 Google 위치 기록 Timeline 데이터를 애니메이션 여행 동영상으로 변환할 수 있는 오픈 소스 방법을 제공합니다. 클라우드 대시보드에 의존하는 대신 이 도구는 로컬 Timeline.json 파일을 읽고, 월 단위 범위 또는 정확한 날짜를 선택하게 하며, 여행 경로를 미리 보고 시청하거나 공유할 수 있는 MP4를 생성합니다.
이 프로젝트는 Android와 iPhone 워크플로를 지원하며, 데스크톱 사용자를 위한 별도의 Python 생성기도 제공합니다. Android 앱은 Google Play가 아닌 GitHub 릴리스를 통해 배포되며, iPhone 사용자는 Safari에서 웹 앱을 열고 홈 화면에 추가할 수 있습니다.
동영상 주요 기능:
- Android 또는 iPhone에서 Timeline JSON 내보내기
- 기록 파일을 업로드하는 대신 비주얼라이저를 로컬에서 실행
- MP4를 만들기 전에 경로 미리 보기
- 카메라 이동과 정확한 날짜 범위 선택
- 완성된 동영상을 로컬 라이브러리에 저장
| 플랫폼 | 접속 방법 | Timeline 파일 워크플로 | 출력 |
|---|---|---|---|
| Android | GitHub APK 릴리스 | 휴대전화 설정에서 내보내기 | MP4가 로컬에 저장됨 |
| iPhone | Safari 웹 앱 | Google Maps에서 내보내기 | MP4를 재생, 공유 또는 다운로드 가능 |
| 데스크톱 | Python 명령줄 버전 | Timeline.json을 입력으로 제공 | 렌더링된 여행 동영상 |
Android APK
- 최신
TimelineVisualizer-*.apk다운로드 - Android 8.0 이상 필요
- 설정 후 알 수 없는 앱 설치 권한 비활성화
iPhone 웹 앱
- Safari 16.4 이상 사용
- 네이티브 설치 불필요
- Timeline JSON은 기기에 유지됨
데스크톱 Python
- Python 3.9+ 필요
- FFmpeg 및 프로젝트 종속성 사용
- 스크립트 또는 일괄 렌더링에 유용
릴리스, 문서, 개인정보 보호 세부 정보 및 빌드 지침은 공식 mahlernim/google-timeline-visualizer GitHub repository를 기준으로 확인하세요. 타사 미러에서 APK 파일을 다운로드하지 마세요.
Google Timeline JSON 내보내기
비주얼라이저에는 내보낸 Timeline 파일이 필요합니다. Android와 iPhone의 내보내기 메뉴는 상당히 다르므로 플랫폼별 경로를 주의 깊게 따라야 합니다. 파일에 기록이 없다면 먼저 Google Maps에서 Timeline을 복원한 후 새 파일을 다시 내보내세요.
| 기기 | 메뉴 경로 | 파일 이름 또는 위치 | 중요 참고 사항 |
|---|---|---|---|
| Android | 휴대전화 설정 → 위치 → 위치 서비스 → Timeline | Timeline.json을 Downloads 또는 다른 영구 폴더에 저장 | 내보내기는 시스템 설정에서 처리됨 |
| iPhone | Google Maps → 프로필 사진 → 설정 → 개인 콘텐츠 → Timeline 데이터 내보내기 | Files 앱에 저장 | JSON을 Android 기기로 이동할 수도 있음 |
| 기록 누락 | Google Maps 복원 링크 | 다시 내보내기 전에 복원 | 비주얼라이저는 암호화된 Google 백업에 액세스할 수 없음 |
기존 Timeline 데이터 확인
Google Maps 또는 해당 Timeline 설정을 열고 기기에 예상한 여행 기록이 있는지 확인하세요. 휴대전화를 변경했거나 Maps를 다시 설치했거나 기기를 초기화했다면 이전 여행 기록을 먼저 복원해야 할 수 있습니다.
Android에서 내보내기
휴대전화 설정을 열고 위치를 선택한 다음 위치 서비스를 선택하여 Timeline을 엽니다. Timeline 데이터 내보내기를 선택하고 확인 화면을 계속 진행한 뒤, 생성된 JSON 파일을 쉽게 찾을 수 있는 로컬 폴더에 저장하세요.
iPhone에서 내보내기
Google Maps를 열고 프로필 사진을 탭한 다음 설정을 선택합니다. 개인 콘텐츠를 열고 Timeline 데이터 내보내기를 선택하세요. 내보낸 파일을 Apple Files 앱에 저장합니다.
파일 확인
파일에 액세스할 수 있고 예상한 기간의 데이터가 포함되어 있는지 확인하세요. 데이터가 0인 내보내기 결과는 대개 로컬 Timeline 데이터베이스가 복원되지 않았거나 채워지지 않았다는 의미입니다.
휴대전화에 표시되는 메뉴 이름이 다르다면 저장소의 Timeline 파일 가져오기 지침을 사용하세요. Android 메뉴 이름은 제조업체에 따라 다를 수 있으며, 앱은 모든 기기의 Timeline 설정 페이지로 연결되는 보편적인 직접 링크를 제공할 수 없습니다.
기기를 변경한 후 이전 여행 기록이 사라졌다면 먼저 Google Maps의 복원 절차를 사용하세요. Google Timeline Visualizer는 계정에 로그인하거나 암호화된 백업 데이터를 직접 복구할 수 없습니다.
로컬 워크플로 설치 및 보호
이 프로젝트는 로컬 처리를 중심으로 설계되었습니다. Timeline JSON은 프로젝트 서버에 업로드되지 않으며, 내보낸 파일을 읽기 위해 Google 로그인이 필요하지 않습니다. 프로젝트에서 설명하는 유일한 네트워크 의존 기능은 기본 지도에 액세스하는 것입니다.
지도 타일은 CARTO에 요청되며 OpenStreetMap 데이터를 사용합니다. 이러한 요청을 통해 타일 제공업체가 현재 확인 중인 지도 영역을 파악할 수 있지만, Timeline JSON 자체가 업로드되지는 않습니다. 특히 집, 직장 또는 일상적인 이동 패턴이 드러나는 경로를 다룰 때는 파일을 불러오기 전에 개인정보 보호 고지를 검토하세요.
| 개인정보 보호 영역 | 비주얼라이저의 처리 방식 | 실용적인 권장 사항 |
|---|---|---|
| Timeline JSON | 로컬에서 처리되며 업로드되지 않음 | 보호된 폴더에 파일 보관 |
| Google 계정 | Google 로그인 필요 없음 | Google Maps를 통해 별도로 내보내거나 복원 |
| 기본 지도 타일 | 지도 렌더링 중 CARTO에 요청됨 | 계속하기 전에 지도 개인정보 보호 고지 검토 |
| 렌더링된 MP4 | 기기에 저장됨 | 경로 세부 정보를 확인한 후에만 공유 |
| 원본 JSON | 필터링해도 변경되지 않음 | 실험 전에 수정하지 않은 백업 보관 |
파일 안전
JSON을 로컬에 저장하고 불필요한 공유를 제한하며, 파일을 편집하거나 이동하기 전에 수정하지 않은 백업을 보관하세요.
권한 관리
Android에서는 일시적으로 알 수 없는 앱 설치 권한이 필요할 수 있습니다. APK를 설치한 후 해당 권한을 취소하세요.
공유 전 검토
MP4를 보내기 전에 최종 경로를 확인하세요. 여행 애니메이션을 통해 민감한 위치와 이동 습관이 드러날 수 있습니다.
앱은 기본적으로 보수적인 GPS 이상치 필터링을 적용할 수 있습니다. 이 기능은 원본 JSON을 변경하지 않고, 고립되어 있으며 현실성이 떨어지는 왕복 좌표를 무시합니다. 모든 위치 지점을 포함해야 할 때는 필터링을 끌 수 있지만, 렌더링하기 전에 결과를 신중하게 미리 확인하세요.
로컬 처리는 Timeline 파일이 프로젝트 서버에 업로드되지 않도록 보호하지만, 완성된 MP4를 익명으로 만들어 주지는 않습니다. 동영상을 게시하기 전에 지도 타일, 경로 세부 정보 및 공유 권한을 검토하세요.
애니메이션 여행 MP4 만들기
Timeline 파일을 불러온 후의 기본 워크플로는 간단합니다. 기간을 선택하고 시각적 스타일을 설정한 다음 여행 경로를 미리 보고 최종 동영상을 렌더링하면 됩니다. 수년에 걸친 위치 기록을 처리하기 전에 짧은 범위나 작은 테스트 기간으로 시작하세요.
| 설정 | 선택 가능한 항목 | 가장 적합한 용도 |
|---|---|---|
| 날짜 범위 | 월 범위 또는 정확한 날짜 | 여행이나 짧은 이벤트에는 정확한 날짜 사용 |
| 거리 단위 | 선택 가능한 단위 | 시청자에게 익숙한 단위로 맞춤 |
| 카메라 이동 | Steady, Fixed 또는 Dynamic | 경로의 복잡성에 따라 선택 |
| GPS 필터링 | Conservative 또는 Off | 고립된 이상치를 제거하거나 모든 지점 유지 |
| 미리 보기 | 대화형 여행 경로 미리 보기 | 렌더링 전에 경로 형태 확인 |
| 출력 | MP4 및 선택 가능한 Journey overview | 로컬에서 시청, 저장 또는 공유 |
동영상 만들기 열기
Android 앱 또는 iPhone 웹 앱을 실행하고 동영상 만들기를 선택하세요. 파일 선택기를 통해 내보낸 Timeline 파일을 선택합니다.
날짜 범위 설정
연간 개요를 보려면 기본의 넓은 기간을 유지하고, 휴가, 자동차 여행 또는 며칠간의 여정을 분리하려면 정확한 날짜를 선택하세요. 선택한 범위에 이동 데이터가 포함되어 있는지 확인합니다.
카메라 이동 선택
차분한 경로에는 Steady를 사용하고, 고정된 고도를 원할 때는 Fixed를 사용하며, 경로에 더 적극적인 확대·축소가 필요할 때는 Dynamic을 사용하세요. 드문 장거리 이동은 대권 경로를 따라 보간됩니다.
여행 경로 미리 보기
미리 보기를 선택하고 경로 형태, 마커 이동 및 지도 범위를 확인하세요. 경로가 예상치 않게 튄다면 렌더링하기 전에 원본 데이터와 필터링 옵션을 점검합니다.
MP4 만들기 및 저장
동영상 만들기를 선택하고 렌더링 단계를 확인하세요. Android 10 이상에서는 완료된 파일이 Movies/Timeline Visualizer에 저장되며, Android 8과 9에서는 시스템 다른 이름으로 저장 선택기가 사용됩니다.
애플리케이션은 전체 경로가 보이도록 축소하는 짧은 엔딩 시퀀스를 추가합니다. 지원되는 Android 버전에서는 렌더링이 계속되는 동안 다른 앱으로 전환하거나 화면을 꺼도 됩니다. Android 13 이상에서는 알림 액세스가 허용된 경우 진행률 알림을 표시할 수 있습니다.
먼저 짧은 날짜 범위를 미리 보세요. 이렇게 하면 기기가 큰 Timeline을 렌더링하는 데 추가 시간을 사용하기 전에 파일 액세스, 경로 형태, 카메라 동작 및 지도 로딩을 확인할 수 있습니다.
동영상 라이브러리, 문제 해결 및 데스크톱 도구
완성된 MP4 파일은 내 동영상에 추가되며, 각 항목에는 썸네일, Timeline 기간, 재생 시간 및 생성 날짜를 저장할 수 있습니다. 이전 MP4 파일을 포함하려면 동영상 추가를 사용하세요. 목록에서 항목을 제거해도 실제 파일이 반드시 삭제되는 것은 아니며, 동영상 삭제는 별도의 확인 작업입니다.
| 문제 | 가능한 원인 | 권장 해결 방법 |
|---|---|---|
| 내보내기에 데이터가 0으로 표시됨 | 로컬 Timeline이 비어 있음 | Google Maps에서 기록을 복원한 후 다시 내보내기 |
| APK 설치가 차단됨 | 알 수 없는 앱 권한이 비활성화됨 | 브라우저 또는 파일 관리자에 일시적으로 권한 허용 |
| 경로에 이상한 점프가 있음 | GPS 이상치 또는 데이터 부족 | Conservative 필터링을 활성화하여 미리 보기 |
| 파일을 다시 열 수 없음 | 파일이 이동되었거나 제공업체 액세스 권한이 사라짐 | 일반적인 파일 로딩 절차를 다시 수행 |
| 동영상 항목을 사용할 수 없다고 표시됨 | MP4가 외부에서 이동되거나 삭제됨 | 오래된 라이브러리 항목을 제거하거나 파일 복원 |
| 테스트하기에 렌더링 결과가 너무 큼 | 날짜 범위에 기록이 지나치게 많이 포함됨 | 더 작은 검증 렌더링에는 정확한 날짜 사용 |
데스크톱 자동화를 위해 저장소에는 기존 Python 생성기가 포함되어 있습니다. 문서화된 설정에는 Python 3.9 이상, FFmpeg 및 requirements.txt의 패키지가 필요합니다.
python -m pip install -r requirements.txt python visualizer.py --input Timeline.json --year 2026 --camera-movement steady
명령줄 워크플로는 반복 가능한 렌더링이나 일괄 변환이 필요할 때 유용합니다. 입력 경로를 로컬로 유지하고, 선택한 연도 또는 기간을 확인하며, 긴 렌더링을 시작하기 전에 FFmpeg를 사용할 수 있는지 확인하세요.
렌더링 전 확인:
- Timeline JSON에 원하는 여행 기간이 포함되어 있는지 확인
- 다시 내보내기 전에 누락된 Google Maps 기록 복원
- 짧은 날짜 범위를 미리 보고 경로 형태 확인
- 개인정보 보호 고지 및 표시되는 지도 영역 검토
- APK 설치 후 Android 설치 권한 취소
정리를 위해 내 동영상을 사용하되, 라이브러리 항목과 MP4 파일은 별개의 요소라는 점을 기억하세요. 항목을 제거하거나 삭제하기 전에 파일 위치를 확인하세요.
Google Timeline Visualizer FAQ
Q: Google Timeline Visualizer는 내 Timeline JSON을 업로드하나요?
프로젝트 문서에 따르면 Timeline 파일은 절대 업로드되지 않습니다. 처리는 로컬에서 이루어집니다. 기본 지도 타일은 CARTO에 요청되며, 이러한 요청을 통해 타일 제공업체가 확인된 지도 영역을 파악할 수 있습니다.
Q: iPhone에서 비주얼라이저를 사용할 수 있나요?
예. Safari에서 iPhone 웹 앱을 열고 Files에서 내보낸 Timeline.json을 선택한 다음 날짜 범위와 카메라 이동을 설정하고 여행 경로를 미리 본 후 MP4를 만들 수 있습니다. 네이티브 앱을 설치할 필요가 없습니다.
Q: Android 사용자는 어디에서 APK를 다운로드해야 하나요?
공식 mahlernim/google-timeline-visualizer GitHub 릴리스의 Assets 섹션에서 최신 TimelineVisualizer APK를 다운로드하세요. 체크섬 파일은 선택하지 말고 타사 미러를 피하세요.
Q: 이전 여행 기록이 사라진 이유는 무엇인가요?
휴대전화 변경, Google Maps 재설치 또는 기기 초기화로 인해 로컬 Timeline 데이터베이스가 비어 있을 수 있습니다. 먼저 Google Maps에서 암호화된 기록을 복원한 다음 비주얼라이저용 새 Timeline JSON 파일을 내보내세요.
저장소에는 최신 직접 배열 형식의 Timeline 내보내기, 이전 semanticSegments 구조, 경로, 활동, 방문 기록, 여러 좌표 형식 및 국제 날짜 변경선을 넘는 경로에 대한 지원도 문서화되어 있습니다. 시맨틱 처리를 사용할 수 없는 경우 원시 위치 데이터 대체 처리로 인해 경고가 표시될 수 있습니다.
보다 광범위한 계정 및 Timeline 복구 지침은 Google 공식 Timeline 도움말을 참고하세요. 비주얼라이저의 릴리스 파일, 개인정보 보호 설명, 플랫폼별 지침 및 개발 문서는 GitHub 저장소에서 확인할 수 있습니다.
가장 안전한 워크플로는 Google Maps를 기록을 복원하거나 내보내는 곳으로 사용하고, GitHub 비주얼라이저를 내보낸 파일을 미리 보고 렌더링하는 로컬 도구로 사용하는 것입니다.