MENU

問い合わせ

    お問い合わせ


    【NuxtとGoogle Mapsで作る店舗検索マップ 第11回】CSVで既存の店舗台帳を一括取り込みする

    Google Maps API と Nuxt で自社サイトの店舗検索マップを作る連載の第11回です。前回(第10回)では、現在地から半径◯km以内の店舗を探し、徒歩・車の所要時間を Routes API で出せるようにしました。今回は管理画面に、Excel などで管理している既存の店舗台帳を CSV で一括取り込みする画面(/admin/import)を作ります。

    「店舗の一覧はもう Excel にある。数十店舗を1件ずつ地図で登録し直すのは大変だけど、住所だけの台帳でも CSV でまとめて入れられる?」

    結論から言うと、この回の取り込みでは緯度・経度を必須にし、住所だけの行は取り込みません。Google の住所変換(Geocoding API)で得た座標は、規約上30日以内に消すか取り直す必要があり、ずっと使う店舗台帳には混ぜられないためです。座標が無い店舗は、管理画面で地図をクリックして決めるか、公的なデータで自社で変換してから取り込みます。取り込みでは Google の API を呼ばないので、Google の費用もかかりません。

    目次

    この回で作るもの:CSVの店舗台帳の一括取り込み

    画面の流れは「選ぶ → プレビュー → 取り込む」です。

    手順画面の動き
    1. CSV ファイルを選ぶサーバーが全行を検証し、判定(登録できる/重複/エラー)と理由を表示。まだ登録しない
    2. 「◯件を取り込む」を押す登録できる行をまとめて登録し、行ごとの結果を表示
    3. 同じ CSV をもう一度選ぶ登録済みの行は「重複のためスキップ」になる

    動作確認用に、7行の CSV(緯度・経度あり5行、住所だけ1行、業態が不正な1行)を用意しました。プロジェクトに samples/ フォルダを作り、次の内容を samples/points-sample.csv として保存します(文字コードは UTF-8)。店舗名はすべて架空です。

    店舗名,業態,住所,緯度,経度,place_id,メモ
    CSV取込 神田店,直営店,東京都千代田区鍛冶町2丁目,35.6918,139.7709,,緯度経度あり
    CSV取込 新橋 取扱店,取扱店,東京都港区新橋2丁目,35.6664,139.7580,,緯度経度あり
    CSV取込 浜松町ショールーム,ショールーム,東京都港区浜松町2丁目,35.6554,139.7571,,緯度経度あり
    CSV取込 田町 修理窓口,修理窓口,東京都港区芝5丁目,35.6457,139.7476,,緯度経度あり
    CSV取込 秋葉原店,direct,東京都千代田区外神田1丁目,35.6984,139.7731,,英語の業態名も可
    CSV取込 銀座店,直営店,東京都中央区銀座4丁目,,,,住所だけ(位置は管理画面で決める)
    CSV取込 誤りのある行,倉庫,東京都中央区日本橋1丁目,35.68,139.76,,業態が不正

    業態は第2回の4種類(直営店・取扱店・ショールーム・修理窓口)で、direct のような英語の値も受け付けます。place_id は、台帳に Google マップの店舗の ID(第7回)を控えてある場合だけ入れます。

    仕組み:なぜ緯度・経度を必須にするのか

    Google の住所変換で埋めると、30日の制限がかかる座標が台帳に混ざる

    Google Maps Platform の Service Specific Terms(2026年11月時点で確認)では、Geocoding API から得た緯度・経度は連続30暦日まで一時的にキャッシュ(保存)でき、その後は削除すると定められています。place_id は期限なく保存してよいとされていますが、緯度・経度は別扱いです。

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

    店舗台帳は何年も使うデータです。期限付きの座標が混ざると、自社で決めた座標と区別し、定期的に取り直す仕組みと費用が必要になります。Geocoding には、エンドユーザー向けの機能のためだけに保存する場合の例外の条文もありますが、すべての来訪者に見せる店舗台帳は当てはまらない可能性が高い、というのが筆者の読み方です。最終的な判断は、契約内容と規約本文をもとに法務・専門家に確認してください。

    そこで本連載では、第5回で決めた「店舗の座標は自社で決めた値だけを保存する」方針を CSV にも当てはめました。取り込めるのは、自社の台帳に緯度・経度が入っている店舗だけです。

    プレビューと取り込みを同じ API で行う

    設計理由
    CSV の解析と検証はサーバーで行う(papaparse と zod)画面側の検証は迂回できるため。第3回と同じく最終チェックはサーバー
    dryRun: true(プレビュー)と false(取り込み)を同じ API で処理「プレビューでは通ったのに取り込みで違う判定になる」ずれを防ぐ
    重複の判定は登録済みの店舗と CSV の中の両方同じ CSV を2回取り込んでも、店舗が二重にならない
    登録はトランザクションで一括途中で失敗して半端に登録された状態を残さない

    トランザクションは、「複数の書き込みを、全部成功するか全部取り消すかのどちらかにする」データベースの仕組みです。

    実装

    ファイル役割
    shared/types/import.ts取り込み結果の型(新規)
    server/utils/csv.tsCSV の解析と、見出し・業態名の読み替え(新規)
    server/api/points/import.post.tsプレビューと取り込みの API(新規)
    app/pages/admin/import.vue取り込み画面(新規)
    app/layouts/default.vueヘッダーに「CSV取り込み」のリンク(更新)
    samples/points-sample.csv動作確認用のサンプル(新規。上に掲載)
    app/assets/css/main.cssナビと取り込み画面のスタイル(更新)

    CSV の解析には papaparse(5系)を使います。型定義も一緒に入れます。

    npm install papaparse@5 --ignore-scripts
    npm install -D @types/papaparse@5 --ignore-scripts

    手順1:CSVを解析する

    // server/utils/csv.ts
    import Papa from 'papaparse'
    import { CATEGORIES, CATEGORY_META, type Category } from '#shared/types/point'
    
    // CSV の見出し → 項目名。日本語の見出しでも英語の見出しでも受け付ける
    const HEADER_ALIASES: Record<string, string> = {
      店舗名: 'name', 名称: 'name', name: 'name',
      業態: 'category', カテゴリ: 'category', category: 'category',
      住所: 'address', address: 'address',
      緯度: 'lat', lat: 'lat',
      経度: 'lng', lng: 'lng',
      place_id: 'placeId', placeId: 'placeId',
      メモ: 'memo', memo: 'memo',
    }
    
    export interface CsvRow {
      line: number
      name: string
      category: string
      address: string
      lat: string
      lng: string
      placeId: string
      memo: string
    }
    
    /**
     * CSV の文字列を行の配列にする(papaparse)。
     * 見出し行が必須。空行は無視する。値の前後の空白は取り除く。
     */
    export function parsePointsCsv(text: string): { rows: CsvRow[]; errors: string[] } {
      const result = Papa.parse<Record<string, string>>(text.replace(/^\uFEFF/, ''), {
        header: true,
        skipEmptyLines: 'greedy', // 空白だけの行も飛ばす
        transformHeader: (h) => HEADER_ALIASES[h.trim()] ?? h.trim(),
        transform: (v) => v.trim(),
      })
    
      const fields = result.meta.fields ?? []
      const errors: string[] = []
      if (!fields.includes('name') || !fields.includes('category')) {
        errors.push('見出し行に「店舗名」と「業態」の列が必要です')
      }
      if (!fields.includes('lat') || !fields.includes('lng')) {
        errors.push('見出し行に「緯度」「経度」の列が必要です')
      }
      for (const e of result.errors) {
        errors.push(`${e.row !== undefined ? `${e.row + 2}行目: ` : ''}${e.message}`)
      }
    
      const rows = result.data.map((r, i) => ({
        line: i + 2, // 1行目は見出し
        name: r.name ?? '',
        category: r.category ?? '',
        address: r.address ?? '',
        lat: r.lat ?? '',
        lng: r.lng ?? '',
        placeId: r.placeId ?? '',
        memo: r.memo ?? '',
      }))
      return { rows, errors }
    }
    
    // 「直営店」「direct」のどちらでも業態として受け付ける
    export function toCategory(value: string): Category | null {
      if ((CATEGORIES as readonly string[]).includes(value)) return value as Category
      return CATEGORIES.find((c) => CATEGORY_META[c].label === value) ?? null
    }

    header: true で1行目を見出しとして扱い、各行を「見出し名 → 値」の形で受け取ります。transformHeader で「店舗名」「緯度」のような日本語の見出しを内部の項目名に読み替えているので、現場の台帳の見出しをほぼそのまま使えます。見出しに「緯度」「経度」の列が無い CSV は、この時点で400エラーにします。

    先頭の  は、Excel が UTF-8 の CSV の先頭に付けることがある目印(BOM)です。これが残ると1列目の見出しが「店舗名」と一致しなくなるため取り除いています。

    📰 出典:Papa Parse「Documentation」

    手順2:行ごとに検証し、重複を判定してまとめて登録する

    取り込み結果の型は、画面とサーバーの両方で使うので shared/ に置きます。

    // shared/types/import.ts
    // 第11回: CSV 一括取り込み(POST /api/points/import)の結果
    export type ImportRowStatus =
      | 'ready' // 緯度経度あり。そのまま登録できる
      | 'imported' // 登録した
      | 'duplicate' // 同じ名称・業態が登録済み(またはCSV内で重複)なのでスキップ
      | 'error' // 入力の誤り(緯度経度が無い行を含む)
    
    export interface ImportRowResult {
      line: number // CSV の行番号(見出し行を1行目とする)
      name: string
      status: ImportRowStatus
      message: string | null
    }
    
    export interface ImportResult {
      dryRun: boolean
      total: number
      counts: Record<ImportRowStatus, number>
      rows: ImportRowResult[]
    }

    API の本体です。プレビューでも取り込みでも、同じ順番で各行を判定します。

    server/api/points/import.post.ts の全文(108行)
    // server/api/points/import.post.ts
    import { z } from 'zod'
    import type { ImportResult, ImportRowResult, ImportRowStatus } from '#shared/types/import'
    import { CATEGORIES, CATEGORY_META } from '#shared/types/point'
    import type { PointInput } from '../../utils/pointSchema'
    
    const MAX_ROWS = 2000 // 1回に取り込める行数
    
    const FIELD_LABELS: Record<string, string> = {
      name: '店舗名', lat: '緯度', lng: '経度', address: '住所', placeId: 'place_id', memo: 'メモ',
    }
    const CATEGORY_LABELS = CATEGORIES.map((c) => CATEGORY_META[c].label).join('・')
    
    const bodySchema = z.object({
      csv: z.string().min(1).max(1_000_000), // 約1MB まで
      dryRun: z.boolean().default(true), // 既定はプレビューだけ(登録しない)
    })
    
    // POST /api/points/import … CSV の店舗台帳を一括登録する(第11回)
    //   dryRun: true  → 各行を検証して「登録できる/重複/エラー」を返すだけ
    //   dryRun: false → 登録できる行をまとめて登録する
    // 緯度・経度が無い行は登録しない。住所を Google で変換して保存すると、
    // 規約上30日で消すか取り直す必要がある座標が台帳に混ざるため(本文参照)
    export default defineEventHandler(async (event): Promise<ImportResult> => {
      const { csv, dryRun } = await readValidatedBody(event, (b) => bodySchema.parse(b))
      const { rows, errors } = parsePointsCsv(csv)
      if (errors.length > 0) {
        throw createError({ statusCode: 400, statusMessage: 'Invalid CSV', message: errors.slice(0, 5).join(' / ') })
      }
      if (rows.length > MAX_ROWS) {
        throw createError({ statusCode: 400, statusMessage: 'Too many rows', message: `1回に取り込めるのは${MAX_ROWS}行までです` })
      }
    
      const db = useDatabase()
    
      // 重複の判定:店舗名+業態が同じ店舗は登録済みとみなす(判定ルールは要件次第。本文参照)
      const { rows: existing } = await db.sql`SELECT name, category FROM points`
      const seen = new Set((existing ?? []).map((r) => `${r.name}\t${r.category}`))
    
      const results: ImportRowResult[] = []
      const toInsert: { result: ImportRowResult; input: PointInput }[] = []
    
      for (const row of rows) {
        const result: ImportRowResult = { line: row.line, name: row.name, status: 'error', message: null }
        results.push(result)
    
        // 1) 入力の検証
        const category = toCategory(row.category)
        if (!category) {
          result.message = `業態「${row.category}」は使えません(${CATEGORY_LABELS})`
          continue
        }
        if (row.lat === '' || row.lng === '') {
          result.message = '緯度・経度がありません。管理画面で地図をクリックして位置を決めてください'
          continue
        }
        const parsed = pointInputSchema.safeParse({
          name: row.name,
          category,
          lat: Number(row.lat),
          lng: Number(row.lng),
          address: row.address,
          memo: row.memo,
          placeId: row.placeId === '' ? null : row.placeId,
        })
        if (!parsed.success) {
          const labels = parsed.error.issues.map((i) => FIELD_LABELS[String(i.path[0])] ?? String(i.path[0]))
          result.message = `${[...new Set(labels)].join('・')}の値が正しくありません`
          continue
        }
    
        // 2) 重複(登録済み、または CSV の中で2回目以降)はスキップ
        const key = `${parsed.data.name}\t${parsed.data.category}`
        if (seen.has(key)) {
          result.status = 'duplicate'
          result.message = '同じ店舗名・業態の店舗が登録済み、またはCSV内で重複しています'
          continue
        }
        seen.add(key)
    
        result.status = 'ready'
        toInsert.push({ result, input: parsed.data })
      }
    
      // 3) まとめて登録する。途中で失敗したら全部取り消す(トランザクション)
      if (!dryRun && toInsert.length > 0) {
        const now = new Date().toISOString()
        await db.exec('BEGIN')
        try {
          for (const { input } of toInsert) {
            const p = pointInputSchema.parse(input)
            await db.sql`INSERT INTO points
                (name, category, lat, lng, address, memo, place_id, updated_at)
              VALUES (${p.name}, ${p.category}, ${p.lat}, ${p.lng}, ${p.address}, ${p.memo},
                ${p.placeId}, ${now})`
          }
          await db.exec('COMMIT')
        } catch (e) {
          await db.exec('ROLLBACK')
          throw e
        }
        for (const { result } of toInsert) result.status = 'imported'
      }
    
      const counts: Record<ImportRowStatus, number> = { ready: 0, imported: 0, duplicate: 0, error: 0 }
      for (const r of results) counts[r.status]++
      return { dryRun, total: results.length, counts, rows: results }
    })

    処理は3段階です。

    • 1) 入力の検証:業態を読み替え、緯度・経度の両方があるかを確かめてから、第3回の pointInputSchema(zod)で値の範囲を検証します。誤りがあれば「緯度の値が正しくありません」のように直す列を返します
    • 2) 重複の判定:「店舗名+業態が同じなら同じ店舗」とみなし、登録済みの店舗と、CSV の中で2回目以降の行をスキップします
    • 3) まとめて登録:dryRun: false のときだけ、BEGIN から COMMIT までをひとまとめにして登録し、途中で失敗したら ROLLBACK で全部取り消します

    緯度・経度が無い行には「管理画面で地図をクリックして位置を決めてください」と、次にやることを返します。重複のルールは簡易的なもので、店舗コードで判定する、上書き更新にするなど、要件によって正解が変わります。今回は「追加だけ」です。

    手順3:取り込み画面を作る

    管理画面の下に app/pages/admin/import.vue を作ります。URL は /admin/import です。

    app/pages/admin/import.vue の全文(125行)
    <!-- app/pages/admin/import.vue -->
    <script setup lang="ts">
    // 第11回: CSV の店舗台帳を一括取り込みする画面(選ぶ → プレビュー → 取り込む → 結果)
    // 緯度・経度が無い行は取り込まない(Google の住所変換で埋めない。理由は本文)
    import type { ImportResult, ImportRowStatus } from '#shared/types/import'
    
    useHead({ title: 'CSV取り込み|店舗検索マップ(サンプル)' })
    
    const csvText = ref<string | null>(null)
    const fileName = ref('')
    const preview = ref<ImportResult | null>(null)
    const result = ref<ImportResult | null>(null)
    const busy = ref(false)
    const errorMessage = ref<string | null>(null)
    
    const STATUS_LABEL: Record<ImportRowStatus, string> = {
      ready: '登録できます',
      imported: '登録しました',
      duplicate: '重複のためスキップ',
      error: 'エラー',
    }
    
    // Excel で保存した CSV は Shift_JIS のことが多い。まず UTF-8 として読み、失敗したら Shift_JIS で読む
    async function decodeCsv(file: File): Promise<string> {
      const buf = await file.arrayBuffer()
      try {
        return new TextDecoder('utf-8', { fatal: true }).decode(buf)
      } catch {
        return new TextDecoder('shift_jis').decode(buf)
      }
    }
    
    async function onFileChange(e: Event) {
      const file = (e.target as HTMLInputElement).files?.[0]
      preview.value = result.value = null
      errorMessage.value = null
      if (!file) return
      if (file.size > 1_000_000) {
        errorMessage.value = 'ファイルが大きすぎます(1MB まで)。分けて取り込んでください。'
        return
      }
      fileName.value = file.name
      csvText.value = await decodeCsv(file)
      preview.value = await send(true)
    }
    
    async function onImport() {
      result.value = await send(false)
      preview.value = null
    }
    
    async function send(dryRun: boolean): Promise<ImportResult | null> {
      if (!csvText.value) return null
      busy.value = true
      errorMessage.value = null
      try {
        return await $fetch<ImportResult>('/api/points/import', {
          method: 'POST',
          body: { csv: csvText.value, dryRun },
          timeout: 60_000,
        })
      } catch (e) {
        const data = (e as { data?: { message?: string } }).data
        errorMessage.value = data?.message ?? '取り込みに失敗しました。時間をおいて再度お試しください。'
        return null
      } finally {
        busy.value = false
      }
    }
    
    const shown = computed(() => result.value ?? preview.value)
    const importable = computed(() =>
      preview.value ? preview.value.counts.ready : 0,
    )
    </script>
    
    <template>
      <div class="import-page">
        <h1>CSVで店舗を一括取り込み</h1>
        <p class="import-page__help">
          1行目に見出し(店舗名・業態・住所・緯度・経度・place_id・メモ)が必要です。緯度・経度は必須で、
          自社の台帳にある値を使います。緯度・経度が無い店舗は、取り込んだあとではなく、管理画面で地図をクリックして登録してください。
        </p>
    
        <label class="import-page__file">
          CSVファイルを選ぶ
          <input type="file" accept=".csv,text/csv" :disabled="busy" @change="onFileChange">
        </label>
    
        <p v-if="busy" role="status">処理中です…</p>
        <p v-if="errorMessage" class="import-page__error" role="alert">{{ errorMessage }}</p>
    
        <section v-if="shown" aria-live="polite">
          <h2>{{ shown.dryRun ? `プレビュー:${fileName}` : '取り込み結果' }}</h2>
          <ul class="import-page__counts">
            <li v-for="(label, status) in STATUS_LABEL" v-show="shown.counts[status] > 0" :key="status">
              {{ label }}: {{ shown.counts[status] }} 件
            </li>
          </ul>
    
          <div v-if="preview" class="import-page__actions">
            <button type="button" :disabled="busy || importable === 0" @click="onImport">
              {{ importable }} 件を取り込む
            </button>
          </div>
          <p v-if="result" class="import-page__actions">
            <NuxtLink to="/admin">管理画面の地図に戻る</NuxtLink>
          </p>
    
          <table class="import-page__table">
            <thead>
              <tr><th>行</th><th>名称</th><th>判定</th><th>内容</th></tr>
            </thead>
            <tbody>
              <tr v-for="r in shown.rows" :key="r.line" :class="`is-${r.status}`">
                <td>{{ r.line }}</td>
                <td>{{ r.name }}</td>
                <td>{{ STATUS_LABEL[r.status] }}</td>
                <td>{{ r.message ?? '' }}</td>
              </tr>
            </tbody>
          </table>
        </section>
      </div>
    </template>

    日本の業務でよくつまずくのが文字コードです。Excel で「CSV」として保存すると Shift_JIS になることが多く、UTF-8 のつもりで読むと文字化けします。decodeCsv() では、TextDecoder の fatal: true(UTF-8 として正しくないバイト列ならエラーにする指定)でまず UTF-8 として読み、エラーになったら Shift_JIS で読み直します。

    📰 出典:MDN「TextDecoder」

    ファイルを選ぶとすぐプレビューを送り、判定ごとの件数と行ごとの表を出します。エラーの行は背景を赤くしました。CSV の中身は Vue の {{ }}(自動で HTML のエスケープをする書き方)で文字列として表示しています。

    手順4:ヘッダーにリンクを足し、スタイルを整える

    第5回で作ったヘッダーのナビに、取り込み画面へのリンクを足します。

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

    --- a/app/layouts/default.vue
    +++ b/app/layouts/default.vue
    @@ -3,10 +3,11 @@
         <header class="layout__header">
           <NuxtLink to="/" class="layout__brand">店舗検索マップ</NuxtLink>
           <span class="layout__sub">Nuxt + Google Maps Platform サンプル</span>
    -      <!-- 第5回: 管理画面へのリンク -->
    +      <!-- 第5回: 管理画面へのリンク。第11回: CSV取り込み。 -->
           <nav class="layout__nav">
             <NuxtLink to="/">店舗を探す</NuxtLink>
             <NuxtLink to="/admin">店舗の管理</NuxtLink>
    +        <NuxtLink to="/admin/import">CSV取り込み</NuxtLink>
           </nav>
         </header>
         <main class="layout__main">

    ナビと取り込み画面のスタイルを足します。第10回で足した .area-tools__error の後ろに入れます。

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

    app/assets/css/main.css の変更(差分)
    --- a/app/assets/css/main.css
    +++ b/app/assets/css/main.css
    @@ -666,6 +666,90 @@
       color: #cf222e;
       font-size: 13px;
     }
    +
    +/* 第11回: CSV取り込み */
    +.layout__nav {
    +  display: flex;
    +  gap: 12px;
    +  margin-left: auto;
    +  font-size: 14px;
    +}
    +
    +.layout__nav a.router-link-exact-active {
    +  font-weight: 700;
    +  color: inherit;
    +  text-decoration: none;
    +}
    +
    +.import-page {
    +  max-width: 960px;
    +  overflow-y: auto;
    +  height: 100%;
    +}
    +
    +.import-page h1 {
    +  margin: 0 0 8px;
    +  font-size: 20px;
    +}
    +
    +.import-page__help {
    +  color: #57606a;
    +  font-size: 14px;
    +}
    +
    +.import-page__file {
    +  display: inline-grid;
    +  gap: 4px;
    +}
    +
    +.import-page__error {
    +  color: #cf222e;
    +}
    +
    +.import-page__counts {
    +  display: flex;
    +  flex-wrap: wrap;
    +  gap: 4px 16px;
    +  padding: 0;
    +  list-style: none;
    +}
    +
    +.import-page__actions button {
    +  padding: 6px 14px;
    +  border: 1px solid #1a7f37;
    +  border-radius: 6px;
    +  background: #1a7f37;
    +  color: #fff;
    +  cursor: pointer;
    +}
    +
    +.import-page__actions button:disabled {
    +  opacity: 0.6;
    +  cursor: default;
    +}
    +
    +.import-page__table {
    +  width: 100%;
    +  margin-top: 12px;
    +  border-collapse: collapse;
    +  background: #fff;
    +  font-size: 14px;
    +}
    +
    +.import-page__table th,
    +.import-page__table td {
    +  padding: 6px 8px;
    +  border: 1px solid #d0d7de;
    +  text-align: left;
    +}
    +
    +.import-page__table tr.is-error td {
    +  background: #ffebe9;
    +}
    +
    +.import-page__table tr.is-duplicate td {
    +  color: #57606a;
    +}
    
     /* 第5回: 管理画面(一覧なしの 地図 + フォーム) */
     .map-page__note {

    動作確認の方法

    1. npm run dev で起動し、ヘッダーの「CSV取り込み」から /admin/import を開く
    2. samples/points-sample.csv を選ぶ → プレビューで「登録できます: 5 件」「エラー: 2 件」になり、7行目(緯度・経度なし)と8行目(業態「倉庫」)に理由が出ることを確認
    3. 「5 件を取り込む」を押す → 「登録しました: 5 件」になることを確認。「管理画面の地図に戻る」で地図に5店舗のピンが増えていることを確認
    4. 同じ CSV をもう一度選ぶ → 5行が「重複のためスキップ」になることを確認
    5. Excel で開いて CSV(Shift_JIS)として保存し直したファイルでも、文字化けせずにプレビューが出ることを確認

    筆者の環境では、npm run build と npm run typecheck が通ることを確かめ、ビルド後のサーバーにサンプルの CSV を curl で送って次の結果を確認しました。第12回で切り替える PostgreSQL でも同じ結果でした。

    条件結果
    プレビュー登録できる5件・エラー2件
    取り込み5件を登録(Google の API は呼ばない)
    同じ CSV を再びプレビュー重複5件・エラー2件

    Shift_JIS の判定は、Node.js 24 の TextDecoder で、Shift_JIS に変換したサンプルを読んで確かめました。取り込み画面の表示はブラウザで確認しましたが、ブラウザからファイルを選ぶ操作と、取り込んだ店舗が地図に表示される様子は、執筆環境に本物の API キーが無いため確認できていません。ご自身のキーを設定して確認してください。

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

    • 緯度と経度を取り違える:日本の店舗なら緯度は20〜46度、経度は122〜154度くらいです。逆に入っていると範囲の検証は通っても海の上にピンが立つので、取り込み後に地図で数件を目で確かめます
    • 座標の基準(測地系)が違う:古い台帳には、今とは基準が違う「日本測地系」の座標が残っていることがあり、数百メートルずれます
    • 大量の行を1回で送る:今回は1回2,000行・約1MBまでの同期処理です。数万行なら、裏側で順番に処理する仕組み(ジョブキュー)が必要です
    • トランザクションの簡略化:1つのデータベース接続を共有する簡易的な書き方です。同時に何人も取り込むなら作りを見直します
    • 管理画面がまだ誰でも開ける:取り込み画面は管理画面の下にありますが、パスワードの保護は次回(第12回)で入れます。それまでは社内の検証環境だけで使ってください

    発注者向けメモ

    CSV 取り込みの見積もりで大切なのは、画面の開発よりも「座標が無い店舗をどうするか」と、その作業量です。

    座標が無い店舗の扱い方

    方法内容注意点
    管理画面で地図をクリックして決める(第5回)担当者が店舗の位置を見ながら1件ずつ置く確実だが、件数に比例して人の作業が増える
    公的なデータで自社で変換する国土交通省の「位置参照情報」や、デジタル庁の「アドレス・ベース・レジストリ」と、その住所をもとに座標を付けるツール「ABRジオコーダー」を使い、自社で座標を付けて自社のデータにする代表点(街区や町丁目の代表の位置)なので、店舗の入口とはずれることがある。利用条件の確認が必要
    既存のシステムの座標を使うPOS・物件管理・測量データなどに座標があれば、それを列に入れる座標の基準(測地系)と精度を確認する

    📰 出典:国土交通省「位置参照情報 ダウンロードサービス」

    📰 出典:デジタル庁「アドレス・ベース・レジストリ」

    公的なデータにはそれぞれ利用約款・利用規約があり、出典の表示などの条件が付くことがあります。使う前に、最新の利用条件を確認してください。また、Google の住所変換の結果を下敷きにして人が少し動かした座標を「自社のデータ」とみなせるかは読み方が分かれうるため、本連載では採っていません。

    見積もりで確認したいこと

    • 座標が無い店舗の件数と、座標づくりを誰が・どの方法で・どの精度で行うか(発注側か開発会社か)。件数によっては、確認を含めてまとまった日数の作業になります
    • 取り込みでは Google の API を呼ばないので、費用の構造は「画面と API の開発工数」+「座標づくりと確認の人の作業」です
    • 重複の条件と、閉店・移転の扱い(追加だけか、更新や削除も必要か)は業務の要件です。更新や削除まで CSV で行うと、工数とテストが増えます

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

    • ☐ 取り込む店舗の件数と、緯度・経度が無い店舗の件数を数えた
    • ☐ 座標が無い店舗を、管理画面で置くか公的なデータで変換するかを決め、作業の担当を決めた
    • ☐ 公的なデータを使う場合、その利用条件を確認した
    • ☐ 重複とみなす条件と、閉店・移転の反映方法を決めた
    • ☐ 台帳の文字コードと列の並びを開発会社に共有した

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

    • 「住所だけの店舗の座標は、どの方法で決めますか?Google の住所変換で埋める場合、30日の保存期間にはどう対応しますか?」
    • 「取り込みの途中でエラーになったとき、どこまで登録されて、どこから直せばよいか分かりますか?」
    • 「同じ店舗を2回取り込んだときや、移転した店舗を取り込んだときはどうなりますか?」

    まとめと次回予告

    この回では、CSV の店舗台帳をプレビューしてから一括登録する画面を作りました。緯度・経度を必須にして Google から取った座標を台帳に混ぜないこと、プレビューと取り込みを同じ API で判定すること、重複の判定とトランザクションで二重登録や半端な登録を防ぐこと、の3点が押さえどころです。

    次回は最終回「本番公開前チェック:APIキー制限・クォータ・予算アラート・管理画面の保護」です。公開ページとして出す前に、キーの制限、上限と予算アラート、管理画面のパスワード、有料 API の回数制限、本番データベースへの切り替えを点検し、連載を締めくくります。

    この連載の記事一覧

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

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

      お問い合わせ


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

      この記事を書いた人

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

      コメント

      コメント一覧 (2件)

      目次