競合店舗調査機能

概要

項目	内容
ステータス	🔵 提案中
Issue	-
担当	-

検索キーワード × 計測地点で 自店と一緒に表示される競合店舗を一覧化、各競合の順位推移をグラフで提供し、詳細な GBP 情報は Google マップ埋め込みで参照する機能。Places API は IDs Only（無料）枠のみ使用、GBP 詳細データは自社で保持・表示せず Google に直接描画させることで、追加 API 課金 $0 を維持しつつ Google 利用規約を完全遵守する。

項目	内容
計測方式	既存 Places API (New) Text Search レスポンスから全件 place_id を保存
表示する自社データ	順位 / 順位推移 / 新規参入・脱落検出
表示する競合 GBP 情報	Google マップ Embed iframe 経由のみ（店名・評価・口コミ・写真・営業時間）
対象	MAPPY（先行）→ GCOR / PIPIT 順次
API 費用	$0（IDs Only SKU 維持、Maps Embed API は無制限無料）

提案内容

背景・課題

先方より「競合調査ができる機能が欲しい。検索して GBP の情報やその店舗の順位が見れる」との要望
現行のランキング機能は 自店の順位のみ を扱い、検索結果に同時に現れる競合店舗の情報は破棄している
Places API (New) のレスポンスには上位 60 件の place_id が含まれており、既存実装でも取得済みだが利用されていない
既存スクレイピング / Places API 移行で「API 課金は IDs Only（$0）を維持」が顧客との合意事項
Google 利用規約上、競合店舗の名前・評価・口コミ数・営業時間などは 自社 DB へのキャッシュ・自社 UI への直接表示が禁止（place_id のみ無期限保存可、緯度経度は 30 日まで）
→ データ表示部分を Google マップ Embed に丸投げすることで、規約遵守 + 追加課金 0 + 顧客要望充足を同時に成立させる

提案するソリューション

既存 Places API Text Search のレスポンスから 全件 place_id を取得・保存し、画面では place_id を Google マップ Embed iframe に渡すことで、Google 公式 UI 内で店名・評価・口コミ・写真・営業時間・経路を直接描画させる。自社 DB に持つのは順位データのみ。

主な特徴：

API 課金 $0 維持：FieldMask は引き続き places.id のみ、追加リクエストなし
規約完全遵守：保存対象は place_id（無期限可）と順位のみ。店名・評価等は自社で持たない
競合の順位推移は自社データで完全に提供可能（自店と同じテーブル設計の流用）
新規参入・脱落検出：日次の place_id 集合差分で「先月までいなかった競合の出現」「圏外に消えた競合」を自動検知
詳細閲覧は Maps Embed iframe（無制限無料）または https://www.google.com/maps/place/?q=place_id:XXX 形式の外部リンク

機能一覧

#	機能名	説明	優先度
1	競合 place_id 保存	Places API レスポンスの全 place_id を順位とともに DB 保存	高
2	競合一覧表示	キーワード×日付指定で上位 N 件を表示、自店ハイライト	高
3	順位推移グラフ	自店 + 任意の競合 1〜5 店舗の順位を時系列折線で比較	高
4	Maps Embed プレビュー	競合行クリックで Google マップ iframe をモーダル展開	高
5	Google マップ外部リンク	「Google マップで見る↗」リンクで別タブ遷移	高
6	新規参入検出	過去 N 日間に上位に存在しなかった place_id を新着フラグ表示	中
7	脱落検出	過去 N 日間上位にいたが今日不在の place_id を脱落フラグ表示	中
8	競合ヒット数集計	1 店舗（place_id）が何キーワードで上位にいるかを集計	中
9	順位帯遷移ビュー	競合の順位帯（1〜3 / 4〜10 / 11〜20 / 圏外）の月次遷移	低
10	CSV エクスポート（順位のみ）	place_id + 順位のみ CSV 出力（店名・評価等は含めない）	低

設計検討事項

できること・できないこと（重要な前提）

情報	自社 DB 保存	自社画面表示（数値・テキスト）	Maps Embed 内表示
place_id	✅ 無期限	✅ 内部キー	—
順位（自店・競合）	✅	✅ 数値・グラフ可	—
競合の店名	❌ 規約違反	❌	✅ Google が描画
競合の住所	❌	❌	✅
競合の評価（★）	❌	❌	✅
競合の口コミ数	❌	❌	✅
競合の営業時間	❌	❌	✅
競合の写真	❌	❌	✅
競合のインサイト（PV/通話数等）	❌	❌	❌（GBP オーナーのみ）

規約上できないこと

競合店の 店名・評価・口コミ数を自社画面の表に並べて表示
競合店の 評価・口コミ数の推移グラフ
競合店の 写真を自社サーバーにダウンロード保存
競合データの 店名・評価入り CSV エクスポート

これらは Google Maps Platform Terms of Service の「place_id 以外の Places コンテンツを保存・キャッシュしてはならない」条項に抵触する。実装すると API アクセス権剥奪のリスクあり。

採用する設計判断の背景

検討案	月額追加コスト	評価	採否
本案（IDs Only + Maps Embed）	$0	規約遵守、コスト0、顧客要望の中核を満たす	採用
Pro tier 利用（店名・住所表示）	$30〜$100/月	キャッシュ不可制約で結局毎回フェッチ必要、UX改善ほぼなし	不採用
Enterprise tier（評価・口コミ数表示）	$100〜$500/月	規約上 DB 保存不可で推移グラフ作れず、コスト見合わず	不採用
Google Business Profile API	—	規約上競合データ取得は明示禁止（lead generation / competitive analysis）	不採用
Google 検索スクレイピング	（見えないコスト大）	規約違反、reCAPTCHA、不安定	不採用

DB スキーマ拡張案

既存 mappy_place_search_rankings をベースに、自店以外の競合行も保存する形に拡張：

sql

-- 競合スナップショット（自店以外の上位 N 件の place_id を保存）
CREATE TABLE mappy_competitor_snapshots (
  id              BIGINT PRIMARY KEY AUTO_INCREMENT,
  user_id         BIGINT NOT NULL,
  gbp_location_id BIGINT NOT NULL,                 -- 自店の location（観測の主体）
  keyword_id      BIGINT NOT NULL,
  competitor_place_id VARCHAR(255) NOT NULL,       -- 競合の place_id（無期限保存可）
  ranking         SMALLINT NOT NULL,               -- 1〜60 / 0=圏外（理論上競合行は1〜60のみ）
  ranking_at      DATE NOT NULL,
  search_at       DATETIME NOT NULL,
  source          VARCHAR(20) DEFAULT 'places_api',
  system_id       INT NOT NULL,
  created_at      DATETIME,
  INDEX idx_loc_kw_date (gbp_location_id, keyword_id, ranking_at),
  INDEX idx_place (competitor_place_id, ranking_at)
);

自店行は既存 mappy_place_search_rankings をそのまま使用（重複保存しない）
競合行を別テーブルにする理由：行数が約 N 倍（最大 60 倍）に膨らむためインデックス分離
保持期間：13 ヶ月（前年同月比較を可能にする最小スパン）
約 200 B/rec × N キーワード × 30〜60 件/日 × 13 ヶ月 → 顧客 100 社規模で 約 5〜10 GB

Maps Embed API の利用形態

html

<!-- 競合詳細モーダル内 -->
<iframe
  src="https://www.google.com/maps/embed/v1/place?key={EMBED_KEY}&q=place_id:ChIJ..."
  width="100%" height="450" loading="lazy"
  referrerpolicy="no-referrer-when-downgrade"
  allowfullscreen>
</iframe>

項目	仕様
API 種別	Maps Embed API（Places API とは別 SKU）
料金	完全無料・無制限
必要なキー	Maps Embed 用キー（既存 Places API キーとは別。1 個発行で全社共用可）
取り扱い	キーはフロントエンド埋め込み可（HTTP リファラ制限を設定）
表示内容	店名・カテゴリ・評価・口コミ件数・写真・営業時間・経路ボタン

コスト構造（月額試算）

項目	試算
Places API 追加呼び出し	0（既存呼び出しのレスポンスから place_id を抜き出すだけ）
Places API 料金増分	$0
Maps Embed API 利用	完全無制限無料
AWS RDS 増分ストレージ（13 ヶ月保持）	約 +$0.5〜$1.0/月
AWS データ転送	微少
月額追加コスト合計	約 ¥100〜200/月（実質ゼロ）

先方説明用ポイント

API 課金は完全 $0 維持（既存の IDs Only 方針継続）
「競合店舗の詳細情報は Google マップで直接見れる」という形で顧客要望を満たす
順位推移・新規参入検出など 自社プラットフォーム独自の価値を提供
顧客への課金転嫁が不要（既存プランの付加価値として提供可）
規約遵守設計のため、MEO 業界他社が突破しづらいリーガル面の優位を確保

既存案件・既存実装との関係

現行 Places API ランキング取得の レスポンス側の利用拡張。リクエスト追加なし
既存案件 #11 複数箇所計測（ジオグリッドランキング）と組み合わせると 計測点ごとの競合一覧 も生成可能（拡張余地）
既存 #7 グループごとの分析・ランキング比較はグループ内自店間の比較、本案件はグループ外の競合との比較。機能補完関係

画面モック