Google Maps API で自社サイトの店舗検索マップを作る連載の第2回です。前回(第1回)では、APIキーとMap IDを用意して、Nuxt 4 で東京駅を中心にした地図を1枚表示しました。今回はその地図の上に、直営店・取扱店・ショールーム・修理窓口の4つの業態のサンプル店舗20件を、色分けしたピン(マーカー)で表示します。
「地図に店舗のピンを立てるだけなら簡単そうだけど、古いやり方と新しいやり方があると聞いた。どちらで作ればいいの?」
結論として、新しく作るなら Advanced Markers(AdvancedMarkerElement と PinElement)を使います。以前の google.maps.Marker は2024年2月に非推奨になっています。この回では Advanced Markers で業態ごとに色と文字を変えたピンを立て、今後の回で使う「店舗データの型」も決めます。
Google Maps のマーカーは「Advanced Markers」が現在の標準
📰 出典:Google Maps Platform「Deprecations」
公式の非推奨一覧では、google.maps.Marker は Maps JavaScript API のバージョン3.56(2024年2月)で非推奨とされています。執筆時点(2026年11月)では提供終了の予定は発表されておらず、終了する場合は少なくとも12か月前に告知するとされていますが、推奨は AdvancedMarkerElement です。
| 項目 | 旧 Marker | Advanced Markers |
|---|---|---|
| クラス | google.maps.Marker | google.maps.marker.AdvancedMarkerElement |
| 状態 | 非推奨(2024年2月〜) | 推奨 |
| 見た目の変更 | アイコン画像を差し替え | PinElement で色・文字を指定、または任意のHTML |
| Map ID | 不要 | 必須(開発中は DEMO_MAP_ID で可) |
📰 出典:Google Maps Platform「Advanced Markers overview」
Advanced Markers は Map ID が必須です。第1回の MapView.vue で mapId を渡していたのは、この回のためです。
最新の書き方で変わった点
@types/google.maps 3 系の型定義を確認すると、Advanced Markers まわりでもいくつかの書き方が非推奨になっています。古い解説記事のコードをそのまま使うと警告の原因になるので、次の表で押さえておきましょう。
| 古い書き方(非推奨) | 現在の書き方 |
|---|---|
content: pin.element | PinElement 自体が HTML 要素なので marker.append(pin) |
new PinElement({ glyph: '直' }) | glyphText: '直'(画像なら glyphSrc) |
marker.addListener('click', …) | marker.addEventListener('gmp-click', …)(第4回で使用) |
📰 出典:Google Maps Platform「Basic marker customization」
公式のカスタマイズ例も、PinElement を作って marker.append(pin) で付ける形になっています。
店舗の座標は「自社で決めた値」として持つ
コードの前に、店舗データの緯度経度をどこから持ってくるかを決めておきます。これが連載全体の「保存してよいもの・いけないもの」の土台になります。
📰 出典:Google Maps Platform「Service Specific Terms」
Google Maps Platform の Service Specific Terms(2026年11月時点で確認)では、Geocoding API・Places API・Routes API から得た緯度経度は、一時的な保存が最大30日までとされています。筆者の読み方では、この制限がかかるのは「Google の API から取った座標」です。自社で地図を見て決めた座標や、自社の台帳にもともとある座標は、自社のデータとして持ち続けられます。
そこでこの連載では、店舗の緯度経度を次のどちらかで決めます。
- 管理画面で、人が地図をクリックして位置を決める(第5回)
- 自社の店舗台帳にある緯度経度を CSV で取り込む(第11回)
住所から Google の住所変換で座標を自動で作って保存することはしません。今回のサンプル20件も、筆者が東京駅周辺に置いた架空の座標です。規約の最終的な判断は、契約内容と規約本文をもとに法務担当や専門家に確認してください。
実装:店舗データの型とサンプル20件を用意する
この回で追加・変更するファイルは次のとおりです。
| ファイル | 役割 |
|---|---|
app/types/point.ts | 店舗の型と業態の定義(色・表示名)(新規) |
app/data/sample-points.ts | サンプル20店舗(新規。第3回でDBに置き換え) |
app/composables/useMarkers.ts | 店舗データからピンを作る(新規) |
app/components/CategoryLegend.vue | 業態の凡例(新規) |
app/pages/index.vue | 地図の準備ができたらピンを描く(更新) |
app/assets/css/main.css | 凡例のスタイル(更新) |
新しいライブラリは使いません。第1回で入れた @googlemaps/js-api-loader の marker ライブラリを読み込むだけです。
手順1:店舗の型と業態の定義
// app/types/point.ts
// 店舗データの型と業態の定義
// 型の名前は「地図上の点」を表す Point にしている(1件 = 1店舗・1拠点)
export const CATEGORIES = ['direct', 'partner', 'showroom', 'service'] as const
export type Category = (typeof CATEGORIES)[number]
export interface Point {
id: number
name: string
category: Category
// 緯度・経度は自社で決めた値(管理画面で地図をクリックして決める・自社の台帳の値)。
// Google の住所変換や施設検索から取った座標は保存しない
lat: number
lng: number
address: string // 画面に出す住所の表記(自社で管理する文字列)
memo: string
updatedAt: string // ISO 8601
}
// 業態ごとの表示名・ピンの色・ピン内の文字
export const CATEGORY_META: Record<
Category,
{ label: string; color: string; border: string; glyph: string }
> = {
direct: { label: '直営店', color: '#1a73e8', border: '#0b4fb3', glyph: '直' },
partner: { label: '取扱店', color: '#188038', border: '#0d5a26', glyph: '取' },
showroom: { label: 'ショールーム', color: '#e37400', border: '#a35300', glyph: 'S' },
service: { label: '修理窓口', color: '#a142f4', border: '#7127b5', glyph: '修' },
}
型の名前は、コード上は「地図上の点」を表す Point にしています。1件が1店舗です。address は画面に出す住所の表記で、座標とは別に自社で管理する文字列です。住所から座標を作るのではなく、座標と住所の表記をそれぞれ自社のデータとして持つ形にしておくのがポイントです。memo は「年末年始は休業」のような店舗からのお知らせに使います(第4回で表示)。
業態を as const の配列で定義しておくと、型(Category)・凡例の並び順・次回のサーバー側の入力チェックで同じ定義を使い回せます。業態の色と文字を1か所にまとめておけば、「修理窓口の色を変えたい」という要望にも1行の修正で対応できます。
色だけで区別すると、色の見分けがつきにくい方には判別しにくくなります。そのため、ピンの中に「直」「取」などの文字も入れています。
手順2:サンプルデータ
// app/data/sample-points.ts
import type { Point } from '~/types/point'
// 第2回用のサンプル店舗(東京駅周辺・架空のデータ)。第3回で DB に置き換える。
// 緯度・経度は自分で決めた値なので、Google の規約上の保存期間の制限は関係しない
const updatedAt = '2026-08-01T09:00:00+09:00'
export const samplePoints: Point[] = [
{ id: 1, name: '丸の内店', category: 'direct', lat: 35.6812, lng: 139.7644, address: '東京都千代田区丸の内1丁目', memo: '', updatedAt },
{ id: 2, name: '八重洲店', category: 'direct', lat: 35.6795, lng: 139.7702, address: '東京都中央区八重洲1丁目', memo: '', updatedAt },
{ id: 3, name: '日本橋店', category: 'direct', lat: 35.6841, lng: 139.7745, address: '東京都中央区日本橋2丁目', memo: '', updatedAt },
{ id: 4, name: '有楽町店', category: 'direct', lat: 35.6751, lng: 139.7630, address: '東京都千代田区有楽町2丁目', memo: '', updatedAt },
{ id: 5, name: '大手町店', category: 'direct', lat: 35.6865, lng: 139.7660, address: '東京都千代田区大手町1丁目', memo: '', updatedAt },
{ id: 6, name: '京橋 取扱店', category: 'partner', lat: 35.6770, lng: 139.7708, address: '東京都中央区京橋1丁目', memo: '', updatedAt },
{ id: 7, name: '神田駅前 取扱店', category: 'partner', lat: 35.6906, lng: 139.7706, address: '東京都千代田区鍛冶町2丁目', memo: '', updatedAt },
{ id: 8, name: '銀座一丁目 取扱店', category: 'partner', lat: 35.6740, lng: 139.7680, address: '東京都中央区銀座1丁目', memo: '', updatedAt },
{ id: 9, name: '内神田 取扱店', category: 'partner', lat: 35.6895, lng: 139.7672, address: '東京都千代田区内神田3丁目', memo: '', updatedAt },
{ id: 10, name: '宝町 取扱店', category: 'partner', lat: 35.6755, lng: 139.7745, address: '東京都中央区京橋2丁目', memo: '', updatedAt },
{ id: 11, name: '八重洲ショールーム', category: 'showroom', lat: 35.6788, lng: 139.7728, address: '東京都中央区八重洲2丁目', memo: '', updatedAt },
{ id: 12, name: '日本橋本町ショールーム', category: 'showroom', lat: 35.6875, lng: 139.7760, address: '東京都中央区日本橋本町1丁目', memo: '', updatedAt },
{ id: 13, name: '丸の内三丁目ショールーム', category: 'showroom', lat: 35.6772, lng: 139.7625, address: '東京都千代田区丸の内3丁目', memo: '', updatedAt },
{ id: 14, name: '鍛冶町ショールーム', category: 'showroom', lat: 35.6918, lng: 139.7730, address: '東京都千代田区鍛冶町1丁目', memo: '', updatedAt },
{ id: 15, name: '京橋二丁目ショールーム', category: 'showroom', lat: 35.6760, lng: 139.7690, address: '東京都中央区京橋2丁目', memo: '', updatedAt },
{ id: 16, name: '呉服橋 修理窓口', category: 'service', lat: 35.6830, lng: 139.7715, address: '東京都中央区八重洲1丁目', memo: '', updatedAt },
{ id: 17, name: '大手町 修理窓口', category: 'service', lat: 35.6848, lng: 139.7632, address: '東京都千代田区大手町2丁目', memo: '', updatedAt },
{ id: 18, name: '日本橋室町 修理窓口', category: 'service', lat: 35.6860, lng: 139.7730, address: '東京都中央区日本橋室町1丁目', memo: '', updatedAt },
{ id: 19, name: '有楽町 修理窓口', category: 'service', lat: 35.6735, lng: 139.7650, address: '東京都千代田区有楽町1丁目', memo: '', updatedAt },
{ id: 20, name: '八重洲一丁目 修理窓口', category: 'service', lat: 35.6815, lng: 139.7730, address: '東京都中央区八重洲1丁目', memo: '', updatedAt },
]
店舗名・座標・住所は、東京駅周辺に置いた架空のデータです。住所の表記は丁目までにとどめています。今回はファイルに直接書いていますが、次回はこの20件をサーバー側のデータベースに移します。
手順3:ピンを作る composable
// app/composables/useMarkers.ts
import { CATEGORY_META, type Point } from '~/types/point'
/**
* 店舗データから Advanced Marker を作って地図に載せる。
* - マーカーは Vue のリアクティブにせず、プレーンな Map(id → マーカー)で管理する
*/
export function useMarkers() {
const { load } = useGoogleMaps()
const markers = new Map<number, google.maps.marker.AdvancedMarkerElement>()
async function render(map: google.maps.Map, points: Point[]) {
const { AdvancedMarkerElement, PinElement } = await load('marker')
clear()
for (const point of points) {
const meta = CATEGORY_META[point.category]
// 業態の色のピン(PinElement は HTMLElement なのでそのまま子要素にする)
const pin = new PinElement({
background: meta.color,
borderColor: meta.border,
glyphText: meta.glyph,
glyphColor: '#fff',
})
const marker = new AdvancedMarkerElement({
map,
position: { lat: point.lat, lng: point.lng },
title: `${meta.label}: ${point.name}`, // ツールチップ兼スクリーンリーダー用
})
marker.append(pin)
markers.set(point.id, marker)
}
}
function clear() {
for (const marker of markers.values()) marker.map = null
markers.clear()
}
// コンポーネントが破棄されたらマーカーも地図から外す
onScopeDispose(clear)
return { render, clear, markers }
}
ポイントは3つです。
load('marker')で marker ライブラリを読み込みます。第1回のuseGoogleMapsを通すので、キー未設定時のエラー処理も共通です- マーカーは Vue の
refに入れず、プレーンなMap(id → マーカー)で管理します。第1回の地図インスタンスと同じく、Vue の変更監視で重くならないようにするためです。id で引けるようにしておくと、第4回の「クリックした店舗の詳細表示」や第8回の「一覧と地図の連動」でそのまま使えます - マーカーを地図から外すには
marker.map = nullとします。描き直しの前とコンポーネント破棄時に必ず外し、古いピンが残らないようにします
title を指定すると、マウスを重ねたときのツールチップ(「直営店: 丸の内店」)になり、スクリーンリーダー向けの読み上げテキストにもなります。
手順4:ページで地図の準備を待ってから描く
app/pages/index.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -1,9 +1,22 @@
<!-- app/pages/index.vue -->
+<script setup lang="ts">
+import { samplePoints } from '~/data/sample-points'
+
+const { render } = useMarkers()
+
+async function onMapReady(map: google.maps.Map) {
+ await render(map, samplePoints)
+}
+</script>
+
<template>
- <ClientOnly>
- <MapView />
- <template #fallback>
- <div class="map-placeholder">地図を読み込み中…</div>
- </template>
- </ClientOnly>
+ <div class="map-page">
+ <CategoryLegend />
+ <ClientOnly>
+ <MapView @ready="onMapReady" />
+ <template #fallback>
+ <div class="map-placeholder">地図を読み込み中…</div>
+ </template>
+ </ClientOnly>
+ </div>
</template>
第1回の <ClientOnly> 内の <MapView> に @ready="onMapReady" を付け、上に凡例(<CategoryLegend />)を置いています。MapView は地図の作成が終わった時点で ready イベントを出すので、「地図がまだないのにピンを作ろうとする」順序の問題を避けられます。
凡例のコンポーネントは次のとおりです。業態の定義(CATEGORIES と CATEGORY_META)から、ピンと同じ色と文字の見本を並べます。
<!-- app/components/CategoryLegend.vue -->
<script setup lang="ts">
// 第2回: 業態の凡例(ピンの色と文字の見本)
import { CATEGORIES, CATEGORY_META } from '~/types/point'
</script>
<template>
<ul class="legend" aria-label="業態の凡例">
<li v-for="c in CATEGORIES" :key="c">
<span class="legend__dot" :style="{ background: CATEGORY_META[c].color }" aria-hidden="true">
{{ CATEGORY_META[c].glyph }}
</span>
{{ CATEGORY_META[c].label }}
</li>
</ul>
</template>
凡例は <ClientOnly> の外に置いているので、サーバー側で作るHTMLにも入ります。地図が読み込めない環境でも、業態の種類は画面で分かります。
凡例と、ページ全体の並び(凡例の下に地図)のスタイルを CSS に足します。app/assets/css/main.css に次の変更を加えます(+ が追加、- が削除)。
--- a/app/assets/css/main.css
+++ b/app/assets/css/main.css
@@ -85,3 +85,37 @@
background: #e5e3df;
color: #57606a;
}
+
+/* 第2回: 凡例 */
+.map-page {
+ display: grid;
+ grid-template-rows: auto 1fr;
+ gap: 8px;
+ height: 100%;
+}
+
+.legend {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 12px;
+ margin: 0;
+ padding: 0;
+ list-style: none;
+ font-size: 14px;
+}
+
+.legend li {
+ display: flex;
+ align-items: center;
+ gap: 4px;
+}
+
+.legend__dot {
+ display: inline-grid;
+ place-content: center;
+ width: 22px;
+ height: 22px;
+ border-radius: 50%;
+ color: #fff;
+ font-size: 12px;
+}
動作確認の方法
.envにブラウザ用キーを設定し、npm run dev→ http://localhost:3000 を開く- 東京駅周辺に20個のピンが、青(直営店)・緑(取扱店)・オレンジ(ショールーム)・紫(修理窓口)で表示されることを確認
- ピンにマウスを重ねると「直営店: 丸の内店」のようなツールチップが出ることを確認
- DevTools のコンソールに、Map ID が無いことによる警告や、
Markerの非推奨の警告(google.maps.Marker is deprecated)が出ていないことを確認 npm run buildとnpm run typecheckが通ることを確認
筆者の環境(Node.js 24)では、npm run build と npm run typecheck の成功、ビルド後のサーバーが返すHTMLに凡例(直営店・取扱店・ショールーム・修理窓口)が入っていることまでを確認しました。実際のピンの表示とコンソールの警告の有無は、執筆環境に本物のAPIキーがないため確認できていません。ご自身のキーを .env に設定して確認してください。
つまずきやすい点
- Map ID を渡し忘れる:Advanced Markers は Map ID が無いと表示されません。
DEMO_MAP_IDは開発用なので、本番では自分のプロジェクトで Map ID を発行します - 同じ
PinElementを複数のマーカーに使い回す:要素は複製されず「移動」するため、前のマーカーが空になります。ピンはマーカーごとに作ります - 古い解説のコードを混ぜる:
pin.elementやglyph、addListener('click')は型定義上で非推奨です。TypeScript の型チェックを通しておくと、エディタ上で取り消し線や警告として気づけます - 店舗が近すぎてピンが重なる:同じビルドの1階と2階のような店舗は、ピンが重なって片方を押せなくなります。座標を決めるとき(第5回)に少しずらすか、件数が多い場合は第9回のクラスタリング(近いピンをまとめて表示)で対応します
- 件数が多い場合:20件ならこの方法で十分ですが、数千件になると1つずつ地図に載せるのは重くなります。第9回で、表示範囲の店舗だけを読み込む方法とあわせて扱います
発注者向けメモ
- 店舗の座標は「自社で決めた値」として持つと、保存期間の制限を受けない。筆者の読み方では、30日の保存期間の制限がかかるのは Google の API から取った座標です。管理画面で人が地図を見て決めた座標や、自社の台帳の座標は自社のデータとして持ち続けられます。その代わり、店舗ごとに座標を決める作業(人が地図で確かめる手間)が発生するので、店舗数とあわせて見積りや運用の計画に入れてください。最終判断は法務担当や専門家に確認しましょう
- 既存のサイトの改修では「Marker → Advanced Markers 移行」が隠れ工数になりやすい。旧 Marker は今すぐ動かなくなるわけではありませんが、非推奨です。地図部分に触れる改修では、移行を含めるかどうかを確認しておくと後で揉めません
- Map ID の発行は発注者のプロジェクトで。Map ID は Google Cloud のプロジェクトに紐づくため、第1回のキーと同じく発注者名義のプロジェクトで作るのが原則です
- ピンを立てること自体に追加のAPI費用はかからない構造です。地図の費用は主に地図の読み込み回数で決まり、ピンは読み込んだ地図の中で描画されます。ただし「ピンを店舗の写真入りにする」「ブランドのロゴの形にする」といった見た目の要望は、デザインと実装の工数に効いてきます
- 業態の種類と色は、自社の言葉で先に決めておく。後から増減すると、凡例・絞り込み(第8回)・CSV取り込み(第11回)にも影響します
開発会社への確認に使える質問例です。
- 「店舗の緯度経度は、誰がどの方法で決めますか?Google の住所変換の結果をそのまま保存しませんか?」
- 「ピンは Advanced Markers で実装しますか?既存の旧 Marker からの移行は見積りに入っていますか?」
- 「本番用の Map ID は、どのプロジェクトで誰が発行しますか?」
- 「色の見分けがつきにくい来訪者にも区別できるよう、ピンに文字やアイコンを入れられますか?」
まとめと次回予告
この回では、非推奨の旧 Marker ではなく Advanced Markers を使い、業態ごとに色と文字を変えた店舗のピンを20件表示しました。PinElement は marker.append(pin) で付ける、文字は glyphText で指定する、マーカーは Vue のリアクティブにせず id で引ける Map で管理する、の3点が押さえどころです。あわせて、店舗の座標は Google から取らず自社で決めた値として持つ、という連載全体の方針を型に込めました。
次回は「店舗データをNuxt server API + SQLiteに保存する」です。今回ファイルに直接書いたサンプル店舗を、Nuxt のサーバーAPIとSQLiteに移し、登録・更新・削除ができる土台を作ります。Google マップ上の同じ店舗と結びつけるための place_id の列も、ここで用意します。続きは次回(第3回)をご覧ください。
この連載の記事一覧
この記事は連載「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件)
[…] Maps API とNuxtで社内向けの情報集約マップを作る連載の第3回です。前回(第2回)では、ファイルに直書きしたサンプル20地点を、Advanced Markers […]
[…] 次回は「Advanced Markersで業態ごとに色分けした店舗のピンを立てる」です。直営店・取扱店・ショールーム・修理窓口の4つの業態のサンプル店舗20件を、非推奨になった旧 Marker ではなく Advanced Markers で色分け表示します。続きは次回(第2回)をご覧ください。 […]