かざす口コミPlaces API 早見表
Googleマップから店の情報を取る仕組み。いつ呼んで、いくらかかるか。
Places API (New)Google Maps Platform
使った分だけの課金
Places API でできること色が付いているのが、かざす口コミで使うもの
店名で店を探すText Search
使う「hair salon nagi 野間」のような言葉で探して、店名・住所・カテゴリ・評価・口コミ件数を受け取る。店を追加する画面の検索。
店の詳しい情報を取るPlace Details
使うPlace IDを渡して、電話・営業時間・評価・口コミ件数・Googleマップのリンクなどを受け取る。毎週の集計で使う。
近くの店を探すNearby Search
使っていない場所と範囲・ジャンルで店を一覧にする。営業先のリスト作りには使える。
入力の途中で候補を出すAutocomplete
使っていない店名を打っている途中で候補を出す。検索欄を便利にしたくなったら使う。
口コミを読むPlace Details の reviews
使っていない1回で最大5件（関連の高い順）。全件や新しい口コミだけは取れない。料金区分は Enterprise + Atmosphere（月1,000回まで無料・超えた分は$25 / 1,000回）。
写真を取るPlace Photos
使っていない店の写真を受け取る。管理画面に店の写真を出したくなったら使う。
できないことお客さんの代わりに口コミを投稿すること。口コミを全件読むことや返信すること（店主の連携が必要な Business Profile API の範囲）。
どの場面で呼ぶか情報の流れの場面1〜7
- 1
タグにURLを書く
呼ばない事務所で
- 2
店を登録する
呼ぶ検索と「この店です」。1店につき数回
- 3
タグを紐付ける
呼ばない自社のデータだけ
- 4
店主が申込む
呼ばない自社のデータだけ
- 5
お客さんが口コミ
呼ばないURLを作るだけ
- 6
毎週の集計
呼ぶ1店につき週1回・自動
- 7
管理画面を見る
呼ばない場面6の値を使う
!月額の基本料金はなく、使った分だけ。費用は「加盟店の数」で決まる。お客さんの人数や、管理画面を開く回数では増えない。いちばん回数が多いのは場面6の毎週の集計。
料金区分取る項目で区分が決まる
| 区分 | 毎月の無料枠 | 超えた分 / 1,000回 |
|---|---|---|
| Text Search Pro使う店名で検索。店名・住所・カテゴリ・評価・件数 | 5,000回 | $32 |
| Place Details Enterprise使う店の詳細。電話・営業時間・評価・件数 | 1,000回 | $20 |
| Place Details Pro安い店名・カテゴリ・地図のURLなど（評価と件数は入らない） | 5,000回 | $17 |
| Place Details Essentials安い住所・位置など | 10,000回 | $5 |
評価と口コミ件数を取ると、店の詳細は Enterprise の区分になる。
店の数ごとの目安1か月・毎週の集計分
| 加盟店 | 呼ぶ回数 | 費用 |
|---|---|---|
| 50店 | 約215回 | 0円 |
| 100店 | 約430回 | 0円 |
| 200店 | 約860回 | 0円 |
| 500店 | 約2,150回 | 約$23 |
週1回でも約230店までは無料枠に収まる。週1回（1か月あたり約4.3回）× 加盟店の数。無料枠1,000回を超えた分 × $20 / 1,000回で計算。新しく登録する店の検索は月5,000回の無料枠に収まる前提。
使い始めるまでデモの「店を追加する画面」を本物の検索にする
検索と詳細の窓口済み
Cloudflare Pages Functions に置いた。キーはページに書かない
Google Cloud のプロジェクトまだ
プロジェクトを作り、請求先アカウント（カード）をつなぐ
Places API (New) を有効にまだ
旧版の「Places API」ではない方
APIキーを作るまだ
使えるAPIを Places API (New) だけに絞る
1日の上限と予算アラートまだ
デモのURLは誰でも開けるので、使いすぎの安全装置にする
Cloudflare にキーを入れるまだ
wrangler pages secret put GOOGLE_PLACES_KEY
ビジネスプロフィール API と比べる2パターン・まだ決めていない
| A：Places API だけ今のまま | B：ビジネスプロフィール API を足す店の許可をもらう | |
|---|---|---|
| 仕組み | Google マップの公開情報を取る | 店の許可をもらって、店自身のデータを取る |
| 始めるまで | キーを設定するだけ。すぐ始められる | 自社の利用申請と審査がある（確認済みのプロフィールを60日以上運営、ウェブサイトあり） |
| 申込みの手間 | 今のまま（「はじめる」を押すだけ） | 1手間増える（店主がGoogleで許可するか、自社を管理者に追加） |
| 使える店 | 全店 | Google のオーナー確認を済ませている店だけ |
| 評価・口コミ件数 | 取れるが保存できない。週ごとの「増えた件数」は規約上グレー | 取れて、記録もできる |
| 直接投稿の件数 | 出せない | 出せる（コピーした文章と照合） |
| 履歴に沿った文章づくり | 1回5件まで。規約上グレー | 全件から「よく褒められている点」を抜き出せる |
| AI解析で読める口コミ | 1回5件まで | 全件 |
| 費用 | 約230店まで0円 | 利用料はかからない（回数の上限だけ）。店名検索は A と同じ |
!おすすめ：A で始めて、並行して B の申請を出しておく。審査を待つ間も試せて、許可をもらえた店から順に B に切り替えられる。オーナー確認をしていない店は A のまま。A の間は「増えた件数」の記録が規約上グレーなので、試す店の数を絞る。
守るルール
ずっと保存してよいのは Place ID だけ
店名・住所・評価は毎週の集計で最新にして使う。
「Google マップ」と表示する
Googleから取った情報を画面に出すとき。
キーはページに書かない
自社のサーバーだけが持つ。書くと誰でも使えてしまう。
費用を減らす方法
登録時は検索の結果だけ使う
電話と営業時間は使っていないので、「この店です」で詳細を取らない。登録時の Enterprise が0回になる。
集計は評価と件数だけ
取る項目を絞る。回数は1店につき週1回のまま。
1日の上限を掛けておく
デモのURLからの使いすぎや、いたずらの連打を止める。