MENU

問い合わせ

    お問い合わせ


    【NuxtとGoogle Mapsで作る店舗検索マップ 第3回】店舗データをNuxt server API + SQLiteに保存する

    Google Maps API と Nuxt で、自社サイトに「近くの店舗を探す」ページを作る連載の第3回です。前回(第2回)では、ファイルに直書きしたサンプル20店舗を、Advanced Markers で業態ごとに色分けしたピンとして表示しました。今回は店舗データを Nuxt のサーバーAPIとSQLite(データベース) に移し、登録・更新・削除ができる土台を作ります。

    「店舗の場所なら Google マップに載っているのに、わざわざ自社でデータベースを持つ必要があるの?」

    結論から言うと、店舗データは自社のデータベースに持ち、Google から取ったデータは入れないのが基本です。Google Maps Platform の規約では、住所変換や施設検索で得た緯度経度は30日までしか保存できません。一方、自社で決めた店舗の座標・住所の表記・お知らせは自社のデータなので、期限を気にせず持てます。Google のデータで保存してよいのは、店舗を Google マップ上の同じ店舗と結びつけるための place_id だけです。この回は地図の見た目は変わりませんが、以降のすべての回の土台になります。

    目次

    この回で作るもの:店舗データのサーバーAPI

    ブラウザの画面は、Nuxt のサーバー側に用意した API(/api/points)を呼び出して店舗データをやり取りします。コード上は、店舗1件を「地図上の点」として Point と呼び、テーブル名も points にしています。

    メソッドとURL動き
    GET /api/points全店舗を返す
    POST /api/points店舗を1件登録(成功時 201。第5回の管理画面から呼ぶ)
    PUT /api/points/:id店舗を更新(存在しなければ 404)
    DELETE /api/points/:id店舗を削除(成功時 204)

    不正な値(緯度 999 や業態名の間違い)は、サーバー側で 400 エラーとして弾きます。画面の入力チェックは使い勝手のため、サーバー側のチェックは安全のため、と役割を分けて考えます。

    使う仕組み

    用語意味
    server APINuxt の server/api/ に置いたファイルが、そのまま API の URL になる仕組み
    NitroNuxt のサーバー部分を動かしているエンジン
    db0 / useDatabase()Nitro から SQL データベースを扱うための仕組み。接続先(connector)を差し替えられる
    SQLiteファイル1つで動くデータベース。開発・試作に向く
    node:sqliteNode.js に組み込まれた SQLite。追加のネイティブモジュールのビルドが不要
    zod入力値の形式をチェックするライブラリ(この連載では zod 4)

    SQLite の接続に Node.js 組み込みの node:sqlite を使うのは、better-sqlite3 のようなネイティブモジュール(C++ で書かれた部品)のビルドが要らず、環境によるつまずきが少ないためです。本番では PostgreSQL などに connector を差し替える前提で、SQL は db0 の書き方に統一しておきます(第12回)。

    DB に入れるのは自社のデータと place_id だけ

    テーブルの列を決める前に、「どの値をどこから持ってきて、保存してよいのか」を整理しておきます。店舗検索マップで扱う値と、保存するかどうかは次のとおりです。

    値出どころ保存
    店舗名・業態・住所の表記・お知らせ自社で入力する(自社のデータ)
    店舗の緯度・経度管理画面で人が地図をクリックして決める(第5回)・自社の台帳(第11回)する(自社で決めた値)
    place_id(Google マップ上の店舗の ID)Google(第7回で管理画面から結びつける)する(無期限に保存してよい)
    来訪者が入れた住所・現在地、住所変換の結果来訪者・Googleしない(その検索の起点にだけ使う。第6・10回)
    営業時間・評価・所要時間Googleしない(その場で取得して表示する。第7・10回)

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

    2026年11月時点の Service Specific Terms を筆者が読んだ範囲では、place_id は保存期間の制限を受けない(Google ID のキャッシュとして無期限に保存してよい)とされています。一方で、Geocoding API・Places API・Routes API から得た緯度経度は、最大で連続30日までの一時保存にとどめ、その後は削除することになっています。

    そこでこの連載では、Google から取った座標は DB に入れず、店舗の座標は自社で決めた値だけを持つ設計にします。Google の店舗情報とは place_id で結びつけておき、営業時間や評価が必要になったら、その都度 place_id で問い合わせます。規約の読み方は筆者の解釈なので、実際の案件では契約内容とあわせて、法務担当や専門家に確認してください。

    place_id の列はこの回で用意し、値は第7回から入れます。

    実装:Nitro のデータベース機能を有効にする

    この回で追加・変更するファイルは次のとおりです。

    ファイル役割
    nuxt.config.tsデータベース機能の有効化と接続設定(更新)
    .gitignoreSQLite のファイルを除外(更新)
    shared/types/point.ts店舗の型(第2回の app/types/ から移動し、placeId を追加)
    server/utils/pointSchema.tszod による入力検証(新規)
    server/utils/points.tsDB の行 → API の形への変換(新規)
    server/data/sample-points.tsサンプル20店舗(第2回の app/data/ から移動)
    server/plugins/db-init.ts起動時のテーブル作成とサンプル投入(新規)
    server/api/points/*.ts4つの API(新規)
    app/pages/index.vueuseFetch で API から取得して表示(更新)
    app/composables/useMarkers.ts / app/components/CategoryLegend.vue型の読み込み先の変更・件数の表示(更新)
    app/assets/css/main.css件数のスタイル(更新)

    手順1:zod を入れて、データベース機能を有効にする

    入力チェックに使う zod を追加します。

    npm install zod@4 --ignore-scripts

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

    --- a/nuxt.config.ts
    +++ b/nuxt.config.ts
    @@ -28,4 +28,18 @@ export default defineNuxtConfig({
       typescript: {
         strict: true,
       },
    +
    +  // 第3回: Nitro の SQL データベース機能(experimental)。
    +  // node:sqlite(Node.js 組み込み)を使う db0 の connector で .data/gmap.sqlite に保存する。
    +  nitro: {
    +    experimental: {
    +      database: true,
    +    },
    +    database: {
    +      default: {
    +        connector: 'node-sqlite',
    +        options: { name: 'gmap' },
    +      },
    +    },
    +  },
     })

    📰 出典:Nitro「SQL Database」

    Nitro のデータベース機能は、執筆時点(2026年11月)でも experimental(実験的機能) の扱いです。設定は公式ガイドどおり experimental.database を有効にし、database に接続先を書きます。connector 名 node-sqlite は、Nuxt 4 に同梱されている db0 に含まれていることを確認しました。name: 'gmap' にすると、起動したディレクトリの .data/gmap.sqlite にデータが保存されます。

    .data/ は .gitignore で除外済みなので、開発中のデータがリポジトリに入ることはありません。念のため、SQLite のファイルを名前でも除外しておきます。

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

    --- a/.gitignore
    +++ b/.gitignore
    @@ -22,3 +22,9 @@ logs
     .env
     .env.*
     !.env.example
    +
    +# SQLite (開発用DB)
    +*.sqlite
    +*.sqlite-journal
    +*.sqlite-wal
    +*.sqlite-shm

    📰 出典:Node.js 24「SQLite」

    手順2:型をサーバーと画面で共有する(shared/)

    第2回では店舗の型を app/types/point.ts に置きましたが、サーバー側の入力チェックでも同じ業態の定義を使いたいので、shared/types/point.ts に移します。Nuxt 4 の shared/ ディレクトリは、画面(Vue)とサーバー(Nitro)の両方から使うコードの置き場で、#shared/... で読み込めます。

    📰 出典:Nuxt「shared/ directory」

    ファイルを移動してから、項目を足します。

    mkdir -p shared/types
    mv app/types/point.ts shared/types/point.ts

    shared/types/point.ts に次の変更を加えます(+ が追加、- が削除。差分の元は移動前の app/types/point.ts です)。

    --- a/app/types/point.ts
    +++ b/shared/types/point.ts
    @@ -1,5 +1,5 @@
    -// app/types/point.ts
    -// 店舗データの型と業態の定義
    +// shared/types/point.ts
    +// 店舗データの型と業態の定義(画面・サーバーの両方から使うため shared/ に置く)
     // 型の名前は「地図上の点」を表す Point にしている(1件 = 1店舗・1拠点)
    
     export const CATEGORIES = ['direct', 'partner', 'showroom', 'service'] as const
    @@ -15,6 +15,7 @@ export interface Point {
       lng: number
       address: string // 画面に出す住所の表記(自社で管理する文字列)
       memo: string
    +  placeId: string | null // Google マップ上の同じ店舗の place_id(第7回。無期限に保存してよい値)
       updatedAt: string // ISO 8601
     }
    

    先頭のコメントのほかに足したのは placeId の1行だけで、結びつけていない店舗は null にします。shared/ には型と定数だけを置きます(Vue やサーバー専用のコードは読み込めません)。

    型の置き場所が変わったので、第2回で作った2つのファイルの import を #shared/types/point に直します。凡例には、店舗の件数(「全 20 件」)を出すための count も足します。

    app/composables/useMarkers.ts に次の変更を加えます(+ が追加、- が削除)。

    --- a/app/composables/useMarkers.ts
    +++ b/app/composables/useMarkers.ts
    @@ -1,5 +1,5 @@
     // app/composables/useMarkers.ts
    -import { CATEGORY_META, type Point } from '~/types/point'
    +import { CATEGORY_META, type Point } from '#shared/types/point'
    
     /**
      * 店舗データから Advanced Marker を作って地図に載せる。

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

    --- a/app/components/CategoryLegend.vue
    +++ b/app/components/CategoryLegend.vue
    @@ -1,7 +1,10 @@
     <!-- app/components/CategoryLegend.vue -->
     <script setup lang="ts">
     // 第2回: 業態の凡例(ピンの色と文字の見本)
    -import { CATEGORIES, CATEGORY_META } from '~/types/point'
    +// 第3回: 店舗の件数も表示する
    +import { CATEGORIES, CATEGORY_META } from '#shared/types/point'
    +
    +defineProps<{ count?: number }>()
     </script>
    
     <template>
    @@ -12,5 +15,6 @@ import { CATEGORIES, CATEGORY_META } from '~/types/point'
           </span>
           {{ CATEGORY_META[c].label }}
         </li>
    +    <li v-if="count !== undefined" class="legend__count">全 {{ count }} 件</li>
       </ul>
     </template>

    手順3:入力チェックを zod で書く

    // server/utils/pointSchema.ts
    import { z } from 'zod'
    import { CATEGORIES } from '#shared/types/point'
    
    // POST / PUT /api/points の入力検証。ブラウザ側の入力チェックとは別に、サーバーで必ず検証する。
    export const pointInputSchema = z.object({
      name: z.string().trim().min(1, '店舗名は必須です').max(100),
      category: z.enum(CATEGORIES),
      lat: z.number().min(-90).max(90),
      lng: z.number().min(-180).max(180),
      address: z.string().trim().max(200).default(''),
      memo: z.string().max(2000).default(''),
      // Google マップ上の同じ店舗の place_id(第7回で使う。結びつけない場合は null)
      placeId: z.string().min(1).max(300).nullable().default(null),
    })
    
    export type PointInput = z.input<typeof pointInputSchema>
    
    // ルートパラメータ /api/points/:id の検証
    export const pointIdSchema = z.object({
      id: z.coerce.number().int().positive(),
    })

    業態は第2回の CATEGORIES をそのまま使うので、業態を増やしてもチェックの修正漏れが起きません。住所・お知らせ・place_id は省略でき、省略時は空文字や null になります。PointInput は「入力として受け付ける形」の型で、手順5のサンプルデータもこの型で書きます。

    server/utils/ に置いたものは Nuxt が自動で読み込むため、各 API ファイルで import せずに使えます。

    📰 出典:Zod(公式ドキュメント)

    手順4:DB の行を API の形に変換する

    // server/utils/points.ts
    import type { Category, Point } from '#shared/types/point'
    
    // DB の行(snake_case)
    export interface PointRow {
      id: number
      name: string
      category: Category
      lat: number
      lng: number
      address: string
      memo: string
      place_id: string | null
      updated_at: string
    }
    
    // DB の行 → API で返す形(camelCase)
    export function toPoint(row: PointRow): Point {
      return {
        id: row.id,
        name: row.name,
        category: row.category,
        lat: row.lat,
        lng: row.lng,
        address: row.address,
        memo: row.memo,
        placeId: row.place_id,
        updatedAt: row.updated_at,
      }
    }

    DB の列名は updated_at のような snake_case(単語を _ でつなぐ書き方)、画面の型は updatedAt のような camelCase です。変換を1か所にまとめておくと、列を足したときの修正箇所がはっきりします。

    手順5:サンプル店舗をサーバー側に移す

    サンプル店舗はサーバー側に移します。ID と更新日時は DB が決めるので項目から外し、型は手順3の PointInput にします。画面側の app/data/ は使わなくなるので削除します。

    mkdir -p server/data
    rm -r app/data
    // server/data/sample-points.ts
    import type { PointInput } from '../utils/pointSchema'
    
    // 初回起動時に DB へ投入するサンプル店舗(東京駅周辺・架空のデータ)
    // 緯度・経度は自分で決めた値なので、Google の規約上の保存期間の制限は関係しない
    export const samplePoints: PointInput[] = [
      { name: '丸の内店', category: 'direct', lat: 35.6812, lng: 139.7644, address: '東京都千代田区丸の内1丁目' },
      { name: '八重洲店', category: 'direct', lat: 35.6795, lng: 139.7702, address: '東京都中央区八重洲1丁目' },
      { name: '日本橋店', category: 'direct', lat: 35.6841, lng: 139.7745, address: '東京都中央区日本橋2丁目' },
      { name: '有楽町店', category: 'direct', lat: 35.6751, lng: 139.7630, address: '東京都千代田区有楽町2丁目' },
      { name: '大手町店', category: 'direct', lat: 35.6865, lng: 139.7660, address: '東京都千代田区大手町1丁目' },
      { name: '京橋 取扱店', category: 'partner', lat: 35.6770, lng: 139.7708, address: '東京都中央区京橋1丁目' },
      { name: '神田駅前 取扱店', category: 'partner', lat: 35.6906, lng: 139.7706, address: '東京都千代田区鍛冶町2丁目' },
      { name: '銀座一丁目 取扱店', category: 'partner', lat: 35.6740, lng: 139.7680, address: '東京都中央区銀座1丁目' },
      { name: '内神田 取扱店', category: 'partner', lat: 35.6895, lng: 139.7672, address: '東京都千代田区内神田3丁目' },
      { name: '宝町 取扱店', category: 'partner', lat: 35.6755, lng: 139.7745, address: '東京都中央区京橋2丁目' },
      { name: '八重洲ショールーム', category: 'showroom', lat: 35.6788, lng: 139.7728, address: '東京都中央区八重洲2丁目' },
      { name: '日本橋本町ショールーム', category: 'showroom', lat: 35.6875, lng: 139.7760, address: '東京都中央区日本橋本町1丁目' },
      { name: '丸の内三丁目ショールーム', category: 'showroom', lat: 35.6772, lng: 139.7625, address: '東京都千代田区丸の内3丁目' },
      { name: '鍛冶町ショールーム', category: 'showroom', lat: 35.6918, lng: 139.7730, address: '東京都千代田区鍛冶町1丁目' },
      { name: '京橋二丁目ショールーム', category: 'showroom', lat: 35.6760, lng: 139.7690, address: '東京都中央区京橋2丁目' },
      { name: '呉服橋 修理窓口', category: 'service', lat: 35.6830, lng: 139.7715, address: '東京都中央区八重洲1丁目' },
      { name: '大手町 修理窓口', category: 'service', lat: 35.6848, lng: 139.7632, address: '東京都千代田区大手町2丁目' },
      { name: '日本橋室町 修理窓口', category: 'service', lat: 35.6860, lng: 139.7730, address: '東京都中央区日本橋室町1丁目' },
      { name: '有楽町 修理窓口', category: 'service', lat: 35.6735, lng: 139.7650, address: '東京都千代田区有楽町1丁目' },
      { name: '八重洲一丁目 修理窓口', category: 'service', lat: 35.6815, lng: 139.7730, address: '東京都中央区八重洲1丁目' },
    ]

    手順6:起動時にテーブルを用意する

    // server/plugins/db-init.ts
    import { samplePoints } from '../data/sample-points'
    
    // サーバー起動時にテーブルを用意し、空ならサンプル店舗を入れる。
    // 本番では専用のマイグレーションツールに置き換える前提の簡易版(第12回参照)。
    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
      )`
    
      const { rows } = await db.sql`SELECT COUNT(*) AS count FROM points`
      if (Number(rows?.[0]?.count ?? 0) > 0) return
    
      const now = new Date().toISOString()
      for (const p of samplePoints) {
        await db.sql`INSERT INTO points (name, category, lat, lng, address, memo, updated_at)
          VALUES (${p.name}, ${p.category}, ${p.lat}, ${p.lng}, ${p.address ?? ''}, ${p.memo ?? ''}, ${now})`
      }
    })

    server/plugins/ のファイルは、サーバーの起動時に1回実行されます。テーブルが無ければ作り、空ならサンプル20件を入れます。本番では、マイグレーション(=DB の構造を変える手順を履歴として管理する仕組み)に置き換えるのが一般的です。

    テーブルの列は、手順の前に整理した「保存してよいもの」と一致しています。Google から取った値の列は place_id だけで、来訪者の検索の起点や営業時間を入れる列はありません。列が無ければ、うっかり保存することもありません。

    db.sql の直後にバッククォートで SQL を書き、値を ${} で差し込む書き方(タグ付きテンプレート)がポイントです。${} に入れた値は SQL に直接埋め込まれるのではなく、プレースホルダー(?)として安全に渡されます。SQL インジェクション(=入力値を悪用して SQL を書き換える攻撃)を防ぐ基本なので、文字列を連結して SQL を組み立てることはしません。

    手順7:4つの API を書く

    // server/api/points/index.get.ts
    import type { PointRow } from '../../utils/points'
    
    // GET /api/points … 店舗を返す(第9回で表示範囲による絞り込みを追加)
    export default defineEventHandler(async () => {
      const db = useDatabase()
      const { rows } = await db.sql`SELECT * FROM points ORDER BY id`
      return (rows as unknown as PointRow[]).map(toPoint)
    })

    ファイル名の index.get.ts は「/api/points への GET」を意味します。同じように index.post.ts は POST、[id].put.ts は /api/points/:id への PUT になります。

    // server/api/points/index.post.ts
    import type { PointRow } from '../../utils/points'
    
    // POST /api/points … 店舗を1件登録(第5回の管理画面から呼ぶ)
    export default defineEventHandler(async (event) => {
      // 検証に失敗すると 400(Validation Error)を返す
      const input = await readValidatedBody(event, (body) => pointInputSchema.parse(body))
      const db = useDatabase()
      const now = new Date().toISOString()
    
      const { rows } = await db.sql`INSERT INTO points
          (name, category, lat, lng, address, memo, place_id, updated_at)
        VALUES (${input.name}, ${input.category}, ${input.lat}, ${input.lng}, ${input.address},
          ${input.memo}, ${input.placeId}, ${now})
        RETURNING *`
    
      setResponseStatus(event, 201)
      return toPoint(rows![0] as unknown as PointRow)
    })

    readValidatedBody は、リクエストの本文を読み取って検証関数に通す関数です。zod の parse が失敗すると例外が投げられ、自動的に 400(Validation Error)が返ります。RETURNING * は、登録した行をそのまま返してもらう SQL の書き方で、SQLite と PostgreSQL の両方で使えます。

    // server/api/points/[id].put.ts
    import type { PointRow } from '../../utils/points'
    
    // PUT /api/points/:id … 店舗を更新(全項目を送る)
    export default defineEventHandler(async (event) => {
      const { id } = await getValidatedRouterParams(event, (p) => pointIdSchema.parse(p))
      const input = await readValidatedBody(event, (body) => pointInputSchema.parse(body))
      const db = useDatabase()
      const now = new Date().toISOString()
    
      const { rows } = await db.sql`UPDATE points
        SET name = ${input.name}, category = ${input.category}, lat = ${input.lat},
            lng = ${input.lng}, address = ${input.address}, memo = ${input.memo},
            place_id = ${input.placeId}, updated_at = ${now}
        WHERE id = ${id}
        RETURNING *`
    
      if (!rows?.length) {
        throw createError({ statusCode: 404, statusMessage: 'Point not found' })
      }
      return toPoint(rows[0] as unknown as PointRow)
    })

    更新は「全項目を送る」形にしています。getValidatedRouterParams で URL の :id を数値として検証し、数字でない ID は 400 になります。

    削除も同じ形で、DELETE FROM points WHERE id = ${id} RETURNING id の結果が空なら 404、削除できたら 204 を返します。

    // server/api/points/[id].delete.ts
    // DELETE /api/points/:id … 店舗を削除
    export default defineEventHandler(async (event) => {
      const { id } = await getValidatedRouterParams(event, (p) => pointIdSchema.parse(p))
      const db = useDatabase()
    
      const { rows } = await db.sql`DELETE FROM points WHERE id = ${id} RETURNING id`
      if (!rows?.length) {
        throw createError({ statusCode: 404, statusMessage: 'Point not found' })
      }
      setResponseStatus(event, 204)
      return null
    })

    手順8:画面は API から取得する

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

    --- a/app/pages/index.vue
    +++ b/app/pages/index.vue
    @@ -1,17 +1,24 @@
     <!-- app/pages/index.vue -->
     <script setup lang="ts">
    -import { samplePoints } from '~/data/sample-points'
    +import type { Point } from '#shared/types/point'
    
    +const { data: points } = await useFetch<Point[]>('/api/points', { default: () => [] })
     const { render } = useMarkers()
    +const map = shallowRef<google.maps.Map | null>(null)
    
    -async function onMapReady(map: google.maps.Map) {
    -  await render(map, samplePoints)
    +function onMapReady(m: google.maps.Map) {
    +  map.value = m
     }
    +
    +// 地図の準備ができた時点と、データが変わった時点でピンを描き直す
    +watch([map, points], ([m, list]) => {
    +  if (m) render(m, list)
    +})
     </script>
    
     <template>
       <div class="map-page">
    -    <CategoryLegend />
    +    <CategoryLegend :count="points.length" />
         <ClientOnly>
           <MapView @ready="onMapReady" />
           <template #fallback>

    useFetch は、サーバー側で HTML を作るときにデータを取得し、その結果をブラウザに引き継ぎます。地図の読み込みを待たずに「全 20 件」のような内容を返せます。「地図の準備」と「データの取得」はどちらが先に終わるか分からないため、両方を watch して、そろった時点でピンを描くようにしました。

    件数のスタイルを CSS に足します。

    app/assets/css/main.css に次の変更を加えます(+ が追加、- が削除)。

    --- a/app/assets/css/main.css
    +++ b/app/assets/css/main.css
    @@ -119,3 +119,8 @@ body {
       color: #fff;
       font-size: 12px;
     }
    +
    +.legend__count {
    +  margin-left: auto;
    +  color: #57606a;
    +}

    動作確認の方法

    1. npm run dev で起動し、http://localhost:3000 で第2回と同じ20個のピンが出ることを確認
    2. curl localhost:3000/api/points で20件の JSON が返り、各店舗に "placeId": null が入っていることを確認
    3. 下のコマンドで1件追加し、画面を再読み込みするとピンが21個・凡例が「全 21 件」になることを確認
    4. 同じコマンドの "lat" を 999 に、または "category" を "store"(存在しない業態)に変えて送ると 400 が返ることを確認
    5. git status に .data/gmap.sqlite が出てこない(gitignore されている)ことを確認
    curl -X POST -H 'Content-Type: application/json' \
      -d '{"name":"テスト店","category":"direct","lat":35.68,"lng":139.76,"address":"東京都千代田区丸の内1丁目"}' \
      localhost:3000/api/points

    筆者の環境では、npm run build・npm run typecheck の成功と、ビルド後のサーバー(node .output/server/index.mjs)に対する curl で、一覧の取得(20件)、登録(201)、不正な緯度・業態(400)、place_id つきの更新(200)、削除(204)、削除済みの ID の削除(404)、数字でない ID(400)、サーバーが返す HTML の「全 20 件」を確認しました。ピンの地図上での表示は、執筆環境に本物の API キーがないため確認できていません。 ご自身のキーを .env に設定して確認してください。

    つまずきやすい点・本番で必要になること

    • experimental 機能であること:Nitro のデータベース機能は、将来のバージョンで設定方法が変わる可能性があります。アップデート時はリリースノートを確認してください
    • SQLite ファイルの置き場所:.data/ は起動したディレクトリの下にできます。サーバーを複数台に増やす構成や、再デプロイでファイルが消える環境(コンテナなど)では、SQLite のままでは運用できません。本番は PostgreSQL などへの切り替えを前提にします(第12回)
    • 書き込みの API に認証がない:この段階では、URL を知っていれば誰でも店舗を登録・削除できます。公開ページと同じサーバーに置く以上、公開前に管理画面と書き込み API を守る仕組みが必要です。第12回で最小限の Basic 認証を入れます
    • Google の値を「ついでに」保存しない:あとの回で住所変換や施設検索を使うと、応答に緯度経度や住所が入っています。便利だからといって DB に入れると、30日の制限に当たります。列を増やすときは「その値はどこから来たか」を必ず確認します

    発注者向けメモ

    • この回の作業は Google の課金とは無関係です。DB と API は自社で作る部分で、費用は開発工数とサーバー代です
    • 「DB に何を保存するか」を設計書で確認しましょう。自社のデータ(店舗名・住所の表記・自社で決めた座標・お知らせ)と place_id 以外に、Google から取った値を保存する列が無いかが確認点です。後から「保存してはいけない値が入っていた」と分かると、データの洗い出しと作り直しが必要になります
    • 店舗データの「持ち主」と更新の流れを決めておく。誰が店舗を登録・修正し、閉店した店舗をいつ消すのかは、管理画面の作り(第5回)と権限の設計に直結します。工数が増えやすいのは、承認の流れや変更履歴が必要な場合です
    • 本番の DB とバックアップも見積もりの確認事項です。試作で SQLite を使っていても、本番で何を使い、どう復旧するのかを決めておく必要があります

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

    • 「店舗データの DB に、Google の API から取った値は保存されますか?保存するのは place_id だけですか?」
    • 「入力値のチェックは、画面側だけでなくサーバー側でも行っていますか?」
    • 「店舗の登録・削除ができるのは誰ですか?その API はどのように守られますか?」
    • 「本番のデータベースとバックアップ・復旧の方法は、どう想定していますか?」

    まとめと次回予告

    この回では、Nitro のデータベース機能と Node.js 組み込みの SQLite を使って、店舗データの登録・取得・更新・削除 API を作り、画面を useFetch で API から読む形に切り替えました。DB に入れるのは自社のデータと place_id だけにする、型を shared/ で画面とサーバーに共有する、SQL は db.sql のテンプレート記法で値を安全に渡す、入力はサーバー側で zod で検証する、の4点が押さえどころです。

    次回(第4回)は「ピンをクリックしてInfoWindowと店舗の詳細パネルを出す」です。ピンをクリックすると吹き出し(InfoWindow)に業態と住所、右側のパネルに店舗の詳細が出るようにし、Google マップの経路案内へのリンクも付けます。

    この連載の記事一覧

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

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

      お問い合わせ


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

      この記事を書いた人

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

      コメント

      コメント一覧 (2件)

      目次