Viva Camino JP 取扱説明書

1. はじめに・全体の流れ

Viva Camino JP は、カミーノの行程計画・地図・宿・旅仲間との交流をひとつのアプリで行える PWA です。 ブラウザで viva-camino.com を開き、ログインして使います。

本サービスは Vivecamino（vivecamino.com）とは無関係の独立プロジェクトです。

ログイン後の順番: プロフィール → 行程プラン → 冒険・地図・掲示板…

2. ホーム画面に追加（PWA）

スマホで旅の途中から素早く開くには、ホーム画面への追加がおすすめです。

3. ログイン・新規登録

トップの 「無料で始める」 からログイン画面へ進みます。

Google でログイン

• 別タブで Google 認証が開きます。完了後、この画面に戻ると自動で反映されます。
• Google 画面に「supabase.co に移動」と表示されることがあります。認証の仕組み上、正常な動作です。ログイン後は viva-camino.com に戻ります。
• 掲示板などは Supabase 経由で他の端末とも同期されます。

メールで新規登録・ログイン

• メールアドレスとパスワードを入力し、新規登録 または ログイン を押します。
• データは主に端末内（ブラウザ）に保存されます。端末を変えると別アカウント扱いになる場合があります。

4. 最初にやること（プロフィール＋行程）

ログインしたら、この2つを先に終わらせてください。 プロフィールが空のままだと掲示板にメールアドレスだけ表示され、行程がないと冒険・道のりにルートが出ません。

① プロフィールを書く（ギルド）

1. 画面下部メニューで ギルド をタップする。
2. 上部サブメニューで プロフィール を選ぶ（初期は「掲示板」が開いているので切り替え）。
3. ニックネーム を入力する（推奨・事実上必須）。 掲示板の投稿者名・画面上部の表示名になります。入力後、欄外をタップすると自動保存されます。
4. 歩行速度（km/h） を入力する（推奨。例: 4）。 冒険 タブの「想定到着時刻」に使います。空のままだと時刻は出ません。
5. 任意: アバター（ホタテ等）を1つ選ぶ、写真をアップロードする、性別・年代・出身地・ひとことを入れる。
6. 任意: プロフィール設定の下で 仲間の位置・友だちと日記・友達登録用 QR も利用できます（11章）。

② クエストで行程を作る

自分の「何日目にどこからどこまで歩くか」を登録します。ベーシックプラン（公式行程）を土台にコピーするのがいちばん簡単です。

1. 画面下部メニューで クエスト をタップする。
2. サブメニュー 行程 が選ばれていることを確認する。
3. プランソース で「ベーシックプラン」（または参考にしたい「モデルプラン」）を選ぶ。
4. プランにコピー ボタンを押す。 ベーシック行程が「MYプラン」として読み込まれます。
   ボタンが押せない場合 → アプリを再読み込みしてください。管理者の共有データがまだ入っていない可能性があります（ギルド → 瓦版の「心得」参照）。
5. 日を選択（1日目、2日目…）のプルダウンで、編集したい日を選ぶ。
6. その日の 出発地 と 到着地 をプルダウンで選ぶ。 下に「町から町までの距離（km）」が表示されます。
7. 歩行日数が足りなければ + 日を追加、減らすなら − 日を削除。
8. いま歩いている日（＝冒険で見たい日）を、日選択プルダウンで合わせる。 1日目 を選ぶと「今日のプラン」と表示されます。

できたか確認する

• ☐ ギルド → プロフィールにニックネームが入っている
• ☐ 歩行速度（km/h）を入れた（到着予想を使う場合）
• ☐ クエスト → 行程で「プランにコピー」済み
• ☐ 1日目（または今日の日）の出発・到着の町が設定されている
• ☐ 冒険 タブを開くと、今日の区間・距離が表示される

ここまで終われば、地図・掲示板・日記など他の機能を使えます。Buen Camino!

5. メニュー（5つのタブ）

ログイン後、画面下部（または上部）のメニューでタブを切り替えます。表示名は RPG 風のラベルです。

5b. 迷える旅人（ヘッダーメニュー）

ヘッダー右下の 迷える旅人 をタップすると、各画面へのショートカットと説明が一覧表示されます。 RPG 風テーマではバナー画像の右下に重なって表示されます。

主なリンク（2026年5月時点の配置）:

• 冒険 — 今日のプラン・残り km・到着予想
• 道のり — 地図・現在地・オフライン保存
• クエスト — 行程 / 拠点・宿 / 実績
• ギルド — 掲示板 / 瓦版 / プロフィール（仲間の位置・友だち・QR）
• 記録 — 冒険の記録（日記・出納帳）/ 個人メモ帳 / 装備

6. 冒険 — 今日の巡礼

クエストで行程を作ったあとに見る画面です。 クエストで選んでいる「日」と連動し、1日目＝今日のプランとして表示されます。

• 今日のプラン — 何日目か、出発・到着の町、距離
• 現在のステータス — 位置情報を許可すると、ルート上の進み具合を表示
• 今日のルート — 簡易地図と標高グラフ（GPX データがある区間は詳細表示）

7. クエスト — 行程・宿・実績

基本的な作り方は 4. 最初にやること を参照。 ここでは追加機能を説明します。

サブメニューは 行程・拠点・宿・実績 の3つです。

行程タブ（MYプラン）

• 現在地を取得 — 位置情報を許可すると、次の町までの距離を表示
• 今日の町（宿泊施設） — 区間内の町名をタップすると「拠点・宿」サブタブへ
• 上部の進捗バー — 全体の累積 km と残り km

拠点・宿タブ

• 宿泊施設データがある区間で、アルベルゲ等の一覧・詳細を表示
• 「地図で見る」で道のりタブへ

実績タブ

• クエスト → 実績 — 距離・日記・装備・掲示板投稿など、旅の節目で解除される達成バッジ（メダル風カード）一覧
• 未達成の条件も各カードで確認できます

8. 道のり — 地図

Leaflet 地図でルートと施設を表示します。

• 今日のルート — 一覧と地図。現在地を許可すると位置が反映
• 全行程 — ベーシック全体を地図上に表示（データがある場合）
• ルート未設定時は、クエストで行程を作るよう案内が出ます

オフラインで地図を使う

現地で通信圏外になってもルートと地図を見られるように、表示中の範囲を端末に保存できます。 出発前に Wi‑Fi 環境で実行してください。

1. 道のりタブを開く
2. 歩く区間が画面に入るように地図を移動・ズーム
3. 「📦 オフライン保存」ボタンを押す
4. 最小・最大ズーム（既定 12〜15）を確認し「ダウンロード開始」
5. 完了後は機内モードでも背景地図ごと閲覧可

歩きながら見るズームの目安

オフライン保存の「最小・最大ズーム」は、下の地図に今表示されている範囲を、 どの拡大レベル（地図の＋−に相当）まで細かく保存するかを指定します。 数が大きいほど詳細になり、タイル数（ダウンロード量）が増えます。

• 11 — かなり引き。1日全体のざっくり確認向け。道の細部は粗め
• 12〜13 — 周辺 1〜2 km 程度が見える。最小ズームの目安。ルートと次の町の位置関係
• 14〜15 — 道・宿・分岐がはっきり。最大ズームの目安。歩きながらの確認に向く
• 16 以上 — かなり詳細だがタイル数が急増。村の中だけ保存するときなど

歩きながら見る用途では、最小 12・最大 15（アプリの初期値）がバランスのよい目安です。 広い区間を一度に保存する場合は最大を 14 に下げ、宿の位置を細かく見たい区間だけ 15〜16 にするとよいでしょう。

9. ギルド — 掲示板・瓦版

プロフィールの書き方は 4. ① プロフィールを書く を参照。 旅仲間との交流が中心のタブです。

掲示板

• 誰でも閲覧・投稿できる公開掲示板（写真最大4枚）
• カテゴリ選択、いいね、返信、並び替え
• 「みんなの装備を見る」で他ユーザーの装備表を参照

瓦版

• ギルド → 瓦版 — 公式お知らせ（号外）、旅の先人、心得、案内所リンク
• 開発者へ便り — 不具合・要望
• 寄進（Stripe）— 任意の応援

プロフィール

ニックネーム・歩行速度・言語などの設定のほか、下に次の機能があります。

• 仲間の位置 — 位置共有を ON にして仲間の地図表示（道のりタブ）
• 友だちと日記 — メールまたは QR で友だち追加、「日記を見せる」許可
• 友達登録用 QR コード — 対面で友だち登録

詳しくは 11. 友だち QR・日記の共有 を参照。

9. 装備リストの書き方（記録）

カミーノの持ち物を登録し、合計重量を確認できます。登録した内容は掲示板の「みんなの装備」にも載ります。

1. 下部メニュー 記録 → サブメニュー 装備 を開く。
2. 装備名 を入力する（例: レインジャケット、寝袋、サンダル）。
3. カテゴリ を選ぶ — 基本装備 / 衣類 / 雨具 / ケア用品 / その他。
4. 重さ（g） を入力する（グラム単位。例: 300）。 一覧の下に 合計重量 が自動表示されます。
5. 任意: Amazonリンク を貼る（商品ページの URL）。 一覧に「Amazon」ボタンが付き、タップで開けます。
6. 装備を追加 を押す。リストに1行追加され、自動保存されます。

あとから直す・消す

• 各行の 編集 → 名前・カテゴリ・重量を変更 → 保存
• 削除 でリストから除去

みんなの装備を見る

ギルド → 掲示板 サブタブ上部の 「みんなの装備を見る」 を押すと、他の利用者の装備表が開きます。ニックネームをタップすると詳細が展開されます。

10. 記録 — 日記・装備

冒険の記録（日記）

• 記録 → 冒険の記録 →「日記を書く」でタイトル・気分・本文・写真（最大2枚）
• 一覧から日記を開くと 編集・削除 ができます（自分の日記のみ）
• 出費の記録（出納帳）は 日記の出納帳 を参照
• 友だちの日記を見る手順は 友だち QR・日記の共有（ギルド → プロフィール。出費は友だちに見えません）

個人メモ帳

• 記録 → 個人メモ帳 で、タイトルと本文のメモを自由に記録（端末にのみ保存）
• 日記・掲示板とは別です。予約番号や覚えておきたいこと向け

装備

登録方法は 装備リストの書き方 を参照。

• 記録 → 装備 サブタブで自分のリストを管理
• ギルド → 掲示板の「みんなの装備を見る」で他ユーザーの装備表も参照

10b. 日記の出納帳（2つの財布・円換算）

日記にその日の出費を付けられる機能です。現金用・カード用など、2つの財布に分けて記録し、財布ごとと合計をユーロ（€）で表示します。 場所は 記録 → 冒険の記録（「日記を書く」の下に 日別の出納一覧 があります）。

出費を付けて日記を書く・直す

1. 記録 → 冒険の記録 → 日記を書く
2. タイトル・気分・本文のあと、写真を追加（最大2枚）
3. その下の 今日の出納帳 で 出費を追加 → 項目名と金額（ユーロとして記録）
4. タブまたはプルダウンで 財布1／財布2 を選んで記入
5. ブロック下部に 財布ごとの小計 と 合計（両方） が表示されます
6. 保存後、日記一覧の行に出費合計（€、レート設定時は円の目安も）が出ます
7. 既存の日記は一覧から開き 編集 で出費も修正できます

出納帳の設定（日別の出納一覧の上）

日別の出納一覧 カード内の 出納帳の設定 で、次を変更できます（この端末のプロフィールに保存され、次回ログイン後も残ります）。

• 財布1・財布2の名前 — 空欄のままなら「財布 A」「財布 B」。例: 「現金」「クレカ」
• 1ユーロ = （　）円 — 手入力のレート。一度保存すれば、出納帳・日別一覧・日記一覧に 円の目安 が続けて表示されます。空欄にすると円表示だけ消えます

日別の出納一覧

• 出費を付けた日ごとに、財布1・財布2・その日の合計が表で並びます（新しい日付が上）
• 同じ日に出費付き日記が複数ある場合は、その日で合算します
• 表の最下段に 期間合計 があります

友だちとの関係

友だちに日記本文・写真を見せても、出納帳（出費）は共有されません。自分だけが一覧・詳細・日別表で確認できます。

11. 友だち QR・日記の共有（ギルド）

旅仲間と日記をお互いに見せるための機能です（出費・出納帳は含みません）。 場所は ギルド → プロフィール の設定の下（「仲間の位置」「友だちと日記」「友達登録用 QR コード」）。出納帳は 10b。

QR で友だちを追加する

1. ギルド → プロフィール を開き、設定の下へスクロールする。
2. 友達登録用 QR コード に自分の QR が表示される（ログイン済みの場合）。
3. 対面で追加: 相手のスマホで QRで友だちを追加 を押し、カメラでこの QR を読み取る。 カメラの許可が必要です（HTTPS で開いてください）。
4. 自分から追加: QRで友だちを追加 を押し、相手の QR をスキャンする。

メールで友だちを追加する

1. 同じ画面の 友だちと日記 で、友だちの登録メールアドレスを入力する。
2. 友だちに追加 を押す。 相手も Viva Camino JP に登録（ログイン）している必要があります。

日記をお互いに見せる（重要）

友だち追加だけでは日記は見えません。次の3つすべてが必要です。

1. 友だち一覧で、相手の行にある 「日記を見せる」 スイッチをオンにする（「許可」表示）。
2. 相手にも同じ操作をしてもらう（お互いが友だち登録し、お互いが許可スイッチをオン）。
3. 条件が揃うと、日記一覧に相手の記事も表示されます（「by ニックネーム」）。

12. データの保存・共有

• ブラウザの localStorage にプロフィール・装備・行程などを保存
• Google ログイン時、掲示板はクラウド（Supabase）と同期
• 行程・宿・瓦版の更新は、管理者が共有したデータが起動時に取り込まれます

個人情報の取り扱いは プライバシーポリシー、サービスの利用条件は 利用規約 をご覧ください。

13. アプリを広める

Viva Camino JP は 2026年5月より一般公開 です。カミーノを歩く・歩く予定の仲間に、次の方法で知ってもらえます。

すぐできること

• ホーム画面の「リンクを共有」 — スマホなら共有シート、PC ならクリップボードにコピー（短縮 URL: viva-camino.com/go/）
• 口コミ — 「地図と日記が一緒」「友だちの日記が見える」など、自分が便利だった点を一言添えてリンク
• アプリ内ギルド掲示板 — 最初の数投稿があると、初訪問者が「使われている」と感じやすくなります

コミュニティ・SNS

• Facebook のカミーノ関連グループ、X（#カミーノ #Camino）で宣伝より「使った感想＋リンク」の方が伝わりやすいです
• Reddit の r/CaminoDeSantiago など英語圏にも、英語マニュアル（/manual/en/）付きで紹介できます

現地・オフライン

• アルベルゲ・教会・巡礼者向け掲示板に QR コード を置く — リンク先は https://viva-camino.com/go/ 推奨（ホーム画面追加用ショートカット）
• QR は QR Code Monkey などで無料生成できます

検索・信頼（中期的）

• Google Search Console に viva-camino.com を登録し、/sitemap.xml を送信
• プライバシーポリシー（/privacy/）と利用規約（/terms/）を OAuth 同意画面にも載せる

Google ログインを一般公開する場合: Google Cloud の OAuth 同意画面が「テスト」のままだと、登録した Gmail 以外はログインできません。 手順はリポジトリ内 docs/SUPABASE_SETUP.md の「§10 本番公開: Google OAuth のテストモードを外す」を参照してください。

14. 困ったとき

• 冒険に何も出ない — クエストで「プランにコピー」したか、日の出発・到着を設定したか確認
• 到着予想が出ない — プロフィールの歩行速度（km/h）を入力
• プランにコピーが押せない — ページ再読み込み。共有データ未反映の可能性（ギルド → 瓦版「心得」参照）
• QRで友だちを追加できない — カメラ許可、HTTPS を確認。相手がアプリにログイン済みか確認（11章）
• 友だちの日記が見えない — お互いの友だち登録と「日記を見せる」許可が両方オンか確認
• 円の目安が出ない — 日別の出納一覧 で「1ユーロ = ○円」を入力して保存したか確認
• 出費を直したい — 自分の日記を開き 編集（出納帳）
• ログインできない（Google） — OAuth 同意画面が「テスト」の場合、テストユーザーに登録した Gmail のみログイン可能。一般公開するには §13 アプリを広める の Google ログインの項と docs/SUPABASE_SETUP.md §10 を参照。メール/パスワード登録は別途利用可。別ブラウザでも試す
• 地図に現在地が出ない — 位置情報を許可、HTTPS（viva-camino.com）で開いているか確認
• オフラインで地図が白い — 出発前に「📦 オフライン保存」で必要な範囲を保存。一度も開いていない場所はキャッシュされません
• 行程・宿が表示されない — アプリを再読み込み。改善しない場合は ギルド → 瓦版の「開発者へ便り」へ
• 掲示板が同期されない — Supabase 設定・Google ログインを利用しているか確認

お問い合わせ: 開発者へ便り（Google フォーム）
旅人同士の交流: アプリ内 ギルド → 掲示板

Buen Camino!