Google Timeline Visualizer Python：セットアップガイド

デスクトップ版の Python バージョンは、Google Maps Timeline のエクスポートデータを扱うローカルレンダリングツールです。保存された Timeline.json ファイルを読み込み、位置情報のポイントとルート情報を解釈して、アニメーション地図動画を生成します。これにより、Timeline ドキュメントを第三者のアプリケーションにアップロードせず、過去の旅行を確認できます。

このツールは、ライブ追跡サービスではなく、過去の記録を振り返るためのレンダラーとして理解するのが適切です。新しい移動情報を継続的に収集したり、Google アカウントに接続したり、暗号化された Timeline バックアップを復元したりすることはありません。まず Google Maps で履歴を準備・復元し、ファイルをエクスポートしてから、ビジュアライザーで動画を作成してください。

動画の主な特徴：

• 分割された複数の Google Timeline エクスポート形式をローカルで解析
• 孤立した GPS 外れ値を保守的にフィルタリング
• 長距離フライトや疎なルート向けの大円補間
• 地図の揺れを抑える安定したカメラ移動
• デスクトップ Python ワークフローによるローカル動画レンダリング

レンダラーを起動する前に、必要なデスクトップツールをインストールし、Timeline のエクスポートファイルを見つけやすい場所に配置してください。文書化されているデスクトップワークフローには、Python 3.9 以降、FFmpeg、requirements.txt に記載されたパッケージが必要です。

入力ファイルは Google Maps からエクスポートするか、エクスポート前に Google Maps で復元しておく必要があります。ビジュアライザーは Google の暗号化されたモバイルバックアップを直接開くことも、アカウントにアクセスして失われた履歴を復旧することもできません。

文書化されているコマンドのパターンは次のとおりです。

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

この例では、プロジェクトの手順にある 2025 年の年フィルターを使用しています。現在の 2026 年のワークフローでは、可視化したいエクスポートデータに合う年または日付範囲を選択してください。プロジェクトのバージョンで追加の日付引数が公開されている場合は、ローカルのヘルプ出力で正確な構文を確認してください。

Google Timeline のエクスポート形式は、端末、アカウント履歴、エクスポートの世代によって異なる場合があります。ビジュアライザーは、すべてのファイルが単一の座標スキーマを使用すると仮定するのではなく、複数の構造を正規化するよう設計されています。

対応する入力には、現在の直接配列形式のエクスポート、semanticSegments を使用する古いファイル、パス、アクティビティ、訪問履歴、オプションの生の位置情報が含まれます。座標値は、文字列、latLng 値、度数フィールド、geo: 文字列、または E7 整数座標として現れる場合があります。

デフォルトの GPS 設定は、保守的な GPS 外れ値フィルタリングです。急なスパイクや誤った迂回を生じさせる可能性がある、孤立した不自然な往復ポイントを無視します。この方法は、元のデータを書き換えることなく、読みやすさを向上させることを目的としています。

記録されたすべてのポイントが重要な場合は、フィルタリングを無効にできます。技術的な検証には便利ですが、Timeline に建物周辺、信号の弱い場所、一時的な測位エラーによる GPS の揺れが含まれていると、アニメーションが不安定になる可能性があります。

長距離フライトなどの疎なルートでは、レンダラーは大円補間を使用します。平面地図上に見た目の悪い直線を描くのではなく、球面上の最短経路に沿ってルートを表示します。これは、国際日付変更線をまたぐ移動に特に役立ちます。

カメラにも安定した移動モデルが使用されています。地図を固定したまま、マーカーが中央の表示領域内を移動できます。マーカーが境界に到達すると、カメラが追従を開始します。これにより、近距離の通勤などでカメラが素早く前後にパンするのを抑えられます。

ファイルを読み込んだら、プレビューの前に移動期間、カメラ移動、距離単位を選択します。インタラクティブなプレビューによって、欠落したポイント、不要な GPS スパイク、目的の動画には広すぎるルートを確認できます。

保存される動画では選択したデザインが使用され、レンダリング前に地図タイルが準備されます。Android では、関連アプリが完成した MP4 ファイルを専用の動画フォルダーに保存します。一方、元のデスクトップワークフローでは、プロジェクトの出力動作とローカル権限に応じて結果が書き出されます。

Python ワークフローでは、最初のレンダリング中はエラーを確認できるよう、ターミナルを開いたままにしてください。短いテストにより、依存関係の不足、利用できない FFmpeg コマンド、不正なパス、想定されるエクスポート構造と一致しない入力ファイルなどを発見できます。

アプリケーションのエコシステムには、完成した MP4 ファイル、サムネイル、タイトル、期間、再生時間、作成日を管理するローカル動画ライブラリも含まれます。ライブラリの外で動画を移動または削除すると、その項目を利用できなくなる場合があります。リストから項目を削除することと、元のファイルを完全に削除することは別の操作です。

プライベートな旅行記録の場合は、共有する前に完成した動画を確認してください。元の JSON がコンピューターから外部に出ていなくても、ルートアニメーションから自宅、職場、定期的な通勤経路、通院先、その他の機密性の高い場所が分かる可能性があります。

ローカルファーストの設計により、処理中の Timeline JSON は端末内に保持されます。ただし、地図の背景には外部のタイルリクエストが必要です。文書化されているプライバシー説明では、OpenStreetMap の地図データを使用するベースマップ提供元として CARTO が示されています。表示する地域へのリクエストによって、閲覧している地域がその提供元に知られる可能性があります。

最初の地図タイルが読み込まれる前に、プライバシー通知を確認し、そのトレードオフが用途に適しているか判断してください。ローカル処理によって履歴全体をアップロードする必要性は減りますが、すべてのネットワーク通信が見えなくなるわけではありません。

永続的な保存を求めるユーザーは、ビジュアライザーとセルフホスト型の位置情報データベースを区別する必要があります。ビジュアライザーは一時的なツールであり、データを読み込み、動画をレンダリングし、過去の記録を振り返るために使用します。セルフホスト型の空間システムは、位置情報履歴を継続的に保存し、長期的な分析を支援するという別の目的を持ちます。

実用的なハイブリッド方式として、継続的な記録はプライベートなシステムで管理し、映画的なエクスポートが必要な場合だけビジュアライザーを使用する方法があります。移行ユーティリティは、重複するエクスポートを統合したり、独自形式をより汎用的な地理フォーマットに変換したりするのにも役立ちますが、機密データを預ける前に各ツールを確認してください。

ソフトウェア開発については、リポジトリにデスクトップ版と Android プロジェクトの両方に関するテストおよびビルド手順が含まれています。Python の開発用依存関係は python -m pip install -r requirements-dev.txt でインストールし、その後プロジェクトのテストコマンドを実行できます。Android のビルド要件は Python ワークフローとは別です。

実装の詳細については、Google Timeline Visualizer GitHub リポジトリを参照してください。リポジトリには、対応ワークフロー、インストールに関する注意事項、プライバシー動作、ビルドコマンド、MIT ライセンスについて記載されています。