- 주요 키워드: google timeline visualizer source code는 Android, iPhone 웹 및 데스크톱 작업 흐름을 다룹니다.
- 핵심 입력 파일: 애니메이션 여행 동영상을 만들기 전에 로컬
Timeline.json파일을 내보내세요. - 데스크톱 설정: Python 3.9 이상, FFmpeg 및
requirements.txt에 명시된 패키지를 설치하세요. - Android 빌드: JDK 17, Android SDK Platform 36 및 Build Tools 36.0.0을 사용하세요.
- 개인정보 보호 모델: Timeline 데이터는 로컬에 유지되며, 기본 지도 타일은 CARTO에 요청됩니다.
google timeline visualizer source code 개요
GitHub의 Google Timeline Visualizer 저장소는 내보낸 Google Maps Timeline 파일을 애니메이션 여행 동영상으로 변환하는 소스 공개 프로젝트입니다. 일반적인 게임이나 엔터테인먼트 플랫폼은 아닙니다. 주요 기능은 로컬 Timeline 처리, 애니메이션 지도 렌더링, MP4 생성 및 개인정보를 고려한 파일 처리입니다.
이 프로젝트는 Android 애플리케이션, iPhone 웹 앱 및 원본 데스크톱 Python 생성기를 제공합니다. 버전과 관계없이 기본 작업 흐름은 동일합니다. Timeline 데이터를 내보내고, 기간을 선택한 다음, 경로를 미리 보고 동영상을 렌더링합니다.
| 구성 요소 | 주요 역할 | 주요 환경 |
|---|---|---|
| Android 앱 | Timeline 파일을 가져오고 MP4 동영상 렌더링 | Android 8.0 이상 |
| iPhone 웹 앱 | Safari에서 내보낸 JSON 파일 처리 | iPhone Safari |
| 데스크톱 생성기 | 명령줄 또는 Python 작업 흐름으로 동영상 생성 | Python이 설치된 데스크톱 |
| 저장소 빌드 도구 | Android 변형 빌드 테스트, 린트 및 조립 | JDK 17 및 Android SDK |
로컬 파일 처리
Timeline JSON은 기기 저장 공간에서 선택됩니다. 이 프로젝트는 소스 파일을 계정 기반 클라우드 작업 흐름으로 복사하지 않습니다.
애니메이션 여행 경로
경로 마커가 선택한 여행 기록을 따라 이동하며, 드문드문 기록된 여행을 위한 보간과 카메라 이동 제어를 지원합니다.
동영상 라이브러리
완료된 MP4 파일은 애플리케이션 인터페이스를 통해 목록에 추가하거나 시청, 공유, 이동 또는 삭제할 수 있습니다.
이 프로젝트를 로컬 시각화 파이프라인으로 이해하세요. 중요한 설정은 계정 로그인보다는 파일 접근, 렌더링 종속성, 지도 타일 및 빌드 도구와 관련되어 있습니다.
Timeline 내보내기 및 입력 형식
Visualizer를 사용하려면 내보낸 Timeline 파일이 필요합니다. iPhone에서는 프로필 사진 → 설정 → 개인 콘텐츠 → Timeline 데이터 내보내기를 통해 Google Maps에서 데이터를 내보내세요. 생성된 Timeline.json 파일을 파일 앱에 저장한 다음 Safari에서 선택합니다.
Android에서는 Google Maps 내부가 아니라 휴대전화의 설정 앱을 통해 데이터를 내보냅니다. 설정 → 위치 → 위치 서비스 → Timeline을 연 다음 Timeline 데이터 내보내기를 선택하고, 파일을 Downloads와 같이 접근하기 쉬운 위치에 저장하세요.
| 플랫폼 | 내보내기 경로 | 다음 작업 |
|---|---|---|
| iPhone | Google Maps 개인 콘텐츠 설정 | Safari에서 웹 앱 열기 |
| Android | 휴대전화 설정, 위치 서비스, Timeline | 앱에서 JSON 파일 선택 |
| 데스크톱 | 내보낸 Timeline 파일을 컴퓨터로 복사 | Python 생성기에 파일 전달 |
| 복원된 기록 | 먼저 Google Maps에서 기록 복원 | 이후 새 JSON 파일 내보내기 |
소스 코드는 최신 Android 및 iOS 직접 배열 형식의 내보내기와 semanticSegments 구조를 사용하는 이전 파일을 모두 지원합니다. 또한 문자열 값, latLng, 도 단위 값, geo: 좌표 및 E7 좌표를 비롯한 여러 좌표 표현을 인식할 수 있습니다.
지원되는 경로 데이터에는 다음 항목이 포함될 수 있습니다.
- Timeline 경로
- 활동
- 방문
- 기록이 드문 장거리 경로
- 국제 날짜 변경선을 가로지르는 경로
- 경고와 함께 사용할 수 있는 원시 위치 데이터 및 로컬 노이즈 감소
휴대전화를 변경하거나 초기화한 후 이전 여행 기록이 누락되었다면 먼저 Google Maps에서 기록을 복원하세요. Timeline Visualizer는 Google의 암호화된 백업에 직접 액세스할 수 없습니다.
공식 내보내기 및 복원 안내는 Google Maps Timeline 도움말을 참고하세요. 이 가이드는 2026년 8월 25일에 검토되었습니다.
단계별 설정 및 동영상 렌더링
가장 빠른 작업 흐름은 JSON 파일을 준비하고, 날짜 범위를 선택하고, 경로를 미리 본 다음 MP4를 만드는 것입니다. 정확한 메뉴 이름은 휴대전화 모델에 따라 조금씩 다를 수 있지만, 프로젝트의 핵심 과정은 일관되게 유지됩니다.
Timeline.json 준비
Google Maps 또는 Android 위치 설정에서 Timeline 기록을 내보내세요. 브라우저, 파일 관리자 또는 애플리케이션이 접근할 수 있는 위치에 파일을 보관하세요.
여행 범위 선택
동영상 생성 흐름을 열고 Timeline 파일을 선택한 다음 월 범위 또는 정확한 날짜를 지정하세요. 정확한 날짜를 사용하면 짧은 여행만 분리하는 데 유용합니다.
미리보기 구성
거리 단위와 카메라 이동 방식을 선택한 다음 애니메이션 경로를 미리 보세요. 최종 렌더링을 시작하기 전에 지도의 움직임을 확인하세요.
MP4 생성
동영상 생성을 시작하고 진행 상황을 확인하세요. 앱은 진행 단계를 표시하고 남은 시간을 예상할 수 있으며, 렌더링 중 취소 옵션을 제공합니다.
결과 저장 또는 공유
로컬 라이브러리에서 완성된 동영상을 열고 재생, 공유하거나 저장 기능을 사용해 다른 위치로 복사하세요.
| 설정 | 사용 가능한 동작 | 실제 활용 |
|---|---|---|
| 날짜 범위 | 월 범위 또는 정확한 날짜 | 하나의 여행 또는 더 넓은 기록에 집중 |
| 거리 단위 | 선택 가능한 단위 | 시청자와 지역에 맞게 조정 |
| 카메라 이동 | 구성 가능한 이동 방식 | 보기 편하도록 안정적인 움직임 사용 |
| GPS 필터링 | 기본적으로 보수적 설정 또는 끄기 | 고립된 비현실적 왕복 지점 감소 |
| 미리보기 | 대화형 경로 미리보기 | 렌더링 전에 타이밍과 지도 움직임 확인 |
렌더링 중에는 이전 여행 경로가 이동하는 마커 뒤에서 점차 희미해지므로, 긴 Timeline도 더 쉽게 따라갈 수 있습니다. 장거리 비행을 포함한 드문 경로는 대권 경로를 따라 보간됩니다. 가까운 지역의 이동에서는 카메라가 마커를 따라가기 전에 마커를 안정적인 중앙 영역 안에 유지할 수 있어 통근 중 발생하는 급격한 카메라 움직임을 줄여 줍니다.
최종 동영상에는 전체 경로를 보여 주는 1.5초 길이의 줌아웃 엔딩이 추가되며, 전체 개요가 잠시 유지됩니다. Android 10 이상에서는 완료된 파일이 Movies/Timeline Visualizer에 저장됩니다. Android 8 및 9에서는 시스템의 다른 이름으로 저장 선택기를 사용합니다.
최종 MP4를 만들기 전에 전체 여행 경로를 미리 보세요. 이를 통해 지나치게 넓은 날짜 범위, 예상하지 못한 GPS 지점 또는 경로에 적합하지 않은 카메라 움직임을 확인할 수 있습니다.
데스크톱 Python 버전 및 Android 빌드
Python 기반 처리를 선호하는 사용자를 위해 기존 데스크톱 생성기를 계속 사용할 수 있습니다. 문서에 명시된 요구 사항은 Python 3.9 이상, FFmpeg 및 requirements.txt에 포함된 패키지입니다.
기본 종속성 설정은 다음과 같습니다.
python -m pip install -r requirements.txt
저장소 문서에는 visualizer.py, 입력 Timeline 파일, 선택한 연도 및 카메라 이동 옵션을 사용하는 Python 실행 예시도 제공됩니다.
python visualizer.py --input Timeline.json --year 2026 --camera-movement steady
이 명령을 시작점으로 사용하고, 대규모 배치 작업을 스크립팅하기 전에 현재 저장소의 인자를 확인하세요. 파일 경로, 날짜 선택 및 사용 가능한 옵션은 체크아웃한 리비전과 일치해야 합니다.
| 빌드 대상 | 필요한 도구 | 검증 명령 |
|---|---|---|
| 데스크톱 Python 생성기 | Python 3.9 이상, FFmpeg, requirements.txt | 내보낸 JSON 파일로 Python 생성기 실행 |
| Android 디버그 빌드 | JDK 17, Android SDK Platform 36 | ./gradlew assembleGithubDebug |
| Android Play 빌드 | JDK 17, Android SDK Platform 36 | ./gradlew assemblePlayDebug |
| Android 품질 검사 | Gradle 도구 모음 | ./gradlew test lint |
| Python 테스트 | 개발 요구 사항 | python -m pip install -r requirements-dev.txt 및 python -m pytest |
Android 개발을 위한 문서화된 도구 모음에는 JDK 17, Android SDK Platform 36 및 Build Tools 36.0.0이 포함됩니다. 저장소의 테스트 절차는 Android 검증과 Python 종속성 설치 및 pytest 실행을 함께 수행합니다.
가능하면 로컬 JDK, Android SDK, Build Tools, Python 및 FFmpeg 버전을 고정하세요. 일관된 도구 환경은 렌더링 및 릴리스 문제를 더 쉽게 해결할 수 있도록 해 줍니다.
참조된 문서에서 Android 애플리케이션은 Google Play가 아닌 저장소의 릴리스를 통해 배포됩니다. APK를 직접 설치하는 경우 저장소에서 릴리스 자산을 다운로드하고, 설치 패키지를 선택할 때 체크섬 파일은 피하세요. 이 배포 방식에서는 Android에 Play 스토어 외부 설치 경고가 표시될 수 있습니다.
개인정보 보호, 저장 공간 및 문제 해결
개인정보 보호는 이 프로젝트 설계의 핵심 요소입니다. Timeline JSON 파일은 업로드되지 않습니다. 프로젝트에서 설명하는 유일한 네트워크 의존 기능은 기본 지도입니다. CARTO는 표시된 지도 영역에 대한 요청을 받고 OpenStreetMap 데이터를 기반으로 타일을 제공합니다.
따라서 경로 파일과 지도 타일은 별도로 고려해야 합니다.
| 데이터 또는 서비스 | 프로젝트 동작 | 개인정보 보호 고려 사항 |
|---|---|---|
| Timeline JSON | 로컬에서 처리 | 앱이 파일을 업로드하지 않음 |
| Google 로그인 | Timeline 접근에 필요하지 않음 | 로그인으로 휴대전화의 Timeline 기록이 노출되지 않음 |
| CARTO 기본 지도 | 표시할 지도 영역 요청 | 타일 요청을 통해 확인한 지도 지역이 드러남 |
| MP4 출력 | 로컬에 저장 | 파일을 신중하게 공유하거나 이동 |
| 동영상 색인 | 로컬 메타데이터와 썸네일 저장 | 항목을 제거해도 MP4가 반드시 삭제되는 것은 아님 |
앱은 완료된 동영상의 작은 로컬 색인을 유지합니다. 항목에는 썸네일, 제목, Timeline 기간, 재생 시간 및 생성 날짜가 포함될 수 있습니다. 목록에서 제거는 MP4를 그대로 남겨 두지만, 동영상 삭제는 별도의 확인 작업이며 저장소 제공자가 허용하는 경우 파일을 영구적으로 삭제할 수 있습니다.
작업 흐름에 문제가 발생하면 다음 문제 해결 순서를 사용하세요.
- Timeline 메뉴가 보이지 않으면 휴대전화의 위치 설정을 확인하고 Google의 최신 도움말 메뉴 이름을 참고하세요.
- 파일을 다시 열 수 없다면 파일이 이동되지 않았는지, 저장 공간 권한을 계속 사용할 수 있는지 확인하세요.
- 이전 여행 기록이 없다면 Google Maps에서 기록을 복원한 후 새 JSON 파일을 내보내세요.
- 미리보기가 불안정해 보이면 GPS 필터링 및 카메라 이동 설정을 검토하세요.
- APK가 설치되지 않으면 Android 버전을 확인하고 선택한 브라우저 또는 파일 관리자에서 설치를 일시적으로 허용하세요.
소스 코드 설정 체크리스트:
- 새 Timeline.json 파일 내보내기
- 선택한 날짜 범위와 좌표 형식 확인
- 필요에 따라 Python, FFmpeg 또는 Android 빌드 도구 모음 설치
- MP4 렌더링 전에 경로 미리보기
- 지도 개인정보 보호 및 로컬 동영상 저장 설정 검토
Timeline 파일은 로컬에 유지되지만, 기본 지도 요청을 통해 미리보기 또는 내보낸 동영상에 표시되는 지역이 드러날 수 있습니다. 민감한 기록을 불러오기 전에 지도 개인정보 보호 안내를 확인하세요.
FAQ
Q: google timeline visualizer source code는 무엇을 만드나요?
내보낸 Google Maps Timeline 데이터를 애니메이션 여행 동영상으로 변환하는 도구를 지원합니다. 여기에는 Android 앱, iPhone 웹 앱 및 데스크톱 Python 생성기가 포함됩니다.
Q: Timeline Visualizer는 내 Timeline.json 파일을 업로드하나요?
프로젝트 문서에 따르면 Timeline 파일은 업로드되지 않습니다. 네트워크를 사용하는 기능은 기본 지도이며, CARTO는 표시된 지도 영역에 대한 요청을 받습니다.
Q: Android 프로젝트를 빌드하려면 무엇이 필요한가요?
문서에 명시된 Android 요구 사항은 JDK 17, Android SDK Platform 36 및 Build Tools 36.0.0입니다. 저장소는 테스트, 린트 및 빌드 조립을 위한 Gradle 명령도 제공합니다.
Q: 이 프로젝트로 누락된 Google Maps Timeline 기록을 복원할 수 있나요?
아니요. 먼저 Google Maps에서 기록을 복원한 다음 새 JSON 파일을 내보내세요. Timeline Visualizer는 Google의 암호화된 백업에 직접 액세스할 수 없습니다.
내보낸 JSON, 생성된 MP4 및 소스 저장소 버전을 각각 별도로 기록해 두세요. 이렇게 하면 소스 데이터와 완성된 미디어를 혼동하지 않고 나중에 쉽게 다시 렌더링할 수 있습니다.