google timeline visualizer github: 설정 가이드 및 팁 - GitHub

google timeline visualizer github: 설정 가이드 및 팁

Google Timeline Visualizer GitHub 프로젝트가 내보낸 위치 기록을 비공개 애니메이션 여행 동영상으로 변환하는 방법을 알아보세요.

2026-08-25
google timeline visualizer 팀
빠른 가이드
  • google timeline visualizer GitHub 프로젝트는 내보낸 위치 기록을 애니메이션 경로 동영상으로 변환합니다.
  • 로컬 처리를 사용하면 파싱 및 렌더링 중 Timeline 파일이 기기에 남아 있습니다.
  • JSON 정규화는 최신 및 이전 Google 위치 기록 형식을 처리하는 데 도움이 됩니다.
  • 개인정보 검토가 중요한 이유는 기본 지도 타일 요청을 통해 조회 중인 지역이 드러날 수 있기 때문입니다.
  • 권장 workflow: 내보내기, 필터링, 미리보기, 렌더링을 진행한 후 완성된 MP4를 안전하게 보관하세요.

google timeline visualizer GitHub 개요

Google Timeline 비주얼라이저는 내보낸 Google 위치 기록을 시각적인 여정으로 변환하는 로컬 우선 유틸리티입니다. 이 프로젝트는 실시간 Google 계정을 읽는 대신 사용자가 제공한 파일을 기반으로 위치 기록을 파싱하고 지도 위에 이동 경로를 렌더링합니다.

가장 큰 장점은 제어권을 유지할 수 있다는 점입니다. 특히 Google이 Timeline 데이터의 저장 및 내보내기 방식을 변경한 이후에는 10년간의 위치 기록이 조각난 JSON으로 저장되어 해석하기 어려울 수 있습니다. 비주얼라이저는 원시 좌표와 시청 가능한 여행 영상 사이를 연결하는 실용적인 변환 계층을 제공합니다.

동영상 주요 내용:

  • 로컬 렌더링을 통해 과거 위치 기록을 영화 같은 여행 애니메이션으로 만들 수 있습니다.
  • 대권 보간은 장거리 비행과 국제 날짜 변경선을 통과하는 경로를 자연스럽게 부드럽게 만듭니다.
  • 보수적인 필터링은 원본 파일을 수정하지 않고 고립된 GPS 급등값을 줄일 수 있습니다.
  • 지도 타일은 전체 로컬 workflow에서 네트워크에 의존하는 주요 부분으로 남아 있습니다.
기능수행 작업중요한 이유
Timeline 파싱내보낸 위치 기록 JSON을 읽습니다원시 기록을 사용할 수 있는 경로 데이터로 변환합니다
경로 애니메이션여정을 따라 마커를 이동시킵니다여행 기록을 더 쉽게 이해할 수 있습니다
로컬 렌더링기기에서 데이터를 처리합니다클라우드 분석에 대한 의존도를 줄입니다
노이즈 필터링고립된 비정상 지점을 무시합니다GPS 오류로 인한 시각적 급변을 방지합니다
MP4 출력완성된 여행 동영상을 저장합니다공유와 보관이 편리해집니다
편집자 팁

비주얼라이저를 실시간 추적을 대체하는 도구가 아니라 과거 기록을 렌더링하는 도구로 생각하세요. 새로운 이동을 지속적으로 추가하는 대신 기존 기록을 바탕으로 영상을 만듭니다.

Timeline 데이터 준비

최종 애니메이션의 품질은 내보낸 Timeline 파일에 따라 달라집니다. GitHub 릴리스, 모바일 앱, 웹 앱 또는 데스크톱 스크립트를 열기 전에 내보낸 파일의 깨끗한 작업용 복사본을 만드세요. 서로 다른 날짜 범위나 필터링 설정으로 작업을 반복할 수 있도록 원본 파일은 변경하지 않고 보관해야 합니다.

Google 위치 기록 내보내기에는 서로 다른 스키마가 사용될 수 있습니다. 이전 파일에는 평면 배열과 원시 E7 정수 좌표가 포함될 수 있으며, 최신 내보내기에는 의미 기반 세그먼트, 방문, 활동 또는 중첩된 위치 구조가 사용될 수 있습니다. 제대로 작동하는 비주얼라이저는 지원되는 패턴을 식별하고 경로를 그리기 전에 이를 정규화해야 합니다.

다음과 같이 명확한 폴더 구조를 사용하세요.

  • 변경하지 않은 내보내기 파일을 위한 Timeline-original/
  • 테스트에 사용하는 복사본을 위한 Timeline-working/
  • 완성된 MP4 파일을 위한 Timeline-videos/
  • 날짜 범위, 설정 및 개인정보 보호 결정을 기록하는 Timeline-notes/
데이터 요소일반적인 변형처리 시 고려 사항
좌표십진수, latLng, geo: 또는 E7 값모든 지점을 일관된 지리 좌표 형식으로 변환합니다
시간 값ISO 타임스탬프 또는 이전 타임스탬프 필드여정을 정렬하기 전에 시간을 정규화합니다
경로 구조직접 배열 또는 의미 기반 세그먼트렌더링 전에 스키마를 감지합니다
활동도보, 운전, 자전거 또는 비행확정적인 사실이 아닌 맥락 정보로 사용합니다
방문이름이 지정되었거나 추정된 장소공유 동영상에 포함하기 전에 개인정보를 검토합니다

내보내기 계획

전하고 싶은 이야기에 맞는 기간을 선택하세요. 1년 전체를 선택하면 전체적인 개요를 만들 수 있고, 휴가, 자동차 여행, 출장 또는 이사와 같은 특정 여정에는 정확한 날짜를 선택하는 것이 더 좋습니다. 카메라 움직임을 테스트할 때는 짧은 범위가 미리보기와 렌더링에도 더 편리합니다.

좌표를 직접 수정하지 마세요. 경로에 이상한 지점이 포함되어 있다면 가능한 경우 비주얼라이저의 보수적인 필터링 옵션을 사용하세요. 이렇게 하면 원본 JSON을 보존하면서 렌더링 결과에서는 고립되고 비현실적인 왕복 이동을 제외할 수 있습니다.

원본 내보내기 파일 보호

필터, 날짜 범위 또는 변환기를 테스트하는 동안 원본 JSON을 덮어쓰지 마세요. 정리를 시작하기 전에 변경하지 않은 백업을 비공개 위치에 보관하세요.

단계별 렌더링 workflow

신뢰할 수 있는 workflow는 데이터 준비, 경로 검토 및 동영상 생성을 분리합니다. 이렇게 하면 문제를 더 쉽게 식별할 수 있고, 의도하지 않은 날짜 범위나 개인정보 노출이 포함된 동영상을 내보낼 가능성도 줄어듭니다.

1

Timeline 파일 내보내기

기기에 맞는 Google Timeline 내보내기 절차를 사용하여 결과 JSON 파일을 로컬에 저장하세요. 파일을 읽을 수 있는지 확인한 다음 비공개 작업 폴더에 보관하세요.

2

날짜 불러오기 및 선택

비주얼라이저를 열고 Timeline 파일을 선택하세요. 전체적인 이야기를 만들려면 월 단위 범위를 선택하고, 특정 여행을 보여주려면 정확한 날짜를 선택하세요. 최종 동영상에 필요하지 않은 기록까지 선택하지 않도록 주의하세요.

3

지도 및 카메라 설정 검토

렌더링 전에 경로를 미리 확인하세요. 마커가 현지 도로를 자연스럽게 따라가는지, 비행 경로가 지구를 가로지르는 곡선 경로로 표시되는지, 카메라 움직임이 시청하기에 충분히 안정적인지 확인하세요.

4

필터 적용 및 MP4 생성

고립된 급등값이 나타날 때는 보수적인 GPS 이상값 필터링을 활성화 상태로 유지하세요. 미리보기가 올바르게 보이면 MP4를 렌더링한 후 별도의 동영상 폴더에 저장하세요.

카메라 시스템은 지도가 계속 흔들리는 현상을 방지하도록 설계되었습니다. 현지 이동 중에는 지도가 마커를 따라가기 전에 마커가 안정적인 화면 영역 안에서 움직일 수 있습니다. 기록된 지점이 적은 비행과 같은 희소한 경로에서는 대권 보간을 사용해 지구를 가로지르는 더 자연스러운 곡선을 만들 수 있습니다.

workflow 단계권장 선택검토 질문
날짜 범위한 번의 여행에 해당하는 정확한 날짜선택 항목에 의도한 여정만 포함되어 있나요?
GPS 필터기본적으로 보수적 설정JSON을 변경하지 않고 고립된 급등값이 제거되었나요?
로컬 카메라안정적인 움직임지도가 빠르게 앞뒤로 움직이지 않나요?
장거리 경로대권 보간비행 경로가 지구를 자연스럽게 가로지르나요?
출력MP4 및 선택적 개요 이미지완성된 파일이 원본 데이터와 분리되어 저장되었나요?

Android

호환되는 Android 기기에서 네이티브 모바일 workflow로 여정을 직접 렌더링할 수 있습니다.

iPhone

Safari 기반 웹 앱을 사용하면 기존 방식으로 설치하지 않고도 선택한 파일을 처리할 수 있습니다.

Desktop

Python workflow에서 FFmpeg를 사용하여 로컬 멀티스레드 동영상 컴파일을 수행할 수 있습니다.

Hybrid

기록 관리를 위해 영구 저장소를 사용하고, 선택한 영화 같은 내보내기에는 비주얼라이저를 사용하세요.

권장 렌더링 방법

먼저 미리보기한 다음 렌더링하세요. 짧은 미리보기를 통해 잘못된 날짜, GPS 급등값, 어색한 카메라 움직임 또는 의도보다 많은 개인정보가 포함된 경로를 확인할 수 있습니다.

개인정보, 지도 및 로컬 처리

개인정보 보호는 로컬 Google Timeline 비주얼라이저를 사용하는 핵심적인 이유입니다. 애플리케이션이 좌표를 파싱하고 동영상을 생성하는 동안 Timeline 파일을 기기에 그대로 보관할 수 있습니다. 이는 전체 이동 기록을 원격 서버에 업로드하도록 요구하는 서비스와는 다릅니다.

로컬 처리라고 해서 workflow의 모든 부분이 오프라인으로 작동하는 것은 아닙니다. 지도 배경에는 일반적으로 타사 제공업체의 래스터 타일이 필요합니다. Timeline JSON 자체를 업로드하지 않더라도 각 타일 요청을 통해 현재 조회 중인 대략적인 지역이 공개될 수 있습니다.

구성 요소로컬 또는 네트워크개인정보 영향
Timeline JSON로컬 파일상세한 이동 기록을 포함하므로 비공개로 유지해야 합니다
좌표 파싱로컬 처리계정에 접근하지 않고 기록을 변환합니다
경로 필터링로컬 처리원본을 수정하지 않고 시각적 하위 집합을 만듭니다
기본 지도 타일네트워크 사용타일 요청을 통해 조회한 지리적 지역이 드러날 수 있습니다
최종 MP4로컬 파일공유할 경우 경로, 날짜 및 장소가 노출될 수 있습니다

지도를 불러오기 전에 애플리케이션의 개인정보 보호 안내를 읽고 기본 지도 사용에 따른 절충이 허용 가능한지 판단하세요. 프로젝트에서 타일 요청 전에 취소할 수 있는 방법을 제공한다면, 경로가 타사 지도 서비스에 사용하기에 너무 민감한 경우 해당 기능을 사용하세요.

완성된 동영상 자체도 검토해야 합니다. 경로 애니메이션은 집, 직장, 병원 방문, 규칙적인 생활 패턴 또는 비공개 여행 날짜를 노출할 수 있습니다. 로컬에서 렌더링한 파일이라도 소셜 네트워크에 업로드하거나 다른 사람에게 전송하면 민감한 정보가 될 수 있습니다.

안전하게 공유하기

MP4를 공유하기 전에 다음을 확인하세요.

  • 집이나 일상적인 생활 패턴이 드러나는 구간을 삭제하거나 줄이세요.
  • 정확한 여행 날짜가 포함된 동영상을 공개적으로 업로드하지 마세요.
  • 시작 화면과 마지막 개요 화면에 민감한 위치가 표시되는지 확인하세요.
  • 동영상이 무해해 보이더라도 원본 JSON은 비공개로 유지하세요.
  • 가족 또는 개인 보관용으로 공유할 때는 비공개 전송 방법을 사용하세요.
네트워크 주의 사항

Timeline 파일은 로컬에 남아 있을 수 있지만 지도 타일은 여전히 네트워크를 통해 전송됩니다. 민감한 여정을 불러오기 전에 타일 제공업체의 정보 공개 내용을 검토하세요.

문제 해결 및 장기 보관

대부분의 문제는 지원되지 않는 파일 구조, 노이즈가 있는 좌표, 희소한 경로 또는 출력 관리 실수라는 네 가지 범주에 속합니다. 대규모 렌더링이 끝날 때까지 기다리지 않고 문제를 분리할 수 있도록 작은 날짜 범위부터 시작하세요.

파일이 로드되지 않는다면 체크섬, 압축 파일 또는 관련 없는 Google Takeout 파일이 아닌 실제 JSON 내보내기 파일을 선택했는지 확인하세요. 경로의 일부만 나타난다면 현재 비주얼라이저가 해당 내보내기 스키마를 지원하는지 확인하세요. 이전 Timeline 형식과 최신 Timeline 형식에는 서로 다른 파싱 로직이 필요할 수 있습니다.

문제가능한 원인실용적인 대응
파일이 로드되지 않음잘못된 파일 또는 지원되지 않는 스키마내보내기 파일을 다시 확인하고 더 작은 복사본으로 테스트합니다
경로가 멀리 튐GPS 이상값보수적인 필터링을 활성화하고 다시 미리 봅니다
비행 경로가 직선으로 표시됨위치 지점이 부족함가능하다면 대권 보간을 사용합니다
지도가 표시되지 않음타일 요청이 차단되었거나 거부됨개인정보 안내와 네트워크 접근을 검토합니다
동영상이 불완전함렌더링이 취소되었거나 중단됨부분적으로 생성된 파일을 삭제하고 새로 렌더링합니다
동영상이 잘못된 위치에 저장됨저장 제공업체의 동작앱의 출력 폴더 또는 저장 대화 상자를 확인합니다

장기 보관을 위해 다음 세 가지 자산을 분리하여 보관하세요.

  1. 원본 Timeline 내보내기 파일
  2. 선택한 날짜와 설정을 기록한 처리 메모
  3. 최종 MP4 또는 개요 이미지

비주얼라이저는 프레젠테이션에 유용하지만 영구적인 공간 데이터베이스는 아닐 수 있습니다. 지속적인 추적, 전체 기간의 히트맵 또는 검색 가능한 지리 분석이 필요한 사용자는 자체 호스팅 위치 플랫폼을 선호할 수 있습니다. 이러한 환경에서는 영구 공간 데이터베이스가 기록을 저장하고, 비주얼라이저는 선별된 렌더링 도구로 사용됩니다.

Timeline 동영상을 공유하기 전에:

  • 원본 Timeline JSON의 변경하지 않은 복사본을 보관했는지 확인
  • 선택한 날짜와 경로 경계를 확인
  • 미리보기에서 GPS 필터링과 카메라 움직임을 검토
  • 최종 개요 화면에 집과 직장 위치가 표시되는지 확인
  • MP4를 비공개 원본 데이터와 분리하여 저장
보관 메모

완성된 각 MP4 옆에 날짜 범위, 필터링 모드, 카메라 스타일 및 렌더러 버전을 기록하세요. 이러한 메모가 있으면 나중에 같은 결과를 재현하기가 훨씬 쉬워집니다.

Google Timeline Visualizer FAQ

Q: GitHub의 Google Timeline 비주얼라이저란 무엇인가요?

내보낸 Google 위치 기록 데이터를 읽고 선택한 여정을 애니메이션 지도 동영상으로 변환하는 오픈 소스 스타일의 유틸리티입니다. 실시간 계정 연결이 아니라 과거 기록을 파일 기반으로 처리하는 workflow입니다.

Q: 비주얼라이저가 내 Timeline JSON을 업로드하나요?

로컬 우선 workflow에서는 기기에서 JSON을 파싱하고 렌더링할 수 있습니다. 그러나 지도 배경에는 네트워크 타일 요청이 필요할 수 있으므로 민감한 경로를 불러오기 전에 애플리케이션의 개인정보 보호 안내를 검토하세요.

Q: 내 경로에 불가능한 급격한 이동이 포함되는 이유는 무엇인가요?

GPS 기록에는 신호 약화, 실내 위치 측정 또는 일시적인 좌표 오류로 인해 발생한 고립된 이상값이 포함될 수 있습니다. 보수적인 필터링을 사용하면 원본 JSON은 그대로 유지하면서 렌더링된 동영상에서 비현실적인 급등값을 제외할 수 있습니다.

Q: 지속적인 추적을 위해 Google Timeline을 대체할 수 있나요?

아니요. 비주얼라이저는 기존 내보내기 파일에서 동영상을 생성합니다. 지속적인 추적, 영구 저장, 히트맵 및 장기 분석에는 별도의 위치 기록 시스템이 필요합니다.

최종 권장 사항

스토리텔링과 검토에는 비주얼라이저를 사용하고, 원본 내보내기 파일은 비공개로 유지하세요. 지속적인 기록 관리가 필요하다면 영구적으로 사용할 수 있는 자체 호스팅 도구를 선택하세요.