(2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)
Google Maps API とNuxtで社内向けの情報集約マップを作る連載の第9回です。前回(第8回)では、カテゴリで地点を絞り込み、左の一覧と地図のピンを連動させました。今回は、地点が数千件に増えても地図が重くならないように、近くのピンを「◯件」の丸にまとめるクラスタリングと、地図に見えている範囲の地点だけをサーバーから読み込む仕組みを入れます。
「最初は数十件でも、何年か使えば地点は数千件になる。地図が固まったりしない?」
結論から言うと、Google Maps の地図はピンの数が増えるほどブラウザの負担が大きくなるので、「見えている範囲だけ取る」「近くのピンはまとめて描く」の2つを組み合わせるのが定番の対策です。どちらも画面とサーバーの中の処理で、Google の追加のAPI費用は発生しません。大事なのは、今と数年後の地点数の見込みを最初に決めておくことです。件数の桁が変わると、選ぶべき作り方も見積もりも変わります。
この回で作るもの:クラスタリングと表示範囲読み込み
| 操作 | 画面の動き |
|---|---|
| 地図を縮小する | 近くのピンが「128」のような件数入りの丸(クラスタ)にまとまる。件数が多いほど丸が大きく、色が変わる |
| クラスタをクリックする | その範囲が収まるまで地図が拡大され、個々のピンに分かれていく |
| 地図を動かす・拡大縮小する | 操作が止まった時点で、見えている範囲の地点だけをサーバーから取り直す |
| ピンや一覧の行を選ぶ | 選んだピンはクラスタにまとめず、どのズームでも単独で表示される |
仕組み:取る量を減らし、描く量を減らす
地点が多いときに重くなる原因は、大きく2つあります。
| 原因 | 対策 | 今回の実装 |
|---|---|---|
| サーバーから全件を毎回受け取る(通信量・処理量が件数に比例) | 地図の表示範囲(bbox=表示範囲を囲む四角形の東西南北)の地点だけ取る | GET /api/points?bbox=西,南,東,北 と、緯度・経度の索引 |
| ピン1本1本を画面の部品として描く(部品が数千個になる) | 近くのピンを1つの丸にまとめて描く(クラスタリング) | @googlemaps/markerclusterer |
さらに、地図を少し動かしただけで全部のピンを作り直していた第8回までの描き方を、増えた分・消えた分だけ更新する差分更新に変えます。
実装
| ファイル | 役割 |
|---|---|
server/utils/bbox.ts | bbox の文字列を検証して数値にする(新規) |
server/api/points/index.get.ts | bbox で範囲内の地点だけ返す(更新) |
server/plugins/db-init.ts | 緯度・経度の索引を作る(更新) |
scripts/seed-points.ts | 動作確認用に5,000件のダミー地点を入れる(新規) |
app/composables/useClusterer.ts | クラスタリングの準備と、件数入りの丸の描き方(新規) |
app/composables/useMarkers.ts | 差分更新と、選択中ピンのクラスタ除外(更新) |
app/components/MapView.vue / app/pages/index.vue | 表示範囲の変化を受けて取り直す(更新) |
package.json | npm run seed の定義を追加(更新) |
app/utils/bbox.ts | 表示範囲を API のクエリに変換(新規) |
app/components/CategoryFilter.vue / app/components/PointList.vue | 件数の表記と、一覧の200件打ち切り(更新) |
app/assets/css/main.css | クラスタの丸と「ほか N 件」のスタイル(更新) |
ライブラリは Google が公開している @googlemaps/markerclusterer(2系)を追加します。
npm install @googlemaps/markerclusterer@2
📰 出典: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,8 +1,32 @@
+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)
})
server/plugins/db-init.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/plugins/db-init.ts
+++ b/server/plugins/db-init.ts
@@ -17,6 +17,8 @@ export default defineNitroPlugin(async () => {
fetched_at 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 で確認すると、SEARCH points USING INDEX points_lat_lng と表示され、索引が使われていました。
手順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 = ['store', 'property', 'site', 'inspection']
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 で5,000件、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を自作してAdvancedMarkerElementにappendする第2回と同じ作法にそろえました。丸の見た目はapp/assets/css/main.cssの.cluster-badgeで、件数に応じて大きさと色を変えています - ライブラリはブラウザでだけ読み込む:筆者の環境では、最初に通常の
importで書いたところ、ビルド自体は成功したのに、ページを開くとサーバー側で「名前付き export が見つからない」エラーになりました。このパッケージは Node.js から見ると CommonJS 形式として読まれるためです。地図と同じくブラウザ専用の機能なので、必要になった時点で動的import()しています - クラスタのクリックは、ライブラリ既定の動作(そのクラスタの範囲に地図を合わせて拡大)をそのまま使っています
📰 出典:npm「@googlemaps/markerclusterer」
手順4:マーカーを差分だけ更新する
app/composables/useMarkers.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/app/composables/useMarkers.ts
+++ b/app/composables/useMarkers.ts
@@ -5,10 +5,12 @@ import { CATEGORY_META, type Point } from '#shared/types/point'
* - マーカーは 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 @@ export function useMarkers() {
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 @@ export function useMarkers() {
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 @@ export function useMarkers() {
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 @@ export function useMarkers() {
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 @@ const emit = defineEmits<{
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 @@ onMounted(async () => {
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)
// 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 に次の変更を加えます(+ が追加、- が削除)。
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -3,26 +3,47 @@
// 第6回: 住所検索(サーバー経由の Geocoding API v4)の候補からも仮ピンを立てられる。
// 第7回: 施設名検索(Places API (New))で選んだ施設からも仮ピンを立てられる。
// 第8回: カテゴリで絞り込み、左の一覧と地図のピンを連動させる。
+// 第9回: 地図の表示範囲(bbox)内の地点だけを読み込み、ピンはクラスタリングで表示する。
import type { Point } from '#shared/types/point'
import type { GeocodeCandidate } from '#shared/types/geocode'
import type { PickedPlace } from '~/composables/usePlaces'
-const { data: points, refresh } = await useFetch<Point[]>('/api/points', { default: () => [] })
+// 第9回: 表示範囲が変わると query が変わり、useFetch が自動で取り直す(古い要求は取り消される)
+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, draftOrigin, setDraft, clearDraft } = useDraftPoint()
const map = shallowRef<google.maps.Map | null>(null)
const { visibleCategories, filteredPoints, countByCategory } = usePointFilter(points)
-// 選択中の地点。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)
+}
+
// 地図の空いている場所をクリック → 選択を解除して仮ピンを立てる
function onMapClick(position: google.maps.LatLngLiteral) {
if (!map.value) return
@@ -69,9 +90,10 @@ function onListSelect(id: number) {
if (p && map.value) map.value.panTo({ lat: p.lat, lng: p.lng })
}
-// 絞り込みで選択中の地点が見えなくなったら、選択を解除する
-watch(filteredPoints, (list) => {
- if (selectedId.value !== null && !list.some((p) => p.id === selectedId.value)) {
+// カテゴリの絞り込みで選択中の地点が非表示になったら、選択を解除する
+// (第9回: 地図の移動で範囲外に出ただけなら解除しない)
+watch(visibleCategories, (cats) => {
+ if (selectedPoint.value && !cats.includes(selectedPoint.value.category)) {
clearSelection()
}
})
@@ -86,7 +108,7 @@ async function onSaved(point: Point) {
select(point.id) // 登録した地点をそのまま選択状態にする
}
-// 地図の準備ができた時点と、データ・絞り込みが変わった時点でピンを描き直す
+// 地図の準備ができた時点と、データ・絞り込みが変わった時点でピンを更新する(第9回から差分更新)
watch([map, filteredPoints], ([m, list]) => {
if (m) render(m, list)
})
@@ -111,7 +133,7 @@ watch([map, filteredPoints], ([m, list]) => {
<div class="map-page__body">
<PointList :points="filteredPoints" :selected-id="selectedId" @select="onListSelect" />
<ClientOnly>
- <MapView @ready="onMapReady" @map-click="onMapClick" />
+ <MapView @ready="onMapReady" @map-click="onMapClick" @bounds-change="onBoundsChange" />
<template #fallback>
<div class="map-placeholder">地図を読み込み中…</div>
</template>
useFetch の query に ref を渡すと、値が変わるたびに自動で取り直してくれます。既定の設定(dedupe: 'cancel')では、前の要求がまだ終わっていなければ取り消されるので、「古い範囲の結果が後から届いて上書きする」事故も起きにくくなっています。範囲は小数3桁(約100m)に外側へ丸め、ほんの少しの移動で毎回違う URL にならないようにしました。
📰 出典:Nuxt「useFetch」
地図の準備ができる前(サーバーで最初のHTMLを作るとき)は画面の大きさが分からないので、東京駅周辺の固定範囲を使います。地図が表示されて最初の idle が来た時点で、実際の表示範囲に切り替わります。
一覧・件数・選択の扱いを見直す
表示範囲だけを読み込むようにすると、「手元にあるデータ=地図に見えている範囲の地点」になります。第8回の画面の意味がいくつか変わるので、合わせて直しました。
| 項目 | 第8回まで | 第9回から |
|---|---|---|
| 件数表示 | 表示 N / 全 M 件 | 表示 N / 地図の範囲内 M 件 |
| 一覧 | 全件を表示 | 範囲内の先頭200件まで。超えた分は「ほか N 件。地図を拡大すると絞り込めます」 |
| 選択中の地点が範囲外に出たとき | 一覧から消えると選択解除 | 詳細パネルには表示し続ける(解除するのはカテゴリで非表示にしたときだけ) |
一覧を200件で打ち切るのは、数千行を一度に画面へ描くと、地図より先に一覧が重くなるためです。全件を一覧で見たい要件があるなら、ページ送りや「仮想スクロール(見えている行だけ描く仕組み)」を別途入れることになります。
件数の表記と、一覧の打ち切りは次のように変えます。選択中の地点の扱いは、上の pages/index.vue の差分(selectedPoint と visibleCategories の watch)です。
app/components/CategoryFilter.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/components/CategoryFilter.vue
+++ b/app/components/CategoryFilter.vue
@@ -1,5 +1,6 @@
<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 }>()
@@ -17,6 +18,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
@@ -5,6 +5,11 @@ import { CATEGORY_META, type Point } from '#shared/types/point'
const props = defineProps<{ points: Point[]; selectedId: number | null }>()
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)
@@ -26,7 +31,7 @@ watch(
<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"
@@ -41,5 +46,8 @@ watch(
</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
@@ -493,3 +493,39 @@ body {
max-height: 240px;
}
}
+
+/* 第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;
+}
動作確認の方法
npm run devを一度起動してテーブルを作ったら、npm run seedで5,000件を追加する- http://localhost:3000 を開き、地図を縮小 → ピンが件数入りの丸にまとまることを確認
- 丸をクリック → 地図が拡大され、丸が分かれていくことを確認
- DevTools の Network タブで、地図を動かすたびに
/api/points?bbox=…が呼ばれることを確認 - Performance パネルで地図をパンしたときの記録を取り、長い処理(Long Task)が大量に出ないことを確認
- 一覧から地点を選ぶ → 縮小してもその地点のピンだけは丸にまとまらずに残ることを確認
- 確認が終わったら
node scripts/seed-points.ts --removeでダミー地点を消す
筆者の環境では、npm run build と npm run typecheck の成功に加え、ビルド後のサーバーに5,000件のダミー地点を入れて curl で次を確認しました。
| 確認内容 | 結果 |
|---|---|
| シードスクリプトで5,000件追加 | 0.1秒未満で完了 |
| bbox なし(全5,020件) | 約1.2MB の応答 |
| 東京駅周辺の初期範囲 | 69件・約15KB の応答 |
| 南北が逆・数値でない・緯度95度の bbox | いずれも 400 |
| 日付変更線をまたぐ bbox | 200(0件) |
| 最初のHTML | 「表示 69 / 地図の範囲内 69 件」と一覧69行が入る |
bbox で絞ると、応答の大きさが全件の80分の1程度になりました(件数や範囲によって変わります)。一方、地図上でのクラスタ表示・クラスタのクリック・パン時の再読み込み・ブラウザでの描画性能は、執筆環境に本物のAPIキーとブラウザでの操作環境がないため確認できていません。 クラスタリングで「何件まで快適か」は端末の性能にも左右されるので、ご自身のキーと、実際に使う端末(特に社用のスマートフォンやノートPC)で計測してください。
(追記)第8回の状態からこの記事の手順どおりに進め、Node.js 24 で npm run build・npm run typecheck が通ること、npm run seed で5,000件を追加したあと、bbox なしで5,020件・東京駅周辺の初期範囲で69件が返ること、不正な bbox(南北が逆・数値でない・緯度95)が 400 になること、索引が使われること(SEARCH points USING INDEX points_lat_lng)、HTMLに「表示 69 / 地図の範囲内 69 件」が出ること、--remove で5,000件が消えることを、あらためて確認しました。
つまずきやすい点・セキュリティ上の注意
- bbox の値をそのまま SQL に埋め込む:必ず検証してから、db0 の
sqlタグ(値を安全に渡す仕組み)で渡します。文字列連結で SQL を組むと、SQLインジェクション(=細工した入力でデータベースを操作される攻撃)の入口になります - 件数の上限を設けない:地図を最大まで縮小すると全件を要求されます。今回は1回10,000件で打ち切りました。上限に達したら「拡大してください」と表示する、縮小時は件数だけ返す、などの設計は要件次第です
- 動かすたびに全ピンを作り直す:差分更新にしないと、少しのパンで数千個の部品を作り直すことになります
- マーカーに map を指定したままクラスタに渡す:まとめるはずのピンが一瞬表示されるなど、表示が乱れる原因になります
- 仮ピン(登録用)をクラスタに入れる:登録途中のピンが丸に隠れてしまいます。第5回のとおり別管理のままにしています
- SQLite のまま大規模化する:緯度・経度の索引は簡易的なものです。数十万件以上や「近い順」の検索が必要なら、PostgreSQL の PostGIS(地理データ用の拡張機能)などを検討します
発注者向けメモ
- クラスタリングと表示範囲読み込みは、Google の追加API費用が発生しない処理です。費用は開発工数と、自社サーバー・データベースの負荷として現れます
- 地点数の見込み(今と3年後)を最初に伝えてください。数百件なら全件読み込みで足り、数千〜数万件なら今回の作り、数十万件を超えるなら地図タイルを事前に作る方式など別の作りになり、見積もりも変わります
- 「一覧で全件を見たい」「全件を地図に一度に出したい」という要望は重くなる代表例です。本当に必要か(検索や絞り込みで足りないか)を業務の流れで確認しておくと、工数を抑えられます
- 性能の確認は実際に使う端末で行うのが確実です。開発者の高性能なPCでは快適でも、現場のスマートフォンでは遅い、ということがよく起こります。受け入れテストの条件(端末・件数・操作)を決めておきましょう
発注者がやることのチェックリストです。
- ☐ 地点数の見込み(今・1年後・3年後)を数字で伝えた
- ☐ 一覧に全件が必要か、範囲や絞り込みで足りるかを決めた
- ☐ 性能を確認する端末と、合格の目安(操作して何秒以内など)を決めた
- ☐ 件数が上限を超えたときの画面の出し方を確認した
開発会社への確認に使える質問例です。
- 「地点が今の10倍になったとき、どこから遅くなりますか?その場合の対応策は?」
- 「地図を動かしたときに、サーバーへの問い合わせは何回発生しますか?」
- 「性能の確認は、どの端末・何件のデータで行いますか?」
まとめと次回予告
この回では、地図に見えている範囲の地点だけをサーバーから読み込み、近くのピンを件数入りの丸にまとめて表示するようにしました。サーバー側は bbox の検証と索引、画面側は差分更新とクラスタリング、そして「手元のデータ=範囲内の地点」になったことに合わせた一覧・件数・選択の見直し、の3点が押さえどころです。
次回は「現在地から半径◯km/描いたエリア内の地点を探す」です。ブラウザの位置情報で現在地を取り、半径の円や、地図上に描いた多角形の中にある地点だけを一覧に残す機能を作ります。
この連載の記事一覧
この記事は連載「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))
- 【NuxtとGoogle Mapsで作る情報集約マップ 第8回】カテゴリで絞り込み、一覧と地図を連動させる
- 【NuxtとGoogle Mapsで作る情報集約マップ 第9回】マーカーが数千件でも重くしない:クラスタリングと表示範囲読み込み(この記事)
- 【NuxtとGoogle Mapsで作る情報集約マップ 第10回】現在地から半径◯km/描いたエリア内の地点を探す
- 【NuxtとGoogle Mapsで作る情報集約マップ 第11回】CSVで既存の台帳を一括取り込みする
- 【NuxtとGoogle Mapsで作る情報集約マップ 第12回】本番公開前チェック:APIキー制限・クォータ・予算アラート・性能










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