MENU

問い合わせ


    【NuxtとGoogle Mapsで作る情報集約マップ 第8回】カテゴリで絞り込み、一覧と地図を連動させる

    (2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)

    Google Maps API とNuxtで社内向けの情報集約マップを作る連載の第8回です。前回(第7回)では、Places API (New) で施設名を検索し、選んだ施設の位置に地点を登録できるようにしました。今回は、カテゴリのチェックボックスで表示する地点を絞り込み、左側に地点の一覧を出して、一覧と地図を連動させます。一覧の行を選ぶと地図がその地点へ移動してピンが大きくなり、地図のピンを選ぶと一覧の該当行が強調されてスクロールします。

    「地図だけだと、ピンが多いとどこに何があるか探しにくい。一覧もあると助かるけど、作るのは大変?」

    結論から言うと、ここまでの回で「選択中の地点」を1か所で管理する形にしてあるので、一覧を足す作業自体は小さく済みます。今回の実装はすべて画面の中の処理で、Google の追加のAPI費用もかかりません。工数を左右するのは技術よりも、「一覧に何を出すか」「どの順に並べるか」「何で絞り込むか」といった業務の要件をどう決めるかです。

    目次

    この回で作るもの:絞り込みと一覧の連動

    操作画面の動き
    カテゴリのチェックを外すそのカテゴリのピンと一覧の行が同時に消える。「表示 N / 全 M 件」も更新
    一覧の行をクリック地図がその地点へ移動し、ピンが大きく表示され、InfoWindow と詳細パネルが開く
    地図のピンをクリック一覧の該当行が強調され、見える位置までスクロールする
    選択中の地点のカテゴリを非表示にする選択が解除される

    画面は「一覧(左)・地図(中央)・詳細(右)」の3列です。スマートフォンなど幅の狭い画面では、地図・詳細・一覧の順に縦に並べます。

    仕組み:状態は2つだけ、あとは計算で出す

    画面全体で共有する状態は、次の2つだけです。

    状態置き場所役割
    選択中の地点IDuseSelection(第4回)地図・一覧・詳細パネル・InfoWindow が同じ地点を指す
    表示するカテゴリの配列usePointFilter(今回)地図のピンと一覧が同じ絞り込み結果を使う

    絞り込んだ結果の地点リストは、状態として持たずに computed(元のデータから自動で計算される値)で作ります。元のデータ・表示カテゴリのどちらが変わっても結果が自動で更新されるので、「地図は絞り込まれたのに一覧は古いまま」というずれが起きません。

    📰 出典:Vue.js「算出プロパティ」

    実装

    ファイル役割
    app/composables/usePointFilter.ts表示カテゴリの共有と、絞り込み結果・カテゴリ別件数の計算(新規)
    app/components/CategoryFilter.vueカテゴリのチェックボックス。第2回の凡例(CategoryLegend.vue)を置き換え(新規)
    app/components/PointList.vue地点の一覧(新規)
    app/composables/useMarkers.ts選択中のピンを大きく表示(更新)
    app/pages/index.vue3列の配置と連動の処理(更新)
    app/assets/css/main.cssチェックボックス・一覧・3列の配置のスタイル(更新)

    手順1:絞り込みの composable

    // app/composables/usePointFilter.ts
    import { CATEGORIES, type Category, type Point } from '#shared/types/point'
    
    /**
     * 第8回: カテゴリによる絞り込み。
     * 表示するカテゴリを useState で共有し、地図のピンと一覧の両方が同じ結果を使う。
     */
    export function usePointFilter(points: Ref<Point[]>) {
      const visibleCategories = useState<Category[]>('visible-categories', () => [...CATEGORIES])
    
      const filteredPoints = computed(() =>
        points.value.filter((p) => visibleCategories.value.includes(p.category)),
      )
    
      // カテゴリごとの件数(絞り込み前)。チェックボックスの横に出す
      const countByCategory = computed(() => {
        const counts = Object.fromEntries(CATEGORIES.map((c) => [c, 0])) as Record<Category, number>
        for (const p of points.value) counts[p.category]++
        return counts
      })
    
      return { visibleCategories, filteredPoints, countByCategory }
    }

    表示カテゴリは useState で持ちます。初期値は全カテゴリです。第9回で地点の読み込み方を「地図の表示範囲だけ取る」形に変えても、絞り込みはこの composable の中で完結しているので影響を受けません。

    手順2:カテゴリのチェックボックス

    <!-- app/components/CategoryFilter.vue -->
    <script setup lang="ts">
    // 第8回: カテゴリのチェックボックス(第2回の凡例を置き換え。ピンの色見本も兼ねる)
    import { CATEGORIES, CATEGORY_META, type Category } from '#shared/types/point'
    
    defineProps<{ counts: Record<Category, number>; shown: number; total: number }>()
    // v-model で表示中のカテゴリ配列を受け渡す
    const visible = defineModel<Category[]>({ required: true })
    </script>
    
    <template>
      <fieldset class="category-filter">
        <legend class="visually-hidden">表示するカテゴリ</legend>
        <label v-for="c in CATEGORIES" :key="c" class="category-filter__item">
          <input v-model="visible" type="checkbox" :value="c">
          <span class="legend__dot" :style="{ background: CATEGORY_META[c].color }" aria-hidden="true">
            {{ CATEGORY_META[c].glyph }}
          </span>
          {{ CATEGORY_META[c].label }}({{ counts[c] }})
        </label>
        <span class="category-filter__count">表示 {{ shown }} / 全 {{ total }} 件</span>
      </fieldset>
    </template>

    Vue では、複数のチェックボックスに同じ配列を v-model でつなぐと、チェックされた value の配列として扱えます。defineModel を使うと、親の v-model="visibleCategories" とこの配列がそのまま結びつきます。

    📰 出典:Vue.js「コンポーネントの v-model」

    第2回で作った凡例は、ピンの色見本を兼ねたこのチェックボックスに置き換えました。チェックボックス全体を fieldset で囲み、読み上げソフト向けに見えない見出し(legend)を付けています。

    使わなくなった凡例のコンポーネントは削除します。

    rm app/components/CategoryLegend.vue

    手順3:地点の一覧

    <!-- app/components/PointList.vue -->
    <script setup lang="ts">
    // 第8回: 地点の一覧。行を選ぶと地図のピンと連動し、ピンを選ぶと該当行までスクロールする
    import { CATEGORY_META, type Point } from '#shared/types/point'
    
    const props = defineProps<{ points: Point[]; selectedId: number | null }>()
    const emit = defineEmits<{ select: [id: number] }>()
    
    const rowEls = new Map<number, HTMLElement>()
    function setRowEl(id: number, el: unknown) {
      if (el instanceof HTMLElement) rowEls.set(id, el)
      else rowEls.delete(id)
    }
    
    // 地図側で選択が変わったら、一覧の該当行が見える位置までスクロールする
    watch(
      () => props.selectedId,
      async (id) => {
        if (id === null) return
        await nextTick()
        rowEls.get(id)?.scrollIntoView({ block: 'nearest', behavior: 'smooth' })
      },
    )
    </script>
    
    <template>
      <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)">
            <button
              type="button"
              class="point-list__item"
              :class="{ 'is-selected': p.id === selectedId }"
              :aria-current="p.id === selectedId ? 'true' : undefined"
              @click="emit('select', p.id)"
            >
              <span class="legend__dot" :style="{ background: CATEGORY_META[p.category].color }" aria-hidden="true">
                {{ CATEGORY_META[p.category].glyph }}
              </span>
              <span class="point-list__name">{{ p.name }}</span>
            </button>
          </li>
        </ul>
      </nav>
    </template>

    テンプレートでは、行ごとに <button> を置き、選択中の行には強調用のクラスと aria-current="true" を付けています。行を <button> にしておくと、Tab キーで移動して Enter で選ぶ操作が特別な実装なしで使えます。

    各行の要素は、関数形式の ref(:ref="(el) => setRowEl(p.id, el)")で ID ごとに控えておき、選択が変わったら scrollIntoView({ block: 'nearest' }) で該当行を表示します。nearest を指定すると、すでに見えている行ではスクロールが起きないので、一覧から選んだときに表示が無駄に動きません。

    手順4:選択中のピンを強調する

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

    --- a/app/composables/useMarkers.ts
    +++ b/app/composables/useMarkers.ts
    @@ -4,6 +4,7 @@ import { CATEGORY_META, type Point } from '#shared/types/point'
      * 地点データから Advanced Marker を作って地図に載せる。
      * - マーカーは Vue のリアクティブにせず、プレーンな Map(id → マーカー)で管理する
      * - クリック(またはキーボードの Enter)で地点を選択し、InfoWindow に概要を出す(第4回)
    + * - 選択中のピンを大きくして強調する(第8回)
      */
     export function useMarkers() {
       const { load } = useGoogleMaps()
    @@ -11,6 +12,8 @@ export function useMarkers() {
     
       const markers = new Map<number, google.maps.marker.AdvancedMarkerElement>()
       const pointsById = new Map<number, Point>()
    +  const pins = new Map<number, google.maps.marker.PinElement>()
    +  let highlightedId: number | null = null
       let currentMap: google.maps.Map | null = null
       let infoWindow: google.maps.InfoWindow | null = null
     
    @@ -47,10 +50,32 @@ export function useMarkers() {
           marker.addEventListener('gmp-click', () => select(point.id))
           markers.set(point.id, marker)
           pointsById.set(point.id, point)
    +      pins.set(point.id, pin)
         }
     
    -    // 描き直した後も、選択中の地点があれば InfoWindow を出し直す
    -    showInfoWindow(selectedId.value)
    +    // 描き直した後も、選択中の地点があれば強調と InfoWindow を出し直す
    +    onSelectionChange(selectedId.value)
    +  }
    +
    +  // 第8回: 選択中のピンだけ大きく・手前に表示する
    +  function highlight(id: number | null) {
    +    if (highlightedId !== null) {
    +      const prevPin = pins.get(highlightedId)
    +      const prevMarker = markers.get(highlightedId)
    +      if (prevPin) prevPin.scale = 1
    +      if (prevMarker) prevMarker.zIndex = null
    +    }
    +    highlightedId = id
    +    if (id === null) return
    +    const pin = pins.get(id)
    +    const marker = markers.get(id)
    +    if (pin) pin.scale = 1.4
    +    if (marker) marker.zIndex = 999
    +  }
    +
    +  function onSelectionChange(id: number | null) {
    +    highlight(id)
    +    showInfoWindow(id)
       }
     
       function showInfoWindow(id: number | null) {
    @@ -66,13 +91,15 @@ export function useMarkers() {
         infoWindow.open({ map: currentMap, anchor: marker })
       }
     
    -  // 選択が変わったら(地図・詳細パネルのどちらから変えても)InfoWindow を追従させる
    -  watch(selectedId, showInfoWindow)
    +  // 選択が変わったら(地図・一覧・詳細パネルのどこから変えても)強調と InfoWindow を追従させる
    +  watch(selectedId, onSelectionChange)
     
       function clear() {
         for (const marker of markers.values()) marker.map = null
         markers.clear()
         pointsById.clear()
    +    pins.clear()
    +    highlightedId = null
       }
     
       onScopeDispose(() => {

    PinElement の scale と、マーカーの zIndex(重なり順)を書き換えるだけで、ピンを作り直さずに強調できます。第4回と同じく、きっかけは「選択中の地点IDが変わったこと」だけです。一覧から選んでも地図から選んでも同じ経路で動くので、処理が二重になりません。

    📰 出典:Google Maps Platform「Basic marker customization」

    手順5:ページで組み合わせる

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

    --- a/app/pages/index.vue
    +++ b/app/pages/index.vue
    @@ -2,6 +2,7 @@
     // 第5回: 地図をクリックして仮ピンを立て、フォームから新しい地点を登録する。
     // 第6回: 住所検索(サーバー経由の Geocoding API v4)の候補からも仮ピンを立てられる。
     // 第7回: 施設名検索(Places API (New))で選んだ施設からも仮ピンを立てられる。
    +// 第8回: カテゴリで絞り込み、左の一覧と地図のピンを連動させる。
     import type { Point } from '#shared/types/point'
     import type { GeocodeCandidate } from '#shared/types/geocode'
     import type { PickedPlace } from '~/composables/usePlaces'
    @@ -11,6 +12,7 @@ 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(
    @@ -60,14 +62,32 @@ watch(selectedId, (id) => {
       if (id !== null) clearDraft()
     })
     
    +// 一覧の行を選ぶ → 選択して、そのピンが地図の中央に来るよう移動する
    +function onListSelect(id: number) {
    +  select(id)
    +  const p = points.value.find((x) => x.id === id)
    +  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)) {
    +    clearSelection()
    +  }
    +})
    +
     async function onSaved(point: Point) {
       clearDraft()
    +  // 非表示のカテゴリで登録した場合は、そのカテゴリを表示に戻す
    +  if (!visibleCategories.value.includes(point.category)) {
    +    visibleCategories.value = [...visibleCategories.value, point.category]
    +  }
       await refresh() // 一覧を取り直す → 下の watch でピンが描き直される
       select(point.id) // 登録した地点をそのまま選択状態にする
     }
     
    -// 地図の準備ができた時点と、データが変わった時点でピンを描き直す
    -watch([map, points], ([m, list]) => {
    +// 地図の準備ができた時点と、データ・絞り込みが変わった時点でピンを描き直す
    +watch([map, filteredPoints], ([m, list]) => {
       if (m) render(m, list)
     })
     </script>
    @@ -75,7 +95,12 @@ watch([map, points], ([m, list]) => {
     <template>
       <div class="map-page">
         <div class="map-page__toolbar">
    -      <CategoryLegend :count="points.length" />
    +      <CategoryFilter
    +        v-model="visibleCategories"
    +        :counts="countByCategory"
    +        :shown="filteredPoints.length"
    +        :total="points.length"
    +      />
           <div class="map-page__search">
             <ClientOnly>
               <PlaceSearch :map="map" @pick="onPlacePick" />
    @@ -84,6 +109,7 @@ watch([map, points], ([m, list]) => {
           </div>
         </div>
         <div class="map-page__body">
    +      <PointList :points="filteredPoints" :selected-id="selectedId" @select="onListSelect" />
           <ClientOnly>
             <MapView @ready="onMapReady" @map-click="onMapClick" />
             <template #fallback>

    ピンを描き直す watch の対象を、全件の points から絞り込み後の filteredPoints に変えました。地図の移動(panTo)は一覧から選んだときだけにしています。地図上のピンをクリックしたときは、利用者はすでにその場所を見ているので、地図を動かさないほうが自然です。

    もう1つ、第5回の登録処理にも手を入れました。非表示にしているカテゴリで地点を登録すると、保存後にその地点が見えなくなってしまうため、保存したカテゴリを自動で表示に戻しています。

    一覧と絞り込みは <ClientOnly> の外に置いているので、サーバー側で描画した最初のHTMLにも一覧が入ります。地図の読み込みを待たずに一覧を読める点も、業務で使う画面では地味に効いてきます。

    チェックボックスと一覧のスタイル、一覧・地図・詳細パネルの3列の配置を CSS に足します。画面の幅が 768px 以下のときは、地図 → 詳細 → 一覧の順に縦に並べます。

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

    --- a/app/assets/css/main.css
    +++ b/app/assets/css/main.css
    @@ -389,3 +389,107 @@ body {
       font-size: 12px;
       color: #57606a;
     }
    +
    +/* 第8回: カテゴリ絞り込み + 一覧 */
    +.visually-hidden {
    +  position: absolute;
    +  width: 1px;
    +  height: 1px;
    +  overflow: hidden;
    +  clip-path: inset(50%);
    +  white-space: nowrap;
    +}
    +
    +.category-filter {
    +  display: flex;
    +  flex: 1 1 320px;
    +  flex-wrap: wrap;
    +  align-items: center;
    +  gap: 8px 14px;
    +  margin: 0;
    +  padding: 0;
    +  border: none;
    +  font-size: 14px;
    +}
    +
    +.category-filter__item {
    +  display: flex;
    +  align-items: center;
    +  gap: 4px;
    +  cursor: pointer;
    +}
    +
    +.category-filter__count {
    +  color: #57606a;
    +}
    +
    +.map-page__body {
    +  grid-template-columns: 240px 1fr 300px;
    +}
    +
    +.point-list {
    +  overflow-y: auto;
    +  border: 1px solid #d0d7de;
    +  border-radius: 8px;
    +  background: #fff;
    +}
    +
    +.point-list ul {
    +  margin: 0;
    +  padding: 4px 0;
    +  list-style: none;
    +}
    +
    +.point-list__item {
    +  display: flex;
    +  align-items: center;
    +  gap: 8px;
    +  width: 100%;
    +  padding: 6px 10px;
    +  border: none;
    +  border-left: 3px solid transparent;
    +  background: none;
    +  text-align: left;
    +  font: inherit;
    +  cursor: pointer;
    +}
    +
    +.point-list__item:hover {
    +  background: #f6f8fa;
    +}
    +
    +.point-list__item.is-selected {
    +  border-left-color: #1a73e8;
    +  background: #ddf4ff;
    +  font-weight: 700;
    +}
    +
    +.point-list__name {
    +  overflow: hidden;
    +  text-overflow: ellipsis;
    +  white-space: nowrap;
    +}
    +
    +.point-list__empty {
    +  padding: 12px;
    +  color: #57606a;
    +}
    +
    +@media (max-width: 1024px) {
    +  .map-page__body {
    +    grid-template-columns: 200px 1fr 260px;
    +  }
    +}
    +
    +@media (max-width: 768px) {
    +  .map-page__body {
    +    grid-template-columns: 1fr;
    +    grid-template-rows: minmax(360px, 1fr) auto auto;
    +  }
    +
    +  /* スマホでは 地図 → 詳細 → 一覧 の順に並べる */
    +  .point-list {
    +    order: 3;
    +    max-height: 240px;
    +  }
    +}

    動作確認の方法

    1. npm run dev → http://localhost:3000 を開く。カテゴリごとの件数と「表示 N / 全 M 件」、左の一覧が出ることを確認
    2. 「店舗」のチェックを外す → 店舗のピンと一覧の行が同時に消え、件数が減ることを確認
    3. 一覧の行をクリック → 地図がその地点へ移動し、ピンが大きくなり、InfoWindow と詳細パネルが開くことを確認
    4. 地図で別のピンをクリック → 一覧の該当行が強調され、見える位置までスクロールすることを確認
    5. 選択中の地点のカテゴリのチェックを外す → 選択が解除されることを確認

    筆者の環境では、npm run build と npm run typecheck の成功に加え、ビルド後のサーバーが返すHTMLで、カテゴリごとの件数・全カテゴリにチェックが入った初期状態・「表示 23 / 全 23 件」・一覧の全行が出力されていることを curl で確認しました(件数は検証用に登録した地点を含みます)。チェックボックスの操作による絞り込み、一覧と地図の連動、ピンの強調表示は、執筆環境に本物のAPIキーとブラウザでの操作環境がないため確認できていません。 ご自身のキーを設定して確認してください。

    (追記)第7回の状態からこの記事の手順どおりに進め、Node.js 24 で npm run build・npm run typecheck が通ること、HTMLにカテゴリごとの件数・チェック済みのチェックボックス・「表示 20 / 全 20 件」・一覧の20行が入ることを、あらためて確認しました(追記時はサンプルの20件だけで確認)。

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

    • 絞り込み結果を別の状態としてコピーして持つ:元データの更新と同期が取れなくなります。computed で計算します
    • 一覧と地図で別々に選択状態を持つ:第4回のとおり、選択中のIDは1か所だけにします
    • 絞り込みのたびに全ピンを作り直している:今は20件程度なので問題ありませんが、数千件では重くなります。次回、差分だけ更新する形に変えます
    • 非表示の地点が選択されたまま残る:詳細パネルに見えない地点が出続けるので、絞り込み後に選択を確認して解除します
    • 一覧の行を div とクリックイベントだけで作る:キーボードで操作できなくなります。button を使うと標準で対応できます

    発注者向けメモ

    • 絞り込みや一覧の連動は画面内の処理で、Google の追加API費用は発生しない構造です。費用ではなく、使い勝手と工数のバランスで仕様を決められる部分です
    • 工数を最も左右するのは要件の確定です。一覧に出す項目(名称だけか、住所・担当者・更新日も出すか)、並び順(登録順・名前順・近い順)、絞り込み条件(カテゴリだけか、担当者・期間・状態も必要か)によって作業量が大きく変わります。現場の担当者に「普段どうやって探しているか」を聞いてから決めるのがおすすめです
    • 絞り込み条件を URL に残すかも確認しておきたい点です。「この条件の画面を同僚に送りたい」という要望は後から出やすく、最初から考えておくと手戻りが減ります(本連載では未対応)
    • スマホでの画面構成は別途確認が必要です。3列の画面は狭い画面ではそのまま使えないため、どの情報を優先して見せるかを決めておきましょう

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

    • ☐ 一覧に表示する項目と並び順を決めた
    • ☐ 絞り込みに使う条件(カテゴリ以外も含めて)を洗い出した
    • ☐ スマホで使う場面と、優先して見せる情報を決めた
    • ☐ 将来の地点数の見込み(今と3年後)を伝えた

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

    • 「絞り込みや一覧の表示で、Google のAPI費用が増える操作はありますか?」
    • 「地点が数千件になったとき、一覧と地図の表示速度はどうなりますか?」
    • 「一覧や絞り込みは、キーボードや読み上げソフトでも操作できますか?」

    まとめと次回予告

    この回では、カテゴリのチェックボックスで地点を絞り込み、左の一覧と地図のピンを連動させました。共有する状態は「選択中のID」と「表示カテゴリ」の2つだけにし、絞り込み結果は computed で計算する、強調やスクロールは選択の変化をきっかけに1か所で行う、の2点が押さえどころです。

    次回は「マーカーが数千件でも重くしない:クラスタリングと表示範囲読み込み」です。近くのピンをまとめて表示するクラスタリングと、地図に見えている範囲の地点だけをサーバーから取得する仕組みで、地点が大量にあっても快適に動くようにします。

    この連載の記事一覧

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

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


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

      この記事を書いた人

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

      コメント

      コメント一覧 (2件)

      目次