Google Maps API とNuxtで自社サイトの店舗検索マップを作る連載の第9回です。前回(第8回)では、業態で店舗を絞り込み、左の一覧と地図のピンを連動させました。今回は、全国の店舗が数千件に増えても地図が重くならないように、近くのピンを「◯件」の丸にまとめるクラスタリングと、地図に見えている範囲の店舗だけをサーバーから読み込む仕組みを入れます。
「今は首都圏の20店舗でも、取扱店まで載せると全国で数千件になる。スマートフォンで開いたお客様の画面が固まったりしない?」
結論から言うと、Google Maps の地図はピンの数が増えるほどブラウザの負担が大きくなるので、「見えている範囲だけ取る」「近くのピンはまとめて描く」の2つを組み合わせるのが定番の対策です。どちらも画面と自社サーバーの中の処理で、Google の追加のAPI費用は発生しません。大事なのは、今と数年後の店舗数の見込みを最初に決めておくことです。件数の桁が変わると、選ぶべき作り方も見積もりも変わります。
この回で作るもの:店舗のクラスタリングと表示範囲読み込み
来訪者の画面(/)と管理画面(/admin)の両方が、次のように動くようになります。
| 操作 | 画面の動き |
|---|---|
| 地図を縮小する | 近くのピンが「128」のような件数入りの丸(クラスタ)にまとまる。件数が多いほど丸が大きく、色が変わる |
| クラスタをクリックする | その範囲が収まるまで地図が拡大され、個々のピンに分かれていく |
| 地図を動かす・拡大縮小する | 操作が止まった時点で、見えている範囲の店舗だけをサーバーから取り直す |
| ピンや一覧の行を選ぶ | 選んだピンはクラスタにまとめず、どのズームでも単独で表示される |
仕組み:取る量を減らし、描く量を減らす
店舗が多いときに重くなる原因は、大きく2つあります。
| 原因 | 対策 | 今回の実装 |
|---|---|---|
| サーバーから全店舗を毎回受け取る(通信量・処理量が件数に比例) | 地図の表示範囲(bbox=表示範囲を囲む四角形の東西南北)の店舗だけ取る | GET /api/points?bbox=西,南,東,北 と、緯度・経度の索引 |
| ピン1本1本を画面の部品として描く(部品が数千個になる) | 近くのピンを1つの丸にまとめて描く(クラスタリング) | @googlemaps/markerclusterer |
さらに、地図を少し動かしただけで全部のピンを作り直していた第8回までの描き方を、増えた分・消えた分だけ更新する差分更新に変えます。
店舗検索は、来訪者が自分のスマートフォンで開く公開ページです。端末の性能も回線も選べないので、表示の速さがそのまま使われやすさに効きます。
実装
| ファイル | 役割 |
|---|---|
server/utils/bbox.ts(新規)・server/api/points/index.get.ts | bbox で範囲内の店舗だけ返す |
server/plugins/db-init.ts | 緯度・経度の索引 |
scripts/seed-points.ts(新規)・package.json | 5,000件のダミー店舗を入れる |
app/composables/useClusterer.ts(新規)・useMarkers.ts | クラスタリングと差分更新 |
app/components/MapView.vue・app/utils/bbox.ts(新規)・両ページ | 表示範囲が変わったら取り直す |
CategoryFilter.vue・PointList.vue・main.css | 件数の表記・一覧の200件打ち切り・見た目 |
ライブラリは Google が公開している @googlemaps/markerclusterer(2系)を追加します。
npm install @googlemaps/markerclusterer@2 --ignore-scripts
📰 出典:Google Maps Platform「Marker clustering」
手順1:表示範囲で絞り込むAPI
// server/utils/bbox.ts
import { z } from 'zod'
const lat = z.number().min(-90).max(90)
const lng = z.number().min(-180).max(180)
/**
* 第9回: 表示範囲(bbox)のクエリ文字列「西,南,東,北」(経度,緯度,経度,緯度)を検証して数値にする。
* 並びは GeoJSON などと同じ「最小経度,最小緯度,最大経度,最大緯度」。
*/
export const bboxSchema = z
.string()
.transform((s) => s.split(',').map((v) => Number(v)))
.pipe(z.tuple([lng, lat, lng, lat]))
.refine(([, south, , north]) => south <= north, '南端は北端以下にしてください')
.transform(([west, south, east, north]) => ({ west, south, east, north }))
export type Bbox = z.output<typeof bboxSchema>
bbox は「西,南,東,北」(最小経度,最小緯度,最大経度,最大緯度)の順にしました。GeoJSON など地理データの世界でよく使われる並びです。数値でない値や範囲外の値は zod の検証で 400 エラーになります。
server/api/points/index.get.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/api/points/index.get.ts
+++ b/server/api/points/index.get.ts
@@ -1,9 +1,33 @@
// server/api/points/index.get.ts
+import { z } from 'zod'
import type { PointRow } from '../../utils/points'
-// GET /api/points … 店舗を返す(第9回で表示範囲による絞り込みを追加)
-export default defineEventHandler(async () => {
+// 1回に返す最大件数。地図を大きく縮小しても、応答とブラウザの負荷がこれ以上増えないようにする
+const MAX_POINTS = 10000
+
+const querySchema = z.object({
+ bbox: bboxSchema.optional(),
+})
+
+// GET /api/points … 店舗を返す
+// 第9回: ?bbox=西,南,東,北 を付けると、その範囲内の店舗だけを返す(地図の表示範囲の読み込み)
+export default defineEventHandler(async (event) => {
+ const { bbox } = await getValidatedQuery(event, (q) => querySchema.parse(q))
const db = useDatabase()
- const { rows } = await db.sql`SELECT * FROM points ORDER BY id`
+
+ if (!bbox) {
+ const { rows } = await db.sql`SELECT * FROM points ORDER BY id LIMIT ${MAX_POINTS}`
+ return (rows as unknown as PointRow[]).map(toPoint)
+ }
+
+ const { west, south, east, north } = bbox
+ // 通常は 西 <= 東。日付変更線(経度180度)をまたぐ範囲だけ 西 > 東 になるので条件を分ける
+ const { rows } = west <= east
+ ? await db.sql`SELECT * FROM points
+ WHERE lat BETWEEN ${south} AND ${north} AND lng BETWEEN ${west} AND ${east}
+ ORDER BY id LIMIT ${MAX_POINTS}`
+ : await db.sql`SELECT * FROM points
+ WHERE lat BETWEEN ${south} AND ${north} AND (lng >= ${west} OR lng <= ${east})
+ ORDER BY id LIMIT ${MAX_POINTS}`
return (rows as unknown as PointRow[]).map(toPoint)
})
bbox なしの呼び出しにも、1回10,000件の上限を設けました。
server/plugins/db-init.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/plugins/db-init.ts
+++ b/server/plugins/db-init.ts
@@ -16,6 +16,8 @@
place_id TEXT,
updated_at TEXT NOT NULL
)`
+ // 第9回: 表示範囲(緯度・経度の範囲)での検索を速くする索引
+ await db.sql`CREATE INDEX IF NOT EXISTS points_lat_lng ON points (lat, lng)`
const { rows } = await db.sql`SELECT COUNT(*) AS count FROM points`
if (Number(rows?.[0]?.count ?? 0) > 0) return
索引(=目的の行を早く探すための仕組み)を作ると、SQLite は緯度の範囲で候補を絞ってから経度を確かめます。EXPLAIN QUERY PLAN(SQL の実行方法を表示する命令)では SEARCH points USING INDEX points_lat_lng と表示され、索引が使われていました。第6回の「起点から近い店舗」の検索も同じ索引で速くなります。
手順2:5,000件のダミー店舗を入れるスクリプト
// scripts/seed-points.ts
// 第9回: 動作確認用に大量の店舗(既定 5,000 件)を .data/gmap.sqlite に投入する開発用スクリプト。
// node scripts/seed-points.ts … 5,000 件を追加
// node scripts/seed-points.ts 20000 … 件数を指定して追加
// node scripts/seed-points.ts --remove … このスクリプトで入れた店舗だけを削除
// 先に一度 npm run dev(またはビルド後のサーバー)を起動して、テーブルを作っておくこと。
// Node.js 24 は .ts をそのまま実行できる(型注釈を取り除いて実行する機能)。
import { DatabaseSync } from 'node:sqlite'
const SEED_MEMO = '[seed] 動作確認用のダミー店舗'
const CATEGORIES = ['direct', 'partner', 'showroom', 'service']
const db = new DatabaseSync('.data/gmap.sqlite')
const table = db.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'points'").get()
if (!table) {
console.error('points テーブルがありません。先に一度サーバーを起動してください。')
process.exit(1)
}
if (process.argv.includes('--remove')) {
const { changes } = db.prepare('DELETE FROM points WHERE memo = ?').run(SEED_MEMO)
console.log(`シード店舗を ${changes} 件削除しました`)
process.exit(0)
}
const count = Number(process.argv[2] ?? 5000)
if (!Number.isInteger(count) || count < 1 || count > 100000) {
console.error('件数は 1〜100000 の整数で指定してください')
process.exit(1)
}
// 毎回同じ配置になるよう、固定の種から乱数を作る(mulberry32)
let seed = 20260909
function random(): number {
seed = (seed + 0x6d2b79f5) | 0
let t = Math.imul(seed ^ (seed >>> 15), 1 | seed)
t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t
return ((t ^ (t >>> 14)) >>> 0) / 4294967296
}
// 東京23区がおおむね収まる範囲に散らす
const AREA = { south: 35.55, north: 35.82, west: 139.56, east: 139.92 }
const now = new Date().toISOString()
const insert = db.prepare(
'INSERT INTO points (name, category, lat, lng, memo, updated_at) VALUES (?, ?, ?, ?, ?, ?)',
)
// まとめて1つのトランザクションにすると、1件ずつ確定するより桁違いに速い
db.exec('BEGIN')
for (let i = 1; i <= count; i++) {
const lat = AREA.south + (AREA.north - AREA.south) * random()
const lng = AREA.west + (AREA.east - AREA.west) * random()
const category = CATEGORIES[Math.floor(random() * CATEGORIES.length)]
insert.run(`シード店舗 ${String(i).padStart(5, '0')}`, category, +lat.toFixed(6), +lng.toFixed(6), SEED_MEMO, now)
}
db.exec('COMMIT')
console.log(`シード店舗を ${count} 件追加しました`)
npm run seed で動かせるよう、package.json にコマンドを登録します。
npm pkg set scripts.seed="node scripts/seed-points.ts"
npm run seed -- 20000 で件数を指定、node scripts/seed-points.ts --remove でこのスクリプトが入れた店舗(お知らせ欄に目印あり)だけを消せます。Node.js 24 は TypeScript をそのまま実行できるので、ビルドは不要です。
📰 出典:Node.js「SQLite」
手順3:クラスタリングの準備
// app/composables/useClusterer.ts
// 型だけを静的に読み込む。本体はブラウザで必要になったときに動的 import する(下の ensure 参照)
import type { MarkerClusterer, Renderer } from '@googlemaps/markerclusterer'
/**
* 第9回: 近くのマーカーを「◯件」の丸にまとめて表示する(@googlemaps/markerclusterer)。
* - まとめる計算はブラウザ内で行う。Google への追加リクエストは発生しない
* - まとめた丸(クラスタ)も AdvancedMarkerElement で描く(旧 Marker は使わない)
* - クラスタをクリックすると、その範囲が収まるまで地図を拡大する(ライブラリの既定動作)
*/
export function useClusterer() {
const { load } = useGoogleMaps()
let clusterer: MarkerClusterer | null = null
async function ensure(map: google.maps.Map): Promise<MarkerClusterer> {
if (clusterer) return clusterer
// このパッケージは package.json の main が CommonJS 形式のため、サーバー描画(Node.js)で
// 静的に import すると名前付き export が見つからずエラーになる。ブラウザでだけ読み込む
const [{ AdvancedMarkerElement }, { MarkerClusterer, SuperClusterAlgorithm }] = await Promise.all([
load('marker'),
import('@googlemaps/markerclusterer'),
])
if (clusterer) return clusterer // await の間に別の呼び出しが作っていた場合
const renderer: Renderer = {
render({ count, position }) {
const badge = document.createElement('div')
badge.className = 'cluster-badge'
badge.dataset.size = count >= 1000 ? 'l' : count >= 100 ? 'm' : 's'
badge.textContent = count.toLocaleString('ja-JP')
const marker = new AdvancedMarkerElement({
position,
title: `${count}件の店舗(クリックで拡大)`,
zIndex: Math.min(count, 900), // 件数が多いほど手前。選択中のピン(999)よりは奥
gmpClickable: true,
})
marker.append(badge)
return marker
},
}
clusterer = new MarkerClusterer({
map,
renderer,
// ズーム16より拡大したらまとめない(既定値と同じ。個々のピンを必ず押せるようにする)
algorithm: new SuperClusterAlgorithm({ maxZoom: 16, radius: 60 }),
})
return clusterer
}
function get() {
return clusterer
}
onScopeDispose(() => {
clusterer?.clearMarkers(true)
clusterer?.setMap(null) // 地図から外すと、クラスタの丸も片付けられる
clusterer = null
})
return { ensure, get }
}
ポイントは3つです。
- 件数入りの丸は自前で描く:ライブラリ既定の描き方は内部で非推奨のプロパティを使うため、
Renderer(丸の描き方を決める部品)を自作し、第2回と同じくAdvancedMarkerElementにappendしました - ライブラリはブラウザでだけ読み込む:筆者の環境では、通常の
importで書くとビルドは通るのに、ページを開くとサーバー側で「名前付き export が見つからない」エラー(500)になりました。Node.js からは CommonJS 形式(古い書き方のモジュール)として読まれるためです。型だけimport typeで読み、本体は動的import()しています - クラスタのクリックは、ライブラリ既定の動作(その範囲まで拡大)のままです
📰 出典:npm「@googlemaps/markerclusterer」
手順4:マーカーを差分だけ更新する
app/composables/useMarkers.ts に次の変更を加えます(+ が追加、- が削除)。
app/composables/useMarkers.ts の変更(差分)
--- a/app/composables/useMarkers.ts
+++ b/app/composables/useMarkers.ts
@@ -5,10 +5,12 @@
* - マーカーは Vue のリアクティブにせず、プレーンな Map(id → マーカー)で管理する
* - クリック(またはキーボードの Enter)で店舗を選択し、InfoWindow に概要を出す(第4回)
* - 選択中のピンを大きくして強調する(第8回)
+ * - 第9回: 全部作り直さず差分だけ更新し、地図への表示はクラスタリング(useClusterer)に任せる
*/
export function useMarkers() {
const { load } = useGoogleMaps()
const { selectedId, select, clearSelection } = useSelection()
+ const clusterer = useClusterer()
const markers = new Map<number, google.maps.marker.AdvancedMarkerElement>()
const pointsById = new Map<number, Point>()
@@ -18,11 +20,11 @@
let infoWindow: google.maps.InfoWindow | null = null
async function render(map: google.maps.Map, points: Point[]) {
- const [{ AdvancedMarkerElement, PinElement }, { InfoWindow }] = await Promise.all([
+ const [{ AdvancedMarkerElement, PinElement }, { InfoWindow }, mc] = await Promise.all([
load('marker'),
load('maps'),
+ clusterer.ensure(map),
])
- clear()
currentMap = map
if (!infoWindow) {
@@ -31,17 +33,33 @@
infoWindow.addListener('closeclick', () => clearSelection())
}
+ // 1) 消えた店舗・内容が変わった店舗のマーカーを外す
+ const next = new Map(points.map((p) => [p.id, p]))
+ const removed: google.maps.marker.AdvancedMarkerElement[] = []
+ for (const [id, marker] of markers) {
+ const p = next.get(id)
+ if (p && p.updatedAt === pointsById.get(id)?.updatedAt) continue
+ marker.map = null // 選択中でクラスタの外にあるマーカーもあるので、直接外す
+ removed.push(marker)
+ markers.delete(id)
+ pins.delete(id)
+ pointsById.delete(id)
+ if (highlightedId === id) highlightedId = null
+ }
+
+ // 2) 新しく範囲に入った店舗(と内容が変わった店舗)だけマーカーを作る
+ const added: google.maps.marker.AdvancedMarkerElement[] = []
for (const point of points) {
+ if (markers.has(point.id)) continue
const meta = CATEGORY_META[point.category]
- // 業態の色のピン(PinElement は HTMLElement なのでそのまま子要素にする)
const pin = new PinElement({
background: meta.color,
borderColor: meta.border,
glyphText: meta.glyph,
glyphColor: '#fff',
})
+ // map は指定しない。地図に載せるかどうかはクラスタリング側が決める
const marker = new AdvancedMarkerElement({
- map,
position: { lat: point.lat, lng: point.lng },
title: `${meta.label}: ${point.name}`, // ツールチップ兼スクリーンリーダー用
gmpClickable: true, // クリック・キーボード操作を有効にする
@@ -51,26 +69,43 @@
markers.set(point.id, marker)
pointsById.set(point.id, point)
pins.set(point.id, pin)
+ added.push(marker)
}
- // 描き直した後も、選択中の店舗があれば強調と InfoWindow を出し直す
+ // 3) まとめて反映し、再計算は最後に1回だけ(noDraw = true)
+ mc.removeMarkers(removed, true)
+ mc.addMarkers(added, true)
+ // 選択中の店舗があれば強調と InfoWindow を出し直す(その中で mc.render() も呼ぶ)
onSelectionChange(selectedId.value)
}
// 第8回: 選択中のピンだけ大きく・手前に表示する
+ // 第9回: 選択中のピンはクラスタから外して、どのズームでも単独で表示する
function highlight(id: number | null) {
+ const mc = clusterer.get()
+ if (id !== null && id === highlightedId) {
+ mc?.render() // 強調済み。差分更新後の再計算だけ行う
+ return
+ }
if (highlightedId !== null) {
const prevPin = pins.get(highlightedId)
const prevMarker = markers.get(highlightedId)
if (prevPin) prevPin.scale = 1
- if (prevMarker) prevMarker.zIndex = null
+ if (prevMarker) {
+ prevMarker.zIndex = null
+ mc?.addMarker(prevMarker, true) // クラスタリングの対象に戻す
+ }
}
highlightedId = id
- if (id === null) return
- const pin = pins.get(id)
- const marker = markers.get(id)
+ const pin = id === null ? undefined : pins.get(id)
+ const marker = id === null ? undefined : markers.get(id)
if (pin) pin.scale = 1.4
- if (marker) marker.zIndex = 999
+ if (marker) {
+ marker.zIndex = 999
+ mc?.removeMarker(marker, true)
+ marker.map = currentMap
+ }
+ mc?.render()
}
function onSelectionChange(id: number | null) {
@@ -96,6 +131,7 @@
function clear() {
for (const marker of markers.values()) marker.map = null
+ clusterer.get()?.clearMarkers()
markers.clear()
pointsById.clear()
pins.clear()
マーカーを作るときに map を指定しなくなった点が大きな変更です。地図に載せるか丸の中に隠すかは、クラスタリング側が決めます。addMarkers / removeMarkers の第2引数 true は「今は再計算しない」という指定で、最後に1回だけ再計算させます。更新日時が変わった店舗は作り直します。
選択中のピンはクラスタから外して地図に直接載せます(highlight)。こうしないと、選んだ店舗が丸に隠れて InfoWindow を出せません。
手順5:表示範囲が変わったら取り直す
app/components/MapView.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/components/MapView.vue
+++ b/app/components/MapView.vue
@@ -12,6 +12,8 @@
ready: [map: google.maps.Map]
// 第5回: 地図の何もない場所がクリックされた位置
'map-click': [position: google.maps.LatLngLiteral]
+ // 第9回: 地図の移動・拡大縮小が止まったときの表示範囲
+ 'bounds-change': [bounds: google.maps.LatLngBoundsLiteral]
}>()
const { isConfigured, mapId, authFailed, load } = useGoogleMaps()
@@ -36,6 +38,11 @@
map.value.addListener('click', (e: google.maps.MapMouseEvent) => {
if (e.latLng) emit('map-click', e.latLng.toJSON())
})
+ // idle は移動・ズームの操作が落ち着いたときに1回だけ発生する(ドラッグ中は発生しない)
+ map.value.addListener('idle', () => {
+ const bounds = map.value?.getBounds()
+ if (bounds) emit('bounds-change', bounds.toJSON())
+ })
emit('ready', map.value)
} catch (e) {
loadError.value = e instanceof Error ? e.message : String(e)
idle は移動やズームが落ち着いたときに1回だけ届くイベントで、ドラッグ中には届きません。
表示範囲を API のクエリに変える関数です。app/utils/ の関数は Nuxt が自動で読み込むので、import なしで使えます。
// app/utils/bbox.ts
/**
* 第9回: 地図の表示範囲を API のクエリ「西,南,東,北」に変換する。
* 小数3桁(約100m)に外側へ丸め、わずかな移動で毎回違う URL にならないようにする。
*/
export function toBboxParam(b: google.maps.LatLngBoundsLiteral): string {
const floor = (v: number) => Math.floor(v * 1000) / 1000
const ceil = (v: number) => Math.ceil(v * 1000) / 1000
return [floor(b.west), floor(b.south), ceil(b.east), ceil(b.north)].join(',')
}
// 地図の準備ができる前(サーバー描画時を含む)に使う初期範囲。東京駅周辺(第1回の初期表示付近)
export const INITIAL_BBOX = '139.750,35.670,139.785,35.695'
app/pages/index.vue(来訪者の画面)に次の変更を加えます(+ が追加、- が削除)。
app/pages/index.vue の変更(差分)
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -4,11 +4,17 @@
// 第4回: ピンを選ぶと InfoWindow と詳細パネルに店舗の情報を出す。
// 第6回: 住所・駅名から起点を決め、いちばん近い店舗を選ぶ(起点は保存しない)。
// 第8回: 業態で絞り込み、左の一覧(起点があれば近い順)と地図のピンを連動させる。
+// 第9回: 地図の表示範囲(bbox)内の店舗だけを読み込み、ピンはクラスタリングで表示する。
import type { NearbyPoint, Point } from '#shared/types/point'
import type { GeocodeCandidate } from '#shared/types/geocode'
import { sortByDistance } from '#shared/utils/distance'
-const { data: points } = await useFetch<Point[]>('/api/points', { default: () => [] })
+// 第9回: 表示範囲が変わると query が変わり、useFetch が自動で取り直す(古い要求は取り消される)
+const bbox = ref(INITIAL_BBOX)
+const { data: points } = await useFetch<Point[]>('/api/points', {
+ query: { bbox },
+ default: () => [],
+})
const { render } = useMarkers()
const { selectedId, select, clearSelection } = useSelection()
const { origin, setOrigin, clearOrigin } = useSearchOrigin()
@@ -18,15 +24,30 @@ const { visibleCategories, filteredPoints, countByCategory } = usePointFilter(po
// 一覧に並べる順番:起点があれば近い順
const listPoints = computed(() => sortByDistance(filteredPoints.value, origin.value))
-// 選択中の店舗。ID から探す(店舗データを複製して持たない)
-const selectedPoint = computed(
- () => points.value.find((p) => p.id === selectedId.value) ?? null,
+// 選択中の店舗。第9回: 地図を動かして範囲外に出ても、詳細パネルには表示し続ける
+const selectedPoint = shallowRef<Point | null>(null)
+watch(
+ [selectedId, points],
+ ([id, list]) => {
+ if (id === null) {
+ selectedPoint.value = null
+ return
+ }
+ const found = list.find((p) => p.id === id)
+ if (found) selectedPoint.value = found
+ else if (selectedPoint.value?.id !== id) selectedPoint.value = null
+ },
+ { immediate: true },
)
function onMapReady(m: google.maps.Map) {
map.value = m
}
+function onBoundsChange(b: google.maps.LatLngBoundsLiteral) {
+ bbox.value = toBboxParam(b)
+}
+
// ── 第6回: 起点から近い店舗を探す ──
const nearest = shallowRef<NearbyPoint | null>(null)
@@ -42,7 +63,7 @@ async function moveOrigin(lat: number, lng: number, label: string) {
return
}
select(first.id)
- // 起点といちばん近い店舗の両方が入るように地図を合わせる
+ // 起点といちばん近い店舗の両方が入るように地図を合わせる(その範囲の店舗が第9回の仕組みで読み込まれる)
map.value.fitBounds({
south: Math.min(lat, first.lat), north: Math.max(lat, first.lat),
west: Math.min(lng, first.lng), east: Math.max(lng, first.lng),
@@ -66,13 +87,14 @@ function onListSelect(id: number) {
}
// 業態の絞り込みで選択中の店舗が非表示になったら、選択を解除する
+// (第9回: 地図の移動で範囲外に出ただけなら解除しない)
watch(visibleCategories, (cats) => {
if (selectedPoint.value && !cats.includes(selectedPoint.value.category)) {
clearSelection()
}
})
-// 地図の準備ができた時点と、データ・絞り込みが変わった時点でピンを描き直す
+// 地図の準備ができた時点と、データ・絞り込みが変わった時点でピンを更新する(第9回から差分更新)
watch([map, filteredPoints], ([m, list]) => {
if (m) render(m, list)
})
@@ -104,7 +126,7 @@ watch([map, filteredPoints], ([m, list]) => {
@select="onListSelect"
/>
<ClientOnly>
- <MapView @ready="onMapReady" />
+ <MapView @ready="onMapReady" @bounds-change="onBoundsChange" />
<template #fallback>
<div class="map-placeholder">地図を読み込み中…</div>
</template>
useFetch の query に ref を渡すと、値が変わるたびに自動で取り直します。既定(dedupe: 'cancel')では前の要求が取り消されるので、古い範囲の結果が後から届いて上書きする事故も起きにくくなります。
📰 出典:Nuxt「useFetch」
サーバーで最初のHTMLを作るときは画面の大きさが分からないので、東京駅周辺の固定範囲を使います。その範囲の一覧はHTMLに入るので、地図より先に表示されます。
第6回の「いちばん近い店舗」は表示範囲と関係なく /api/points/nearest で探すので、範囲外の店舗でも正しく選ばれ、地図がそこへ動くと周りの店舗が読み込まれます。
app/pages/admin/index.vue(管理画面)にも同じ変更を加えます(+ が追加、- が削除)。
--- a/app/pages/admin/index.vue
+++ b/app/pages/admin/index.vue
@@ -2,11 +2,16 @@
<script setup lang="ts">
// 第5回: 店舗を登録する管理画面。地図をクリックして仮ピンを立て、フォームから登録する。
// 店舗の位置は、ここで人が決めた値(自社のデータ)として保存する。
+// 第9回: 店舗の画面と同じく、表示範囲内の店舗だけを読み込む。
import type { Point } from '#shared/types/point'
useHead({ title: '店舗の管理|店舗検索マップ(サンプル)' })
-const { data: points, refresh } = await useFetch<Point[]>('/api/points', { default: () => [] })
+const bbox = ref(INITIAL_BBOX)
+const { data: points, refresh } = await useFetch<Point[]>('/api/points', {
+ query: { bbox },
+ default: () => [],
+})
const { render } = useMarkers()
const { selectedId, select, clearSelection } = useSelection()
const { draftPosition, setDraft, clearDraft } = useDraftPoint()
@@ -18,6 +23,10 @@ function onMapReady(m: google.maps.Map) {
map.value = m
}
+function onBoundsChange(b: google.maps.LatLngBoundsLiteral) {
+ bbox.value = toBboxParam(b)
+}
+
// 地図の空いている場所をクリック → 選択を解除して仮ピンを立てる
function onMapClick(position: google.maps.LatLngLiteral) {
if (!map.value) return
@@ -48,7 +57,7 @@ watch([map, points], ([m, list]) => {
</p>
<div class="map-page__body map-page__body--admin">
<ClientOnly>
- <MapView @ready="onMapReady" @map-click="onMapClick" />
+ <MapView @ready="onMapReady" @map-click="onMapClick" @bounds-change="onBoundsChange" />
<template #fallback>
<div class="map-placeholder">地図を読み込み中…</div>
</template>
一覧・件数・選択の扱いを見直す
表示範囲だけを読み込むと「手元のデータ=地図の範囲内の店舗」になるので、第8回の画面を合わせて直しました。
| 項目 | 第8回まで | 第9回から |
|---|---|---|
| 件数表示 | 表示 N / 全 M 件 | 表示 N / 地図の範囲内 M 件 |
| 一覧 | 全店舗を表示 | 範囲内の先頭200件まで。超えた分は「ほか N 件。地図を拡大すると絞り込めます」 |
| 一覧の近い順 | 全店舗の中で近い順 | 地図の範囲内の店舗の中で近い順 |
| 選択中の店舗が範囲外に出たとき | 一覧から消えると選択解除 | 詳細パネルには表示し続ける(解除するのは業態で非表示にしたときだけ) |
一覧を200件で打ち切るのは、数千行を一度に描くと一覧が重くなるためです。全店舗を一覧で見たいなら、ページ送りや仮想スクロール(見えている行だけ描く仕組み)が別に必要です。
app/components/CategoryFilter.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/components/CategoryFilter.vue
+++ b/app/components/CategoryFilter.vue
@@ -1,6 +1,7 @@
<!-- app/components/CategoryFilter.vue -->
<script setup lang="ts">
// 第8回: 業態のチェックボックス(第2回の凡例を置き換え。ピンの色見本も兼ねる)
+// 第9回: 件数は「地図の表示範囲内」の件数になった
import { CATEGORIES, CATEGORY_META, type Category } from '#shared/types/point'
defineProps<{ counts: Record<Category, number>; shown: number; total: number }>()
@@ -18,6 +19,6 @@ const visible = defineModel<Category[]>({ required: true })
</span>
{{ CATEGORY_META[c].label }}({{ counts[c] }})
</label>
- <span class="category-filter__count">表示 {{ shown }} / 全 {{ total }} 件</span>
+ <span class="category-filter__count">表示 {{ shown }} / 地図の範囲内 {{ total }} 件</span>
</fieldset>
</template>
app/components/PointList.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/components/PointList.vue
+++ b/app/components/PointList.vue
@@ -12,6 +12,11 @@
}>()
const emit = defineEmits<{ select: [id: number] }>()
+// 第9回: 一覧に並べるのは先頭から最大200件まで。数千行を一度に描くと画面が重くなるため
+const LIST_LIMIT = 200
+const shownPoints = computed(() => props.points.slice(0, LIST_LIMIT))
+const hiddenCount = computed(() => Math.max(props.points.length - LIST_LIMIT, 0))
+
const rowEls = new Map<number, HTMLElement>()
function setRowEl(id: number, el: unknown) {
if (el instanceof HTMLElement) rowEls.set(id, el)
@@ -33,7 +38,7 @@
<nav class="point-list" aria-label="店舗の一覧">
<p v-if="points.length === 0" class="point-list__empty">表示する店舗がありません。</p>
<ul v-else>
- <li v-for="p in points" :key="p.id" :ref="(el) => setRowEl(p.id, el)">
+ <li v-for="p in shownPoints" :key="p.id" :ref="(el) => setRowEl(p.id, el)">
<button
type="button"
class="point-list__item"
@@ -51,5 +56,8 @@
</button>
</li>
</ul>
+ <p v-if="hiddenCount > 0" class="point-list__more">
+ ほか {{ hiddenCount.toLocaleString('ja-JP') }} 件。地図を拡大すると絞り込めます。
+ </p>
</nav>
</template>
クラスタの丸(件数で大きさと色を変える)と、一覧の「ほか N 件」のスタイルを CSS に足します。app/assets/css/main.css に次の変更を加えます(+ が追加、- が削除)。
--- a/app/assets/css/main.css
+++ b/app/assets/css/main.css
@@ -583,6 +583,42 @@
}
}
+/* 第9回: クラスタ(まとめた件数の丸) */
+.cluster-badge {
+ display: grid;
+ place-content: center;
+ width: 36px;
+ height: 36px;
+ border: 3px solid rgb(255 255 255 / 85%);
+ border-radius: 50%;
+ background: #1f6feb;
+ color: #fff;
+ font-size: 12px;
+ font-weight: 700;
+ box-shadow: 0 1px 4px rgb(0 0 0 / 30%);
+ transform: translateY(50%); /* マーカーは下端が座標に来るので、丸の中心を座標に合わせる */
+}
+
+.cluster-badge[data-size='m'] {
+ width: 44px;
+ height: 44px;
+ background: #d4a72c;
+}
+
+.cluster-badge[data-size='l'] {
+ width: 54px;
+ height: 54px;
+ background: #cf222e;
+}
+
+.point-list__more {
+ margin: 0;
+ padding: 8px 10px;
+ border-top: 1px solid #d0d7de;
+ color: #57606a;
+ font-size: 12px;
+}
+
/* 第5回: 管理画面(一覧なしの 地図 + フォーム) */
.map-page__note {
margin: 0;
動作確認の方法
npm run devを一度起動してテーブルを作ったら、別のターミナルでnpm run seedを実行して5,000件を追加する- http://localhost:3000 を開き、地図を縮小 → ピンが件数入りの丸にまとまることを確認
- 丸をクリック → 地図が拡大され、丸が分かれていくことを確認
- DevTools の Network タブで、地図を動かすたびに
/api/points?bbox=…が呼ばれることを確認 - Performance パネルで地図を動かしたときの記録を取り、長い処理(Long Task)が大量に出ないことを確認
- 一覧から店舗を選ぶ → 縮小してもその店舗のピンだけは丸にまとまらずに残ることを確認
- http://localhost:3000/admin でも、地図を動かすと「表示中の店舗」の件数が変わることを確認
- 確認が終わったら
node scripts/seed-points.ts --removeでダミー店舗を消す
筆者の環境では、npm run build と npm run typecheck の成功に加え、ビルド後のサーバーに5,000件のダミー店舗を入れて curl で次を確認しました。
| 確認内容 | 結果 |
|---|---|
| シードスクリプトで5,000件追加 | 0.1秒未満で完了 |
| bbox なし(サンプル20件+ダミー5,000件) | 5,020件・約1.1MB の応答 |
| 東京駅周辺の初期範囲 | 69件・約15KB の応答 |
| 南北が逆・数値でない・緯度95度の bbox | いずれも 400 |
| 日付変更線をまたぐ bbox | 200(0件) |
| 索引の利用(EXPLAIN QUERY PLAN) | SEARCH points USING INDEX points_lat_lng |
| 最初のHTML(来訪者の画面) | 「表示 69 / 地図の範囲内 69 件」と一覧69行が入る |
--remove | ダミーの5,000件だけが消える |
bbox で絞ると、応答は全件の70分の1程度になりました。一方、クラスタ表示・クリック・地図を動かしたときの再読み込み・ブラウザでの描画性能は、執筆環境に本物のAPIキーとブラウザでの操作環境がないため確認できていません。 「何件まで快適か」は端末にも左右され、公式ガイドにも目安は見当たりませんでした。ご自身のキーと、来訪者が使いそうな端末(数年前のスマートフォンなど)で計測してください。
つまずきやすい点・セキュリティ上の注意
- bbox の値をそのまま SQL に埋め込む:検証してから db0 の
sqlタグ(値を安全に渡す仕組み)で渡します。文字列連結は SQLインジェクション(=細工した入力でデータベースを操作される攻撃)の入口になります - 件数の上限を設けない:最大まで縮小すると全店舗を要求されます。上限に達したときの見せ方(「拡大してください」など)は要件次第です
- 動かすたびに全ピンを作り直す:差分更新にしないと、少しの移動で数千個の部品を作り直すことになります
- マーカーに map を指定したままクラスタに渡す:まとめるはずのピンが一瞬表示されるなど、表示が乱れる原因になります
- SQLite のまま大規模化する:数十万件以上なら、PostgreSQL の PostGIS(地理データ用の拡張機能)などを検討します
発注者向けメモ
- クラスタリングと表示範囲読み込みは、Google の追加API費用が発生しない処理です。地図の課金(マップロード)は、来訪者が地図を何度動かしても増えません。費用は開発工数と自社サーバーの負荷として現れます
- 店舗数の見込み(今と3年後)を最初に伝えてください。数百件なら全件読み込みで足り、数千〜数万件なら今回の作り、数十万件を超えるなら地図タイルを事前に作る方式など別の作りになり、見積もりも変わります。取扱店・代理店まで載せるかどうかで、件数の桁が変わることがよくあります
- 「一覧で全店舗を見たい」「全国の店舗を一度に地図に出したい」は重くなる代表例です。絞り込みや住所・駅名の検索で足りないかを確認しておくと、工数を抑えられます
- 性能の確認は来訪者が使う端末で行います。開発者のパソコンでは快適でも、古いスマートフォンでは遅いことがよくあります。受け入れテストの条件(端末・件数・操作)を決めておきましょう
発注者がやることのチェックリストです。
- ☐ 店舗数の見込み(今・1年後・3年後)を、掲載する業態の範囲とあわせて数字で伝えた
- ☐ 一覧に全店舗が必要か、範囲や絞り込みで足りるかを決めた
- ☐ 性能を確認する端末と、合格の目安(地図が表示されるまで何秒以内など)を決めた
- ☐ 件数が上限を超えたときの画面の出し方を確認した
開発会社への確認に使える質問例です。
- 「店舗が今の10倍になったとき、どこから遅くなりますか?その場合の対応策は?」
- 「地図を動かしたときに、サーバーへの問い合わせは何回発生しますか?Google の費用は増えますか?」
- 「性能の確認は、どの端末・何件のデータで行いますか?」
まとめと次回予告
この回では、地図に見えている範囲の店舗だけを読み込み、近くのピンを件数入りの丸にまとめました。サーバー側は bbox の検証と索引、画面側は差分更新とクラスタリング、そして「手元のデータ=範囲内の店舗」に合わせた一覧・件数・選択の見直し、の3点が押さえどころです。
次回(第10回)は「現在地から半径◯km以内の店舗を探し、徒歩・車の所要時間を出す(Routes API)」です。ブラウザの位置情報で現在地を起点にし、半径の円の中にある店舗だけを残したうえで、近い店舗までの所要時間を Google の Routes API で調べます。
この連載の記事一覧
この記事は連載「NuxtとGoogle Mapsで作る店舗検索マップ」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第1回】APIキーとMap IDを用意して、Nuxt 4で地図を1枚表示する
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第2回】Advanced Markersで業態ごとに色分けした店舗のピンを立てる
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第3回】店舗データをNuxt server API + SQLiteに保存する
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第4回】ピンをクリックしてInfoWindowと店舗の詳細パネルを出す
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第5回】管理画面で地図をクリックして店舗の位置を決める
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第6回】来訪者が入れた住所・駅名から近い店舗を探す(Geocoding API v4をサーバー経由で)
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第7回】Places API (New)で店舗をGoogleマップの情報と結びつけ、営業時間と評価を出す
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第8回】業態で絞り込み、店舗一覧と地図を連動させる
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第9回】店舗が数千件でも重くしない:クラスタリングと表示範囲読み込み(この記事)
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第10回】現在地から半径◯km以内の店舗を探し、徒歩・車の所要時間を出す(Routes API)
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第11回】CSVで既存の店舗台帳を一括取り込みする
- 【NuxtとGoogle Mapsで作る店舗検索マップ 第12回】本番公開前チェック:APIキー制限・クォータ・予算アラート・管理画面の保護










コメント
コメント一覧 (2件)
[…] Google Maps API とNuxtで社内向けの情報集約マップを作る連載の第10回です。前回(第9回)では、クラスタリングと表示範囲の読み込みで、地点が数千件あっても地図が重くならないようにしました。今回は、ブラウザの位置情報で現在地を表示し、「現在地から半径◯km」や「地図上に描いた多角形のエリア」の中にある地点だけを一覧と地図に残す機能を作ります。 […]
[…] マーカーが数千件でも重くしない:クラスタリングと表示範囲読み込み […]