MENU

問い合わせ

    お問い合わせ


    【NuxtとGoogle Mapsで作る店舗検索マップ 第12回】本番公開前チェック:APIキー制限・クォータ・予算アラート・管理画面の保護

    Google Maps API と Nuxt で自社サイトの店舗検索マップを作る連載の最終回(第12回)です。前回(第11回)では、既存の店舗台帳を CSV で一括取り込みできるようにしました。最終回は、公開前に確認すべきことを点検し、連載を締めくくります。

    「動くものはできた。でも、公開した途端に想定外の請求が来たり、管理画面を誰かに触られたりしないか心配…」

    結論から言うと、店舗検索ページは誰でも有料の API を呼べる入口になるので、対策は1つでは足りません。「キーの制限」「API ごとの利用上限(クォータ)」「予算アラート」「サーバー側の回数制限」を重ね、管理画面と書き込みの API はパスワードで閉じます。予算アラートは通知だけで、利用を止めるのはクォータです。

    目次

    この回で点検すること

    分類点検することサンプルでの対応
    APIキーキーの制限、Referer の送り方Referrer-Policy を指定
    費用の上限クォータ、予算アラートCloud コンソールで設定
    管理画面/admin と書き込みの APIBasic 認証を追加
    回数制限住所の変換・所要時間接続元ごとの回数制限を追加
    本番 DBSQLite から PostgreSQL へビルド時の切り替えを実装
    保存するデータGoogle のデータを保存していないか最終確認の表と README

    1. APIキーの制限を仕上げる

    第1回から、キーはブラウザ用とサーバー用の2本に分けてきました。公開前に、それぞれの制限を本番用に仕上げます。

    キーアプリケーションの制限API の制限
    ブラウザ用(NUXT_PUBLIC_GOOGLE_MAPS_API_KEY)「ウェブサイト」=本番のオリジン(例:https://www.example.co.jp)だけMaps JavaScript API、Places API (New)
    サーバー用(NUXT_GOOGLE_MAPS_SERVER_KEY)「IP アドレス」=サーバーの送信元 IP(固定できる場合)Geocoding API、Routes API

    Google の公式ガイド(2026年11月時点で確認)でも、用途に合う制限を使うこと、キーを使う API だけに絞ること、用途ごとに別のキーを作ることが勧められています。開発用の localhost を許可したキーは本番用と分けておきます。

    📰 出典:Google Maps Platform「API security best practices」

    Referer ヘッダーを送らない設定にしない

    「ウェブサイト」制限は、ブラウザが送る Referer ヘッダー(どのページからのリクエストかを示す情報)で判定されます。公式ガイドによると、最近のブラウザは別サイトへのリクエストで Referer をオリジン(https://ドメイン の部分)まで削り、その動きはサイトの Referrer-Policy によっても変わります。Referer が届かないと、地図の読み込みが失敗しえます。そこで、登録はオリジンにし、サイト側ではブラウザの既定と同じ値を明示しました。管理用パスワードの設定欄と、5.の PostgreSQL への切り替えも、ここでまとめて足します。

    nuxt.config.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/nuxt.config.ts
    +++ b/nuxt.config.ts
    @@ -17,8 +17,10 @@ export default defineNuxtConfig({
       //   NUXT_PUBLIC_GOOGLE_MAPS_API_KEY -> runtimeConfig.public.googleMapsApiKey
       //   NUXT_PUBLIC_GOOGLE_MAPS_MAP_ID  -> runtimeConfig.public.googleMapsMapId
       //   NUXT_GOOGLE_MAPS_SERVER_KEY     -> runtimeConfig.googleMapsServerKey(サーバー専用)
    +  //   NUXT_ADMIN_PASSWORD             -> runtimeConfig.adminPassword(第12回。サーバー専用)
       runtimeConfig: {
         googleMapsServerKey: '',
    +    adminPassword: '',
         public: {
           googleMapsApiKey: '',
           googleMapsMapId: 'DEMO_MAP_ID',
    @@ -29,17 +31,30 @@ export default defineNuxtConfig({
         strict: true,
       },
    
    +  // 第12回: 本番公開前の設定。Referer ヘッダーを送らない設定(no-referrer 等)にすると、
    +  // ブラウザ用キーの「ウェブサイト制限」で地図の読み込みが拒否されうるため、ブラウザ既定と同じ値を明示する
    +  routeRules: {
    +    '/**': {
    +      headers: {
    +        'Referrer-Policy': 'strict-origin-when-cross-origin',
    +        'X-Content-Type-Options': 'nosniff',
    +      },
    +    },
    +  },
    +
       // 第3回: Nitro の SQL データベース機能(experimental)。
       // node:sqlite(Node.js 組み込み)を使う db0 の connector で .data/gmap.sqlite に保存する。
    +  // 第12回: ビルド時に DB_CONNECTOR=postgresql を指定すると PostgreSQL に切り替わる。
    +  //   接続先はビルドに含めず、実行時の環境変数 PGHOST / PGPORT / PGUSER / PGPASSWORD / PGDATABASE
    +  //   から読む(pg ライブラリの既定の動作)。パスワードをビルド成果物に残さないため
       nitro: {
         experimental: {
           database: true,
         },
         database: {
    -      default: {
    -        connector: 'node-sqlite',
    -        options: { name: 'gmap' },
    -      },
    +      default: process.env.DB_CONNECTOR === 'postgresql'
    +        ? { connector: 'postgresql', options: {} }
    +        : { connector: 'node-sqlite', options: { name: 'gmap' } },
         },
       },
     })

    2. 費用の上限を「仕組みで」決める

    クォータ(利用上限)で止める

    Cloud コンソールの「割り当て」(Quotas)のページでは、API ごとに1日・1分あたりのリクエスト数の上限を下げられます。公式ドキュメントでは、クォータは想定外の請求を防ぐのに役立つ一方、低すぎると利用者が使えなくなると注意されています。店舗検索ページの費用は来訪者の数と操作の回数に比例するので、想定の数倍程度から始め、キャンペーンなどで来訪者が増える日の前には見直します。

    予算アラートは「通知だけ」

    請求先アカウントには、予算とアラート(例:予算の50%・90%・100%で通知)を設定します。ただし公式ドキュメントでは、予算は使う金額の目標で、利用を自動では止めないと説明されています。予算アラートは「気づく仕組み」、クォータは「止める仕組み」です。

    📰 出典:Google Maps Platform「Manage your cost of use」

    料金は2025年3月から、SKU(課金の単位)ごとの無料枠と区分(Essentials / Pro / Enterprise)の方式です。本連載では、地図の表示・住所の変換・所要時間の基本機能が Essentials、営業時間・評価の取得が Enterprise にあたります。単価は公式の料金ページで確認してください。

    3. 管理画面と書き込み API をパスワードで守る

    ここまで、管理画面(/admin)と店舗を書き換える API は誰でも使える状態でした。そこで、Nitro のミドルウェア(すべてのリクエストの前に動く処理)で、この2つだけを Basic 認証(ブラウザ標準のパスワード確認)で守ります。

    // server/middleware/admin-auth.ts
    import { createHash, timingSafeEqual } from 'node:crypto'
    
    /**
     * 第12回: 管理画面(/admin)と店舗を書き換える API(/api/points の GET 以外)を、
     * パスワード(Basic 認証)で守る。来訪者向けの画面と、店舗を読む API は誰でも使える。
     * - パスワードは環境変数 NUXT_ADMIN_PASSWORD(runtimeConfig.adminPassword)。ユーザー名は問わない
     * - 未設定のときは、開発中(npm run dev)だけ通し、本番では 503 にして閉じる
     * - 本格的な運用では、社内のログイン(SSO など)とスタッフごとの権限に置き換える(本文参照)
     */
    export default defineEventHandler((event) => {
      const path = getRequestURL(event).pathname
      const isAdminPage = path === '/admin' || path.startsWith('/admin/')
      const isWriteApi = path.startsWith('/api/points') && event.method !== 'GET'
      if (!isAdminPage && !isWriteApi) return
    
      const { adminPassword } = useRuntimeConfig(event)
      if (!adminPassword) {
        if (import.meta.dev) return
        throw createError({
          statusCode: 503,
          statusMessage: 'Admin is not configured',
          message: '管理用のパスワード(NUXT_ADMIN_PASSWORD)が未設定です',
        })
      }
    
      if (!safeEqual(readBasicPassword(getHeader(event, 'authorization')), adminPassword)) {
        setHeader(event, 'WWW-Authenticate', 'Basic realm="admin", charset="UTF-8"')
        throw createError({ statusCode: 401, statusMessage: 'Unauthorized' })
      }
    })
    
    // 「Authorization: Basic <ユーザー名:パスワード を Base64 にしたもの>」からパスワードを取り出す
    function readBasicPassword(header: string | undefined): string {
      const [scheme, encoded] = (header ?? '').split(' ')
      if (scheme !== 'Basic' || !encoded) return ''
      const decoded = Buffer.from(encoded, 'base64').toString('utf8')
      const sep = decoded.indexOf(':')
      return sep >= 0 ? decoded.slice(sep + 1) : ''
    }
    
    // 文字列の比較にかかる時間から、パスワードを推測されないようにする(長さもそろえてから比べる)
    function safeEqual(a: string, b: string): boolean {
      const ha = createHash('sha256').update(a).digest()
      const hb = createHash('sha256').update(b).digest()
      return timingSafeEqual(ha, hb)
    }
    • 守る範囲を絞る:来訪者の画面と、店舗を読む GET /api/points は誰でも使えます。CSV 取り込み(第11回)は書き込みなので守る側です
    • 未設定なら閉じる:パスワードの環境変数が無いまま本番に出すと、503 を返して管理画面を開けなくします。設定し忘れて「誰でも開ける」状態になるのを防ぐためで、開発中(npm run dev)だけは通します
    • 比べ方に気をつける:ハッシュにしてから timingSafeEqual で比べ、比較にかかる時間の差から推測されにくくしています

    管理画面へのリンクには external を付けます。Nuxt のリンクは通常ページを読み込み直さずに画面を切り替えるため、パスワードを聞かれないまま管理画面が出て、保存で初めて失敗します。external ならブラウザがページごと読み込み、401 を受けてパスワードの入力欄を出します。入力したパスワードは、以降の同じサイトへのリクエストにブラウザが自動で付けます。

    app/layouts/default.vue に次の変更を加えます(+ が追加、- が削除)。

    --- a/app/layouts/default.vue
    +++ b/app/layouts/default.vue
    @@ -3,11 +3,12 @@
         <header class="layout__header">
           <NuxtLink to="/" class="layout__brand">店舗検索マップ</NuxtLink>
           <span class="layout__sub">Nuxt + Google Maps Platform サンプル</span>
    -      <!-- 第5回: 管理画面へのリンク。第11回: CSV取り込み。 -->
    +      <!-- 第5回: 管理画面へのリンク。第11回: CSV取り込み。
    +           第12回: 管理画面は Basic 認証で守るため、external でページごと読み込む -->
           <nav class="layout__nav">
             <NuxtLink to="/">店舗を探す</NuxtLink>
    -        <NuxtLink to="/admin">店舗の管理</NuxtLink>
    -        <NuxtLink to="/admin/import">CSV取り込み</NuxtLink>
    +        <NuxtLink to="/admin" external>店舗の管理</NuxtLink>
    +        <NuxtLink to="/admin/import" external>CSV取り込み</NuxtLink>
           </nav>
         </header>
         <main class="layout__main">

    管理画面のファイルにも、守られていることが分かるコメントを足します。

    app/pages/admin/index.vue に次の変更を加えます(+ が追加、- が削除)。

    --- a/app/pages/admin/index.vue
    +++ b/app/pages/admin/index.vue
    @@ -2,6 +2,7 @@
     // 第5回: 店舗を登録する管理画面。地図をクリックして仮ピンを立て、フォームから登録する。
     // 店舗の位置は、ここで人が決めた値(自社のデータ)として保存する。
     // 第9回: 店舗の画面と同じく、表示範囲内の店舗だけを読み込む。
    +// 第12回: 公開するときは、この画面と書き込みの API をパスワードで守る(server/middleware/admin-auth.ts)。
     import type { Point } from '#shared/types/point'
    
     useHead({ title: '店舗の管理|店舗検索マップ(サンプル)' })

    これは「公開しても最低限は閉じている」ための簡易版です。パスワードは全員で1つで、誰が何を変えたかも残りません。本格的な運用では、社内のログイン(SSO など)とスタッフごとの権限に置き換えます。

    4. 来訪者が呼べる有料 API に回数制限をかける

    住所の変換(第6回)と所要時間(第10回)は、来訪者の操作でサーバーが Google を呼びます。連打や機械的な呼び出しは、そのまま課金の回数になります。そこで、1つの接続元(IP アドレス)から一定時間に呼べる回数を制限します。

    // server/utils/rateLimit.ts
    import type { H3Event } from 'h3'
    
    /**
     * 第12回: 1つの接続元(IP アドレス)から、決まった時間内に呼べる回数を制限する。
     * 来訪者が使う有料 API の入口(住所の変換・所要時間)を、連打や機械的な大量アクセスから守る。
     * - 数えた回数はこのサーバーのメモリにだけ持つ簡易版。サーバーが複数台なら Redis などで共有する
     * - Google 側の1日の上限(クォータ)・予算アラートと組み合わせて使う(どれか1つでは足りない)
     */
    const buckets = new Map<string, { count: number; resetAt: number }>()
    
    export function assertRateLimit(event: H3Event, name: string, limit: number, windowMs: number) {
      const ip = getRequestIP(event, { xForwardedFor: true }) ?? 'unknown'
      const key = `${name}:${ip}`
      const now = Date.now()
    
      const bucket = buckets.get(key)
      if (!bucket || bucket.resetAt <= now) {
        buckets.set(key, { count: 1, resetAt: now + windowMs })
        if (buckets.size > 10_000) cleanup(now) // 古い記録が溜まり続けないようにする
        return
      }
      bucket.count++
      if (bucket.count > limit) {
        setHeader(event, 'Retry-After', Math.ceil((bucket.resetAt - now) / 1000))
        throw createError({
          statusCode: 429,
          statusMessage: 'Too Many Requests',
          message: '短い時間に検索が続いたため、少し時間をおいてからお試しください',
        })
      }
    }
    
    function cleanup(now: number) {
      for (const [key, b] of buckets) {
        if (b.resetAt <= now) buckets.delete(key)
      }
    }

    server/utils/ の関数は自動で読み込まれるので、各 API の入力の検証の直後に1行足すだけで使えます。

    server/api/geocode.get.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/server/api/geocode.get.ts
    +++ b/server/api/geocode.get.ts
    @@ -9,6 +9,8 @@ const querySchema = z.object({
     // 変換の結果は「近い店舗を探す起点」に使うだけで、DB にもログにも保存しない
     export default defineEventHandler(async (event) => {
       const { address } = await getValidatedQuery(event, (q) => querySchema.parse(q))
    +  // 第12回: 1つの接続元から1分に20回まで(Geocoding API の呼び出し=課金の回数を抑える)
    +  assertRateLimit(event, 'geocode', 20, 60_000)
    
       const { googleMapsServerKey } = useRuntimeConfig(event)
       if (!googleMapsServerKey) {

    server/api/travel-times.post.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/server/api/travel-times.post.ts
    +++ b/server/api/travel-times.post.ts
    @@ -18,6 +18,8 @@ const bodySchema = z.object({
     // 店舗の座標はブラウザから受け取らず、DB の値を使う(任意の地点の経路計算に使われないようにする)
     export default defineEventHandler(async (event): Promise<{ results: TravelTimeResult[] }> => {
       const { origin, ids, mode } = await readValidatedBody(event, (b) => bodySchema.parse(b))
    +  // 第12回: 1つの接続元から1分に10回まで(1回で最大10要素なので、Routes API は1分に最大100要素)
    +  assertRateLimit(event, 'travel-times', 10, 60_000)
    
       const { googleMapsServerKey } = useRuntimeConfig(event)
       if (!googleMapsServerKey) {

    回数はサーバー1台のメモリで数える簡易版で、複数台なら Redis などで共有します。営業時間・評価(第7回)はブラウザから直接 Google を呼ぶため、この制限は効きません。こちらは「ボタンを押したときだけ取得」とクォータで抑えます。

    対策防げること防げないこと
    キーの制限他のサイト・他の API での流用自社のページからの大量の呼び出し
    回数制限1つの接続元からの連打接続元を変えたアクセス、ブラウザから直接呼ぶ API
    クォータ上限を超えた呼び出し(止まる)上限内での想定外の費用
    予算アラート費用の増加に気づく利用を止めること

    5. 本番データベースを PostgreSQL に切り替える

    SQLite は1台の試作には十分ですが、複数台での運用やバックアップを考えると、本番では PostgreSQL などのデータベースサーバーが一般的です。第3回で SQL を db0 の sql タグ経由に限ったので、変更は設定とテーブル作成の2か所で済みます。設定は1.の差分の後半で、ビルド時の DB_CONNECTOR で切り替えます。接続先やパスワードはビルド成果物に残さないよう、PostgreSQL 用のライブラリ(pg)が実行時に PGHOST などの環境変数を読む動作に任せました。

    server/plugins/db-init.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/server/plugins/db-init.ts
    +++ b/server/plugins/db-init.ts
    @@ -5,17 +5,32 @@ import { samplePoints } from '../data/sample-points'
     export default defineNitroPlugin(async () => {
       const db = useDatabase()
    
    -  await db.sql`CREATE TABLE IF NOT EXISTS points (
    -    id INTEGER PRIMARY KEY AUTOINCREMENT,
    -    name TEXT NOT NULL,
    -    category TEXT NOT NULL,
    -    lat REAL NOT NULL,
    -    lng REAL NOT NULL,
    -    address TEXT NOT NULL DEFAULT '',
    -    memo TEXT NOT NULL DEFAULT '',
    -    place_id TEXT,
    -    updated_at TEXT NOT NULL
    -  )`
    +  // 第12回: 連番と小数の型だけ、SQLite と PostgreSQL で書き方が違う
    +  if (db.dialect === 'postgresql') {
    +    await db.sql`CREATE TABLE IF NOT EXISTS points (
    +      id INTEGER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    +      name TEXT NOT NULL,
    +      category TEXT NOT NULL,
    +      lat DOUBLE PRECISION NOT NULL,
    +      lng DOUBLE PRECISION NOT NULL,
    +      address TEXT NOT NULL DEFAULT '',
    +      memo TEXT NOT NULL DEFAULT '',
    +      place_id TEXT,
    +      updated_at TEXT NOT NULL
    +    )`
    +  } else {
    +    await db.sql`CREATE TABLE IF NOT EXISTS points (
    +      id INTEGER PRIMARY KEY AUTOINCREMENT,
    +      name TEXT NOT NULL,
    +      category TEXT NOT NULL,
    +      lat REAL NOT NULL,
    +      lng REAL NOT NULL,
    +      address TEXT NOT NULL DEFAULT '',
    +      memo TEXT NOT NULL DEFAULT '',
    +      place_id TEXT,
    +      updated_at TEXT NOT NULL
    +    )`
    +  }
       // 第9回: 表示範囲(緯度・経度の範囲)での検索を速くする索引
       await db.sql`CREATE INDEX IF NOT EXISTS points_lat_lng ON points (lat, lng)`
    

    pg を追加します。

    npm install pg@8 --ignore-scripts

    .env.example に次の変更を加えます(+ が追加、- が削除)。

    --- a/.env.example
    +++ b/.env.example
    @@ -14,3 +14,23 @@ NUXT_PUBLIC_GOOGLE_MAPS_MAP_ID=DEMO_MAP_ID
     # ブラウザ用キーとは別に発行し、API 制限(+可能なら IP アドレス制限)を設定する。
     # runtimeConfig.googleMapsServerKey に対応(クライアントには公開されない)
     NUXT_GOOGLE_MAPS_SERVER_KEY=
    +
    +# ── 第12回: 本番公開に向けた設定 ──
    +# 管理画面(/admin)と店舗を書き換える API のパスワード(Basic 認証)。
    +# 未設定だと、本番では管理画面が使えない(開発中の npm run dev では未設定でも開ける)
    +NUXT_ADMIN_PASSWORD=
    +
    +# 本番(node .output/server/index.mjs)では .env は読まれない。上のキーも含め、
    +# 実行環境(サーバーやコンテナ)の環境変数として設定する。
    +# 本番では Map ID に DEMO_MAP_ID ではなく、Cloud コンソールで発行した Map ID を使う。
    +
    +# PostgreSQL に切り替える場合は「ビルド時」に指定する(未指定なら SQLite)
    +#   DB_CONNECTOR=postgresql npm run build
    +DB_CONNECTOR=
    +
    +# PostgreSQL の接続先は「実行時」の環境変数で渡す(ビルド成果物に残さない)
    +PGHOST=
    +PGPORT=5432
    +PGUSER=
    +PGPASSWORD=
    +PGDATABASE=

    手元では、Docker で PostgreSQL 16 を起動して試せます(ユーザー名・パスワードは試験用の例です)。

    docker run -d --name gmap-pg -p 5432:5432 \
      -e POSTGRES_USER=gmap -e POSTGRES_PASSWORD=gmap-dev -e POSTGRES_DB=gmap postgres:16

    ビルドのときに DB_CONNECTOR=postgresql を付け、接続先と管理用パスワードは起動のときに環境変数で渡します(値は例です)。

    DB_CONNECTOR=postgresql npm run build
    PGHOST=localhost PGUSER=gmap PGPASSWORD=gmap-dev PGDATABASE=gmap \
      NUXT_ADMIN_PASSWORD=change-me node .output/server/index.mjs

    本番では、起動時の CREATE TABLE IF NOT EXISTS ではなくマイグレーション(テーブル構造の変更を履歴で管理する仕組み)、SQLite のデータの移行、接続プール(複数の接続を使い回す仕組み)なども必要です。

    6. Map ID と性能を本番用に確かめる

    Map ID は開発用の DEMO_MAP_ID から、Cloud コンソールで発行した本番用に差し替えます。本番の node .output/server/index.mjs では .env は読まれないので、キー・Map ID・パスワードはサーバーやコンテナの環境変数で渡します。性能は、npm run seed(第9回)で想定件数の店舗を入れ、本番と同じビルドを Lighthouse で計測して記録しておきます。

    7. 保存してよいもの・いけないものの最終確認

    連載の設計の中心だった「Google から取ったデータのうち、保存してよいもの・いけないもの」を最終確認します。データベースの中身がこのとおりかを確かめてください。

    データ出どころ扱い回
    店舗の緯度・経度管理画面で人が決めた値/自社の台帳(CSV)保存する(自社のデータ)5・11
    店舗名・業態・住所の表記・お知らせ自社で入力保存する3
    place_id管理画面で Google マップ上の同じ店舗を選んだ結果保存する(無期限に保存してよい)7
    来訪者の住所・駅名とその変換結果、現在地来訪者・Geocoding API・ブラウザ保存しない(検索の起点にだけ使う)6・10
    営業時間・評価Places API (New)保存しない(ボタンを押したときに取得)7
    所要時間・道のりRoutes API保存しない(画面に出すだけ)10

    Service Specific Terms(2026年11月時点で確認)では、Geocoding API・Places API・Routes API の緯度・経度は連続30暦日までの一時保存とされ、place_id は期限なく保存してよいとされています。表はこれをもとにした筆者の読み方で、最終的な判断は契約内容と規約本文をもとに法務・専門家に確認してください。

    📰 出典:Google Maps Platform「Service Specific Terms」

    なお place_id も、12か月を超えたものは取り直すよう Google は勧めています。閉店・移転で使えなくなったら、管理画面で結びつけ直します。

    📰 出典:Google Maps Platform「Place IDs」

    8. 公開前チェックリストを README.md にまとめる

    点検項目は、プロジェクトの README.md にチェックリストとして残します。ひな形の README.md を次の内容に置き換えます(中のコマンド例は ~~~ で囲んでいます)。開発会社に頼む場合も、同じ形の一覧を納品物に含めてもらうと確認が漏れにくくなります。

    README.md の全文(92行)
    <!-- README.md -->
    # gmap-shuyaku(NuxtとGoogle Mapsで作る店舗検索マップ)
    
    連載「NuxtとGoogle Mapsで作る店舗検索マップ」(全12回)のサンプルコードです。
    自社サイトに「近くの店舗を探す」ページを付ける想定で、来訪者向けの検索画面(`/`)と、店舗を登録する管理画面(`/admin`)があります。
    試作(PoC)向けで、そのまま本番運用することは想定していません(下の「本番前に残っている作業」参照)。
    
    ## 保存するもの・しないもの(この連載の設計の中心)
    
    Google Maps Platform の規約では、住所の変換(Geocoding API)・施設検索(Places API)・経路(Routes API)から得た緯度経度は、保存できるのが30日までです。place_id は期限なく保存できます。
    そこで、このサンプルは Google から取った座標を DB に入れない作りにしています。
    
    | データ | 出どころ | 扱い |
    |---|---|---|
    | 店舗の緯度・経度 | 管理画面で人が地図をクリックして決めた値/自社の台帳(CSV)の値 | 保存する(自社のデータ) |
    | 店舗の住所の表記・店舗名・お知らせ | 自社で入力 | 保存する |
    | place_id | 管理画面で Google マップ上の同じ店舗を選んだ結果 | 保存する(規約で無期限に保存してよい) |
    | 来訪者が入れた住所・駅名、その変換結果、現在地 | 来訪者・Geocoding API・ブラウザ | 保存しない(その場の検索の起点にだけ使う) |
    | 営業時間・評価 | Places API(place_id で取得) | 保存しない(ボタンを押したときに取得して表示) |
    | 所要時間・道のり | Routes API | 保存しない(画面に出すだけ) |
    
    ## 動かし方
    
    ~~~bash
    cp .env.example .env   # ブラウザ用キー・Map ID・サーバー用キーを設定
    npm ci --ignore-scripts
    npx nuxt prepare
    npm run dev            # http://localhost:3000(管理画面は /admin)
    ~~~
    
    | コマンド | 内容 |
    |---|---|
    | `npm run build` / `npm run typecheck` | ビルド / 型チェック |
    | `node .output/server/index.mjs` | ビルド後のサーバーを起動(.env は読まれないので環境変数で渡す) |
    | `npm run seed` | 動作確認用のダミー店舗を5,000件追加(SQLite のみ。`node scripts/seed-points.ts --remove` で削除) |
    
    ## 環境変数
    
    | 変数 | 用途 | 公開範囲 |
    |---|---|---|
    | `NUXT_PUBLIC_GOOGLE_MAPS_API_KEY` | ブラウザ用キー(Maps JavaScript API / Places API (New)) | ブラウザに公開される前提。ウェブサイト制限+API制限で守る |
    | `NUXT_PUBLIC_GOOGLE_MAPS_MAP_ID` | Map ID(Advanced Markers に必須) | 公開 |
    | `NUXT_GOOGLE_MAPS_SERVER_KEY` | サーバー用キー(Geocoding API・Routes API) | サーバーのみ。ブラウザ用キーと別に発行 |
    | `NUXT_ADMIN_PASSWORD` | 管理画面と書き込み API のパスワード(Basic 認証) | サーバーのみ。未設定だと本番では管理画面が開かない |
    | `DB_CONNECTOR` | `postgresql` でビルドすると PostgreSQL を使う | ビルド時のみ |
    | `PGHOST` / `PGPORT` / `PGUSER` / `PGPASSWORD` / `PGDATABASE` | PostgreSQL の接続先 | 実行時・サーバーのみ |
    
    ## 公開前チェックリスト
    
    ### APIキー
    - [ ] ブラウザ用キーとサーバー用キーを分けている(1用途1キー)
    - [ ] ブラウザ用キー: アプリケーションの制限=「ウェブサイト」。本番のオリジン(例: `https://www.example.co.jp`)だけを登録し、開発用の `localhost` は別キーにする
    - [ ] ブラウザ用キー: API の制限= Maps JavaScript API と Places API (New) のみ
    - [ ] サーバー用キー: アプリケーションの制限=「IP アドレス」(サーバーの送信元 IP が固定できる場合)、API の制限= Geocoding API と Routes API のみ
    - [ ] キーがリポジトリ・ログ・画面・記事に出ていない(`.env` はコミットしない。`git log -p` でも確認)
    - [ ] ページの `Referrer-Policy` が `no-referrer` になっていない(`nuxt.config.ts` の routeRules で `strict-origin-when-cross-origin` を指定済み)
    
    ### 費用の上限
    - [ ] Cloud コンソールの「割り当て(Quotas)」で、API ごとに1日あたりのリクエスト上限を設定した(想定の数倍程度。低すぎると来訪者が使えなくなる)
    - [ ] 請求先アカウントに予算とアラート(50%・90%・100% など)を設定し、通知先に発注側の担当者を入れた(予算アラートは通知だけで、利用は止まらない)
    - [ ] 来訪者が呼べる有料の入口(住所の変換・所要時間・営業時間の表示)の回数を見積もった。サーバー側の回数制限(`server/utils/rateLimit.ts`)の値を見直した
    - [ ] GCP プロジェクト・請求先アカウントの所有者が発注側の組織になっている
    
    ### 地図・画面
    - [ ] Map ID を `DEMO_MAP_ID` から本番用に差し替えた(地図のスタイルはクラウドの設定で変えられる)
    - [ ] Google のロゴ・著作権表示、Places の帰属表示を隠していない
    - [ ] 実際に使う端末(スマートフォン等)で、想定件数の店舗を入れて操作速度を確認した
    - [ ] Lighthouse(Chrome DevTools)で性能・アクセシビリティを計測し、結果を記録した
    
    ### データと運用
    - [ ] `NUXT_ADMIN_PASSWORD` を設定し、管理画面がパスワードなしで開かないことを確かめた
    - [ ] 本番 DB(PostgreSQL 等)に切り替え、バックアップの方法を決めた
    - [ ] DB に Google から取った座標・営業時間・所要時間が入っていない(上の「保存するもの・しないもの」)
    - [ ] サーバーのログに Google のエラーが出たときに気づける仕組みがある
    
    ## 本番前に残っている作業(このサンプルでは未実装)
    
    - 管理画面のログイン(スタッフごとのアカウント・権限・操作の記録。今は共通パスワード1つの Basic 認証)
    - 店舗の編集・削除の画面(API はあるが、管理画面からは登録だけ)
    - 回数制限の共有(今はサーバー1台のメモリで数える簡易版。複数台なら Redis などで共有する)
    - DB のマイグレーション(今は起動時に `CREATE TABLE IF NOT EXISTS` を実行する簡易版)
    - 監視・バックアップ・HTTPS の終端(リバースプロキシ等)
    
    ## PostgreSQL への切り替え
    
    ~~~bash
    DB_CONNECTOR=postgresql npm run build
    PGHOST=... PGUSER=... PGPASSWORD=... PGDATABASE=... node .output/server/index.mjs
    ~~~
    
    テーブルは起動時に作られます(連番は `GENERATED ALWAYS AS IDENTITY`、座標は `DOUBLE PRECISION`)。
    SQLite のデータは自動では移行されません。シードのスクリプトは SQLite 専用です。

    コラム:vue3-google-map との比較

    本連載は、Google 公式の @googlemaps/js-api-loader を薄い composable で包む方式でした。Vue 向けには、<GoogleMap> や <AdvancedMarker> のように部品として地図を書ける vue3-google-map(コミュニティ製、執筆時点で 0.27 系)もあります。

    観点本連載の方式(js-api-loader)vue3-google-map
    書き方公式ドキュメントに近い命令的な書き方部品を並べる宣言的な書き方
    新機能への追従公式の新しいクラスをすぐ使えるライブラリ側の対応を待つことがある
    大量の店舗クラスタリングや差分更新を制御しやすい(第9回)店舗1つ=部品1つで、数千件では工夫が必要

    どちらが正解というより、店舗数と求める機能で選ぶものです。

    動作確認の方法

    本番ビルド(npm run build → node .output/server/index.mjs)で、管理用パスワードの有無による 503・401、住所の検索の 429、PostgreSQL での動作を確かめます。あわせて、キーの制限に登録していないオリジン(例:http://127.0.0.1:3000)では地図が拒否されることも確認します。筆者の環境では、npm run build と npm run typecheck の成功と、curl で次の結果を確認しました。

    確認したこと結果
    パスワード未設定の本番ビルド/admin・POST /api/points とも 503
    パスワードを設定した本番ビルドなし・誤りは 401(WWW-Authenticate つき)、正しいと 200。登録 201・更新 200・削除 204
    住所の検索を1分に22回20回目まではサーバーが Google を呼び、21回目から 429
    PostgreSQL 16.15 に接続テーブル作成、一覧・近い店舗・表示範囲の検索、登録・更新・削除、CSV 取り込みが SQLite と同じ結果

    ブラウザでは、パスワードなしで管理画面を開くと 401 の表示になるところまでを確認しました。リファラー制限の体感、Cloud コンソールでの設定、Lighthouse の計測は、執筆環境に本物の API キーとプロジェクトが無いため確認できていません。ご自身のプロジェクトで確認してください。

    つまずきやすい点・セキュリティ上の注意

    • Basic 認証を HTTP のまま使う:パスワードはほぼそのままの形で送られるので、本番は必ず HTTPS にします
    • 接続元の IP の取り方:rateLimit.ts はロードバランサーの後ろで動かす前提で、X-Forwarded-For ヘッダーから接続元を読みます。このヘッダーは送る側が書けるため、サーバーを直接公開するなら使わない設定にします
    • 回数制限が厳しすぎる:会社など多くの人が同じ IP から使う場所では、すぐ上限に達することがあります。公開後のログを見て調整します

    本番前に残っている作業

    残っている作業内容
    管理画面のログインスタッフごとのアカウント・権限・操作の記録
    店舗の編集・削除の画面API はあるが、画面は登録だけ
    回数制限の共有複数台なら Redis などで共有
    法務確認保存するデータの扱い、規約の読み方
    マイグレーションと運用基盤テーブルの変更履歴、HTTPS、監視、バックアップ

    発注者向けメモ

    • 公開ページの費用は来訪者の数と操作の回数に比例します。キーの制限・クォータ・予算アラート・回数制限が見積もりや設計書に入っているか、予算アラートの通知先に発注側の担当者が入っているかを確認してください
    • 管理画面の保護は「共通パスワード」か「スタッフごとのログイン」かで工数が大きく変わります。担当者の人数と、変更の記録が必要かを先に伝えましょう
    • 性能の受け入れ基準は「どの端末・何店舗で・何秒以内」の形で決めておくと、検収の話し合いが短くなります

    発注者がやることのチェックリストです。

    • ☐ GCP プロジェクト・請求先アカウントが自社の名義になっている
    • ☐ キーが2本に分かれ、それぞれ制限されている
    • ☐ クォータと予算アラートが設定され、通知先に自社の担当者が入っている
    • ☐ 管理画面がパスワードなしでは開けないことを確かめた
    • ☐ 保存するデータについて法務確認を依頼した

    開発会社への確認に使える質問例です。

    • 「キーが漏れた場合、どこまで被害が出て、どう止めますか?」
    • 「クォータと回数制限はいくつに設定しますか?その根拠は?」
    • 「Google から取ったデータで、データベースに保存しているものはありますか?」

    全12回の振り返り

    回タイトル
    第1回APIキーとMap IDを用意して、Nuxt 4で地図を1枚表示する
    第2回Advanced Markersで業態ごとに色分けした店舗のピンを立てる
    第3回店舗データをNuxt server API + SQLiteに保存する
    第4回ピンをクリックしてInfoWindowと店舗の詳細パネルを出す
    第5回管理画面で地図をクリックして店舗の位置を決める
    第6回来訪者が入れた住所・駅名から近い店舗を探す(Geocoding API v4をサーバー経由で)
    第7回Places API (New)で店舗をGoogleマップの情報と結びつけ、営業時間と評価を出す
    第8回業態で絞り込み、店舗一覧と地図を連動させる
    第9回店舗が数千件でも重くしない:クラスタリングと表示範囲読み込み
    第10回現在地から半径◯km以内の店舗を探し、徒歩・車の所要時間を出す(Routes API)
    第11回CSVで既存の店舗台帳を一括取り込みする
    第12回本番公開前チェック:APIキー制限・クォータ・予算アラート・管理画面の保護(この記事)

    まとめ:連載を振り返って

    最終回では、キーの制限、クォータと予算アラート、管理画面の保護、有料 API の回数制限、本番データベース、保存するデータを点検しました。公開ページは誰でも有料の API を呼べる入口なので、対策を重ねて上限を仕組みで決めることが押さえどころです。

    全12回を通して意識してきたのは、「その操作で Google の課金が起きるか」「そのデータを保存してよいか」を機能ごとに確かめることです。開発会社と話すときや、自社で小さく作るときの手がかりになればうれしいです。

    この連載の記事一覧

    この記事は連載「NuxtとGoogle Mapsで作る店舗検索マップ」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。

    システム制作・運用・保守のお問い合わせはこちら

      お問い合わせ


      よかったらシェアしてね!
      • URLをコピーしました!
      • URLをコピーしました!

      この記事を書いた人

      株式会社THIRD HERO代表取締役 朝野貴朗
      Webシステム開発を中心に、toC向けサービスサイトの運営、ツール開発などを行ってまいりました。

      目次