使い方ガイド

このアプリでできること

Googleマップに保存した「保存済みの場所」や「クチコミ（レビュー）」のデータを取り込み、 都道府県別・カテゴリー別に一覧・地図・グラフで可視化するツールです。データはすべてブラウザ内だけで処理され、 サーバーには一切送信されません。

STEP 1: Google Takeoutでデータを取得する

まずは元になるデータを、Google Takeoutからダウンロードします。

1. アプリのアップロード画面にある「Google Takeoutでデータを取得する」リンクから、Takeoutのページを開きます。
2. いったん「すべてのデータの選択を解除」した上で、「マップ（マイプレイス）」にだけチェックを入れます。
3. 画面の指示に従ってエクスポートを実行します（ファイル形式はJSON推奨）。
4. 準備ができるとダウンロードリンクがメールで届くので、zipファイルをダウンロード・解凍します。
5. 解凍したフォルダの中から、Saved Places.json（保存済みの場所）やReviews.json（クチコミ）を探します。

※ Google Takeoutは一度に多くの件数をエクスポートできない場合があります（特にクチコミは直近600件程度が上限になることがあります）。 漏れてしまったクチコミは、アプリ内の「ログを手動で追加」機能で個別に追加できるほか、件数が多い場合の方法は下記の「よくある質問」でも紹介しています。

STEP 2: アプリにデータを読み込む

取得したファイルを、アップロード画面にドラッグ＆ドロップするか、「ファイルを選択する」ボタンから選んでください。 JSON・GeoJSON・CSVのいずれの形式にも対応しています。複数ファイルを一度に読み込むこともできます。

操作感を先に試したいだけの場合は、「サンプルデータをロード」ボタンから15件のダミーデータで一覧・地図・グラフを確認できます。

STEP 3: 一覧・地図・グラフを見る

• スポット一覧: 名前・住所・評価・クチコミなどを一覧表示。名前や住所での検索、都道府県・カテゴリー・評価・日付での絞り込みができます。
• インタラクティブ・マップ: 絞り込んだ結果を地図上にピン表示。一覧の地図アイコンから該当スポットへジャンプできます。
• グラフ: カテゴリー比率（ドーナツ）と都道府県別件数（棒グラフ）を表示します。

STEP 4: カテゴリー・都道府県を調整する

一覧には「Google連動カテゴリー」（自動判定、または後述のGemini取得による実データ）と、 「マイカテゴリー」（自分で自由に上書きできる項目）の2列があります。マイカテゴリー欄のドロップダウンから、 自分だけの分類（例:「よく行く店」）を選んで割り当てられます。マイカテゴリー自体は「マイカテゴリー設定」ボタンから作成・削除できます。

ヘッダーの「Google連動カテゴリーをGeminiで調べる」ボタンからは、Geminiにスポット名・住所だけを渡して業種を判定してもらい、 より細かいカテゴリー情報を取り込むこともできます（評価やクチコミ本文は送信されません）。

STEP 5: バックアップする（JSON / CSV エクスポート）

ヘッダーの「JSONエクスポート」「CSVエクスポート」から、現在のデータをダウンロードできます。

• JSON: 完全なバックアップ用。マイカテゴリーの色情報なども含めて、一切データを失わずに復元できます。
• CSV: Excel等で見る・一括編集するための出力です。人間には読みやすい一方、まだ一度もアプリ上で作っていない独自マイカテゴリー名などは、再読み込み時に復元できないことがあります（未登録の場合はインポート後にアプリが警告します）。

データを完全な形で保全したい場合は、必ずJSONエクスポートを使ってください。

STEP 6: データを保存する（このデバイス／Googleドライブ）

ヘッダーの「このデバイスにデータを保存」トグル（初期値ON）がONの間は、編集内容がこの端末のブラウザ内に自動的に保存され、 次回このアプリを開いたときにファイルの読み込み無しでそのまま続きから見られます。共有のパソコン等でデータを残したくない場合はOFFにしてください （OFFにすると、それまでに保存されていたデータもこの端末から削除されます）。

ただし、これはあくまでこの端末だけの保存です。別のブラウザ・別の端末からもデータを見たい場合は、 「Googleドライブと連携」からご自身のGoogleアカウントでログインし、「Driveに保存」ボタンでデータをGoogleドライブに保存してください。 次回、別のブラウザ・別の端末で同じアカウントを連携すると、保存したデータが自動的に読み込まれます。

⚠️ Googleドライブへの自動保存機能はありません。「Driveに保存」を押さずにタブを閉じると、Driveへの保存に関しては その時点までの変更が反映されません（保存し忘れた状態で閉じようとすると、確認メッセージが表示されます）。

よくある質問

Q. データはどこかのサーバーに送られていませんか？

A. 送られていません。すべての処理はブラウザ内で完結します。詳しくはプライバシーポリシーをご覧ください。

Q. ページをリロードしたらデータが消えました

A. 想定通りの挙動です。本アプリはブラウザのメモリ上でのみデータを保持するため、事前にJSONエクスポートまたはGoogleドライブへの保存が必要です。

Q. CSVで入力したマイカテゴリーが反映されません

A. そのカテゴリー名がアプリ側でまだ一度も作られていない場合、色情報がないため復元できません。先に「マイカテゴリー設定」で同じ名前のカテゴリーを作成してから、CSVを読み込み直してください。

Q. クチコミをつけたお店が600件を超えています。どうすればいいですか？

A. Google Takeoutで一度にエクスポートできるのは直近600件程度までのため、それより古いクチコミはTakeoutのファイルには含まれません。 1件ずつ「ログを手動で追加」から入力してもよいですが、件数が多い場合は次の流れがおすすめです。

1. ヘッダーの「スポット情報をGeminiで調べる」から、うろ覚えの店名・都道府県などの手がかりを1行1件（最大30件）まとめて入力し、プロンプトを生成してGeminiに実行してもらいます。
2. 返ってきた結果をアプリに貼り戻すと、正式名称・住所・緯度経度・業種の候補が表示されるので、該当するものを選んで追加します（評価・クチコミ本文・投稿日はGeminiには分からないため空欄で追加されます）。
3. まとめて追加した後は、ヘッダーの「ログを手動で追加」モーダル内にある「CSVでエクスポート」機能で手動入力データだけを書き出し、Excel等で評価・コメント・投稿日をまとめて入力してから「CSVから読み込む」で反映すると、1件ずつ編集するより効率的です。

この方法なら、Takeoutの上限に関係なく、Googleマップ上に実際にクチコミした店舗をご自身の記憶を頼りに何件でも追加していけます。

もっと詳しく知りたい場合

本アプリはオープンソースで開発されています。より詳しい仕様や既知の制約については、 GitHubリポジトリをご覧ください。