Google タイムライン ビジュアライザーのソースコード：セットアップガイド

GitHub の Google Timeline Visualizer リポジトリ は、エクスポートした Google マップのタイムラインファイルをアニメーション旅行動画に変換する、ソースコードが公開されたプロジェクトです。一般的なゲームやエンターテインメントプラットフォームではありません。主な目的は、ローカルでのタイムライン処理、アニメーション地図の描画、MP4 の作成、そしてプライバシーに配慮したファイル処理です。

このプロジェクトには、Android アプリ、iPhone ウェブアプリ、元となるデスクトップ版 Python ジェネレーターが用意されています。これらのバージョンでは、基本的に同じワークフローを使用します。タイムラインデータをエクスポートし、期間を選択し、ルートをプレビューして、動画をレンダリングします。

ビジュアライザーを使用するには、エクスポートしたタイムラインファイルが必要です。iPhone では、Google マップの プロフィール写真 → 設定 → 個人的なコンテンツ → タイムラインデータをエクスポート からデータをエクスポートします。作成された Timeline.json ファイルを「ファイル」アプリに保存し、Safari から選択してください。

Android では、Google マップ内から直接ではなく、スマートフォンの「設定」アプリを使用してエクスポートします。設定 → 位置情報 → 位置情報サービス → タイムライン を開き、タイムラインデータをエクスポート を選択して、Downloads などのアクセスしやすい場所にファイルを保存します。

このソースコードは、現在の Android および iOS の直接配列形式のエクスポートに加え、semanticSegments 構造を使用する古いファイルにも対応しています。また、文字列値、latLng、度数ベースの値、geo: 座標、E7 座標など、複数の座標表現を認識できます。

対応するルートデータには、次のようなものがあります。

• タイムラインの経路
• アクティビティ
• 訪問
• まばらな長距離ルート
• 国際日付変更線をまたぐルート
• 警告とローカルでのノイズ低減を伴う、オプションの生の位置情報

公式のエクスポートおよび復元方法については、Google マップのタイムライン ヘルプを参照してください。このガイドでは 2026 年 8 月 25 日に内容を確認しています。

最も簡単なワークフローは、JSON ファイルを準備し、日付範囲を選択し、ルートをプレビューして、MP4 を作成する方法です。正確なメニュー名はスマートフォンの機種によって多少異なる場合がありますが、プロジェクトの基本的な手順は共通しています。

レンダリング中は、より古い移動履歴が移動するマーカーの後ろで徐々に薄く表示されるため、長期間のタイムラインでも追いやすくなります。長距離のフライトを含むまばらなルートは、大円航路に沿って補間されます。近距離の移動では、カメラがマーカーを追従する前に、マーカーを安定した中央エリア内に保つことができるため、通勤などでカメラが急激に動くのを抑えられます。

完成した動画の最後には、全ルートを表示する 1.5 秒間のズームアウト演出が追加され、全体図が短時間保持されます。Android 10 以降では、完成したファイルは Movies/Timeline Visualizer に保存されます。Android 8 および 9 では、システムの「名前を付けて保存」ピッカーが使用されます。

Python ベースの処理を好むユーザー向けに、元のデスクトップジェネレーターも引き続き利用できます。文書化されている要件は、Python 3.9 以降、FFmpeg、および requirements.txt に記載されたパッケージです。

基本的な依存関係のセットアップは次のとおりです。

python -m pip install -r requirements.txt

リポジトリのドキュメントには、visualizer.py、入力するタイムラインファイル、選択した年、カメラ移動オプションを使用した Python の実行例も記載されています。

python visualizer.py --input Timeline.json --year 2026 --camera-movement steady

このコマンドを開始点として使用し、大規模なバッチ処理をスクリプト化する前に、現在のリポジトリで利用できる引数を確認してください。ファイルパス、日付の選択、利用可能なオプションは、チェックアウトしたリビジョンに合わせる必要があります。

Android 開発向けに文書化されているツールチェーンには、JDK 17、Android SDK Platform 36、Build Tools 36.0.0 が含まれます。リポジトリのテスト手順では、Android の検証と Python 依存関係のインストール、pytest の実行を組み合わせています。

参照したドキュメントでは、Android アプリは Google Play ではなく、リポジトリのリリースを通じて配布されています。APK を直接インストールする場合は、リポジトリからリリースアセットをダウンロードし、インストールパッケージを選択する際にチェックサムファイルを避けてください。この配布方法では、Android によって Google Play 外からのインストールに関する警告が表示される場合があります。

プライバシーは、このプロジェクトの設計における中心的な要素です。タイムライン JSON ファイルはアップロードされません。プロジェクトで説明されているネットワーク依存機能はベースマップのみです。CARTO は表示された地図エリアへのリクエストを受け取り、OpenStreetMap データに基づくタイルを提供します。

つまり、ルートファイルとマップタイルは分けて考える必要があります。

アプリは完成した動画用に小さなローカルインデックスを保持します。エントリには、サムネイル、タイトル、タイムラインの期間、再生時間、作成日などを含めることができます。リストから削除 は MP4 に影響を与えません。一方、動画を削除 は別の確認付き操作であり、ストレージプロバイダーが許可する場合はファイルを完全に削除できます。

ワークフローが失敗した場合は、次のトラブルシューティング手順を使用してください。

• タイムラインメニューが見つからない場合は、スマートフォンの位置情報設定を確認し、Google の最新のヘルプ表示を参照してください。
• ファイルを再度開けない場合は、ファイルが移動されていないことと、ストレージ権限が引き続き利用できることを確認してください。
• 古い旅行が表示されない場合は、Google マップで履歴を復元して、新しい JSON ファイルをエクスポートしてください。
• プレビューが不安定に見える場合は、GPS フィルタリングとカメラ移動の設定を確認してください。
• APK をインストールできない場合は、Android のバージョンを確認し、選択したブラウザーまたはファイルマネージャーからのインストールを一時的に許可してください。