Personal Store Tracking Service
STB Tracker
STB Tracker は、マイストア パスポートを楽しんでいる方向けの、 Google スプレッドシート上で動作する個人向け店舗情報管理サービスです。 スターバックス コーヒー ジャパンの公開情報をもとに、 利用者自身の店舗一覧を更新し、差分通知やマイマップ向け CSV 出力を行います。
ご自身の Google アカウント環境の中で、ご自身のために使うことを前提にしています。 取得した情報や出力結果を第三者へ提供、公開、再配布する用途は想定していません。
何ができるの？
README に書いていた利用者向けの説明を、そのまま公開トップページから読めるようにまとめています。
1. お手元の店舗一覧を常に最新に保つ
日本のスターバックスは 2,000 店舗を超え、月に数店舗、多い月は二桁増えることがあります。 自分で一覧管理をしているとすぐ追いつけなくなりますが、 STB Tracker は毎日自動で最新の店舗一覧をチェックして最新化します。
2. マイストア パスポート連携
店舗一覧に対して、初訪問日、最終訪問日、訪問回数などの マイストア パスポート情報を取り込めます。 「この店を初めて訪れたのはいつだっけ？」を一覧で確認しやすくなります。
3. 自分のメモも一緒に管理
既存列だけでなく、自分のコメント列や管理列を自由に追加できます。
すでに別の一覧を持っている場合も、店番号 store_id をキーにすれば取り込みやすくなります。
4. 日々の変更をメールで知らせる
新規出店、閉店、休業、名称変更などの変化があった日だけメール通知します。 何もない日は静かにして、変化があった日だけ分かるようにしています。
5. Google マップのマイマップ機能で可視化
シート上の訪問情報をもとに、訪問済みと未訪問で別々の CSV を生成します。 Google マップのマイマップ機能へ再インポートすれば、最近の訪問状況に合わせて自分の地図を更新できます。
どこで動くの？ 設定は大変なの？
Google スプレッドシートで管理・動作します。個人向けの Google アカウントがあれば利用できます。 最初に 1 回だけ準備が必要ですが、以後は毎日自動で動きます。
使い始める流れ
- 配布されたスプレッドシートを自分の Google ドライブへコピーする
- メニュー「手動で店舗一覧を取得」から初回取得を始める
- 初回だけ Google の権限確認画面で許可する
- 初回取得完了メールが届くのを待つ
- 毎日の自動巡回時刻を設定する
知っておくと安心なこと
- 初回取得は全国 2,000 店舗以上を取るため数十分かかることがあります
- 完了すると「初回取得完了」のメールが届きます
- 日次の既定時刻は 7 時 00 分です
- あまり早い時間を指定すると、公式サイトの更新前の可能性があります
Google の同意画面に表示される権限は、本サービスの動作に必要な範囲で使用します。 スプレッドシート更新、Google ドライブ上の CSV 管理、メール通知、外部取得、自動巡回のために必要です。 詳細はプライバシー ポリシーと利用規約をご確認ください。
応用編
マイストア パスポートの訪問情報を取り込みたい
マイストア パスポート連携を使うと、初訪問日や最終訪問日、
訪問回数を stores シートへ取り込めます。
ログイン済みのスタンプ帳ページを開いた状態で使う任意機能です。
Google マップのマイマップ機能を最新にしたい
訪問記録を更新したあと、既存レイヤーの「データを再インポート」から
Google ドライブ上の stb_visited.csv や stb_nostamp.csv を
選び直すだけで、最近の状態へ差し替えられます。
自動巡回の時刻を変えたい / いったん止めたい
スプレッドシートのメニュー「毎日の自動巡回時刻の設定」から変更できます。 停止ボタンで日次巡回を止められ、さらに「緊急停止」で予約済みの続き実行も止められます。
ちゃんと動いているか確認したい
exec_log シートを見ると実行履歴が残ります。
最新行の ended_at が今日か昨日であれば、通常は正常動作中です。
困ったとき
メールが届かない
通知メールは、このスプレッドシートの所有者の Google アカウントに紐づくメールアドレスへ送られます。
Gmail のプロモーションや迷惑メールを確認し、exec_log の
note 列で sent=yes や sent=initial-complete を確認してください。
「手動で店舗一覧を取得」でエラーになる
スプレッドシートを開き直してから、もう一度メニューを試してください。 一時的な Google 側の混雑で失敗した場合は、翌朝の自動取得で取り戻せることがあります。
全部やめたい
まずメニュー「緊急停止」で自動取得と予約済みの続き実行を止めます。 その後、Google ドライブでスプレッドシートを削除し、 マイストア パスポート連携を使っていた場合はブックマークも削除してください。
`stores` シートの見方
代表的な列のまとまりは次のとおりです。色はヘッダー背景色のグループを表します。
| 色 | 列 | 意味 |
|---|---|---|
| 🟦 |
store_id / name / store_url /
prefecture / postal_code / address /
lat / lng / hours_raw /
status / closed_at / pricing_tier
|
スターバックス コーヒー ジャパン公式情報をもとに管理する基本列 |
| 🟪 |
drive_through / service_area / station /
airport / regional_landmark / reserve /
tea_cafe / book_cafe / my_fruit /
family_friendly / alcohol
|
店舗形態やサービス提供状況の列。対象店舗だけ 1 が入ります |
| 🟧 |
first_visit_date / last_visit_date /
frequency_of_visits / limited_area
|
マイストア パスポート連携や手入力で扱う訪問情報の列 |
| ➕ | 任意の独自列 | 自分のメモ列や管理列を自由に追加できます |
列の並び替えや列の非表示は、通常は動作に影響しません。 ただし既存の列名は変えないようにしてください。 独自列を追加するときも、既存の列名と被らない名前にします。
お断り事項
- 本サービスは、スターバックス コーヒー ジャパンが提供する公開情報を一次ソースとして動作します。 ただし常に正しいのは公式が直接示す情報です。
- 取得した情報、通知メール、CSV、マイマップへ取り込んだ地図、 スプレッドシートの共有リンクなどを第三者へ提供・公開・再配布してはいけません。
- 公式サイト側の仕様変更、取得失敗、アクセス拒否などが起きた場合は、 回避しようとせず、公式サイトで直接確認してください。
- これらを守っていただいた上でも、本サービスの利用による問題や損失について 提供者は責任を負いません。