自社サイトに「近くの店舗を探す」ページを付けたい。住所や駅名、現在地から近い店舗を地図で示し、営業時間や道順まで分かるようにしたい。そんな店舗検索マップ(ストアロケーター)を、Google Maps API(Google Maps Platform)とNuxtで1回1機能ずつ作っていく連載を始めます。
「自社サイトにGoogleマップの店舗検索を付けたいけれど、APIキーや料金、規約の決まりがよく分からない。まず何から始めればいいの?」
結論から言うと、最初にやることは3つだけです。Google Cloud のプロジェクトと請求先を発注者の名義で用意し、制限付きのAPIキーを発行して、Nuxtから地図を1枚表示する。この回では連載の見取り図を紹介したうえで、この「地図1枚」までを動くコード付きで解説します。
連載「NuxtとGoogle Mapsで作る店舗検索マップ」の全体像
最終的には、そのまま試作(PoC=本格導入前の小さな検証)に使えるサンプル一式ができあがります。
完成するもの:来訪者の画面と管理画面
| 画面 | URL | できること |
|---|---|---|
| 来訪者の画面 | / | 住所・駅名・現在地から近い店舗を探す、業態で絞り込む、近い順の一覧、営業時間と評価の表示、徒歩・車の所要時間、Google マップでの経路案内 |
| 管理画面 | /admin | 地図をクリックして店舗の位置を決める、Google マップ上の同じ店舗と結びつける、CSVで店舗台帳を取り込む(本番ではパスワードで保護) |
業態は「直営店・取扱店・ショールーム・修理窓口」の4種類を例にします。店舗名や座標はすべて架空のサンプルです。
保存するもの・保存しないもの
この連載がいちばん大切にしているのが「Google から取ったデータのうち、保存してよいもの・いけないもの」の線引きです。
📰 出典:Google Maps Platform「Service Specific Terms」
Google Maps Platform の Service Specific Terms(サービスごとの利用規約。2026年11月時点で確認)では、Geocoding API(住所→緯度経度)・Places API(施設の情報)・Routes API(経路)から得た緯度経度は、一時的な保存が最大30日までとされています。一方で、場所を表す ID(place_id)は期限なく保存してよいとされています。筆者はこれを次のように設計に落としました。
| データ | 扱い | 理由 |
|---|---|---|
| 店舗名・業態・住所の表記・お知らせ | 保存する | 自社のデータ |
| 店舗の緯度経度 | 保存する | 管理画面で人が地図をクリックして決めた値、または自社の台帳の値(Google から取った座標ではない) |
| place_id | 保存する | 期限なく保存してよいとされる Google の値 |
| 来訪者が入れた住所・駅名・現在地 | 保存しない | その検索の起点にだけ使う |
| 営業時間・評価 | 保存しない | place_id を使って、その場で Google から取得して表示する |
| 所要時間 | 保存しない | その場で計算して表示する |
規約の読み方はあくまで筆者の解釈です。実際のサービスに当てはめるときは、契約内容と規約本文をもとに、法務担当や専門家に確認してください。なお、請求先が欧州経済領域(EEA)にある場合は別の規約が適用されます。
なぜ Google の地図を使うのか
店舗検索で Google を選ぶ理由は、来訪者がふだん使っている Google マップとつながる機能が多いからです。
- place_id で Google マップ上の同じ店舗と結びつけ、営業時間・評価を自社で二重に管理せずに表示できる(第7回)
- 「経路を見る」のリンクから、来訪者のスマートフォンの Google マップで道順を開ける(第4回)
- 起点から店舗までの徒歩・車の所要時間を出せる(第10回)
逆に、座標を台帳として持ち続けることが中心のアプリ(配送先や顧客台帳など)は保存期間の決まりとぶつかりやすく、別の地図サービスの構成が合う場合もあります。
想定読者
| 読者 | この連載で得られること |
|---|---|
| 発注側の社内エンジニア・Web 担当 | 小さく自作する、または外注先の成果物をレビューできるようになる |
| Vue/Nuxt経験のあるフロントエンド開発者 | Google Maps Platform の最新の作法(Advanced Markers、Places API (New)、Routes API、新しい料金体系)を押さえる |
| 技術に関心のある発注者(Web 担当・店舗運営の部門) | 機能ごとの工数感・API費用の発生の仕方・リスクを掴み、見積りや要件定義の会話ができる |
使う技術と、Google の API・キーの分け方
- Nuxt 4(Vue 3 + TypeScript + Composition API)
- @googlemaps/js-api-loader 2(Google 公式の読み込みライブラリ)
- データ保存は SQLite(Node.js 24 組み込みの node:sqlite)。本番では PostgreSQL などに差し替える前提
地図の描画はブラウザだけで行い、サーバー側(Nuxt の server API)は店舗データの保存と、秘密にすべきキーを使う処理を担当します。
| API | 用途 | 使う回 | キー | 料金区分の目安 |
|---|---|---|---|---|
| Maps JavaScript API | 地図・ピン・InfoWindow の表示 | 1〜 | ブラウザ用 | 地図の読み込みは Essentials |
| Places API (New) | 管理画面で Google マップ上の店舗を選ぶ/来訪者に営業時間・評価を出す | 7 | ブラウザ用 | 取得する項目で決まる(営業時間・評価は Enterprise) |
| Geocoding API | 来訪者が入れた住所・駅名を検索の起点にする | 6 | サーバー用 | Essentials |
| Routes API | 起点から近い店舗までの所要時間 | 10 | サーバー用 | 基本は Essentials(交通状況を考慮すると Pro) |
ブラウザ用キーは見える前提で制限をかけて守り、サーバー用キーは別に発行してブラウザに出しません。Google マップで経路を開くリンク・ブラウザの現在地・直線距離の計算は、キー不要で課金もありません。
全12回の流れ
| 回 | タイトル |
|---|---|
| 第1回 | APIキーとMap IDを用意して、Nuxt 4で地図を1枚表示する(この記事) |
| 第2回 | Advanced Markersで業態ごとに色分けした店舗のピンを立てる |
| 第3回 | 店舗データをNuxt server API + SQLiteに保存する |
| 第4回 | ピンをクリックしてInfoWindowと店舗の詳細パネルを出す |
| 第5回 | 管理画面で地図をクリックして店舗の位置を決める |
| 第6回 | 来訪者が入れた住所・駅名から近い店舗を探す(Geocoding API v4をサーバー経由で) |
| 第7回 | Places API (New)で店舗をGoogleマップの情報と結びつけ、営業時間と評価を出す |
| 第8回 | 業態で絞り込み、店舗一覧と地図を連動させる |
| 第9回 | 店舗が数千件でも重くしない:クラスタリングと表示範囲読み込み |
| 第10回 | 現在地から半径◯km以内の店舗を探し、徒歩・車の所要時間を出す(Routes API) |
| 第11回 | CSVで既存の店舗台帳を一括取り込みする |
| 第12回 | 本番公開前チェック:APIキー制限・クォータ・予算アラート・管理画面の保護 |
各回の記事には「発注者向けメモ」として、その機能を開発会社に頼むときの確認点や、工数・API費用が増える条件をまとめます(金額は改定が多いため書かず、費用が発生する「仕組み」を説明します)。
Google Maps APIで地図を表示する仕組み
コードの前に、登場する用語を整理しておきます。
| 用語 | 意味 |
|---|---|
| Google Cloud プロジェクト | APIの利用・課金・キーをまとめる「入れ物」 |
| 請求先アカウント | 利用料の支払い元。Maps JavaScript API の利用には請求先の設定が必要 |
| APIキー | 「どのプロジェクトの利用か」を示す文字列。ブラウザで使うキーは利用者から見える前提で扱う |
| Map ID | 地図の設定(スタイルなど)を識別するID。第2回で使う Advanced Markers に必須。開発中は DEMO_MAP_ID で代用できる |
| マップロード | 地図を1回読み込むこと。地図表示(Dynamic Maps)はこの単位で課金される |
📰 出典:Google Maps Platform「Maps JavaScript API Usage and Billing」
公式の料金説明では、地図の読み込み(map load)は Dynamic Maps という料金項目(SKU)で、区分は Essentials とされています。店舗検索は誰でも開ける公開ページなので、費用は来訪者の数に比例して増えます。
📰 出典:Google Maps Platform「March 2025 changes」
2025年3月の料金体系の変更で、以前の「毎月200ドル分の無料クレジット」は、料金項目ごとの月間無料枠に置き換わりました。具体的な単価や無料枠は公式の料金ページで確認してください(2026年11月時点)。
Google Cloudでの準備(APIキーとMap ID)
Cloud コンソールで次の順に準備します(画面の文言は執筆時点・2026年11月のもの)。
- プロジェクトを作成し、請求先アカウントを紐づける
- 「APIとサービス」で Maps JavaScript API を有効にする(Places API (New)・Geocoding API・Routes API は使う回で有効にします)
- 「認証情報」で APIキーを作成し、すぐに制限を設定する
- アプリケーションの制限:ウェブサイト(HTTPリファラー)。開発中は
http://localhost:3000/*を登録 - APIの制限:Maps JavaScript API のみに絞る(第7回で Places API (New) を足します)
- Map ID は、開発中は
DEMO_MAP_IDのままで構いません。本番では「Map Management(マップ管理)」画面で JavaScript 用の Map ID を作成します
📰 出典:Google Maps Platform「API security best practices」
ブラウザで使うキーは、画面のソースを見れば誰でも読めます。「隠す」のではなく、リファラー制限とAPI制限で「このサイトから、この用途にしか使えない」ようにするのが公式の考え方です。
📰 出典:Google Maps Platform「Use Map IDs」
実装:Nuxt 4で地図を1枚表示する
空のフォルダから、Nuxt 4 のプロジェクトを作るところから始めます。この回で作る・変更するファイルは次のとおりです。
| ファイル | 役割 |
|---|---|
package.json | 部品(パッケージ)の追加と、型チェックのコマンド |
nuxt.config.ts | CSS の読み込み・ページの言語とタイトル・APIキーの受け口(runtimeConfig) |
.env.example | 環境変数(APIキー)のひな形 |
.gitignore | キーを書く .env などを Git に入れない |
app/plugins/google-maps.client.ts | Maps JavaScript API の読み込み設定(1回だけ) |
app/composables/useGoogleMaps.ts | ライブラリの読み込みとエラー状態をまとめる |
app/types/google-maps.d.ts | google.maps.* の型を有効にする |
app/components/MapView.vue | 地図を表示するコンポーネント |
app/pages/index.vue | <ClientOnly> で地図を配置する |
app/app.vue / app/layouts/default.vue | ページの枠とヘッダー |
app/assets/css/main.css | 画面全体と地図の高さのスタイル |
手順0:Nuxt 4 のプロジェクトを作る
この連載のコードは Node.js 24(npm 11 が付属)で動作を確認しています。第3回で使うデータベース(Node.js 組み込みの SQLite)のため、Node.js は 24 以上を使ってください。node -v で版を確認できます。
Nuxt 公式のひな形から、最小構成(minimal)のプロジェクトを作ります。
npm create nuxt@latest gmap-shuyaku -- --template minimal --packageManager npm --gitInit
cd gmap-shuyaku
- 途中で公式モジュールを入れるか聞かれたら、何も選ばずに進めます(この連載では使いません)
package.json・nuxt.config.ts・tsconfig.json・app/app.vue・public/・.gitignoreが自動で作られ、部品のインストールまで行われます- ひな形の中身は作った時期の Nuxt の版で少し変わることがあるため、この記事では変更するファイルの中身を全文で示します
手順1:ライブラリを追加する
npm install @googlemaps/js-api-loader@2 --ignore-scripts
npm install -D @types/google.maps@3 typescript@~6.0.3 vue-tsc@3 --ignore-scripts
npm pkg set engines.node=">=24" scripts.typecheck="nuxt typecheck"
npx nuxt prepare
--ignore-scripts は、インストール時に自動で動くスクリプトを止める指定です(不正なスクリプトへの備え)。そのぶん、Nuxt の準備の nuxt prepare は最後に手で実行します。
@googlemaps/js-api-loader は Google 公式の読み込みライブラリで、バージョン2では setOptions() と importLibrary() の2つの関数だけを使います(旧バージョンの Loader クラスは非推奨)。コミュニティ製のVueラッパー(vue3-google-map)もありますが、この連載は公式ドキュメントのサンプルとそのまま対応が取れること、数千件のピンを細かく制御することを重視して、公式ローダーを薄い composable で包む方針にしました。
📰 出典:@googlemaps/js-api-loader(npm)
2行目は型の定義と、型チェックに使う TypeScript・vue-tsc です。TypeScript 7 系は vue-tsc との組み合わせを確認していないため、6.0 系に固定しています。3行目の npm pkg set で、必要な Node.js の版と npm run typecheck の定義を package.json に足しています。
この時点の package.json は次のようになります。キーの並び順は違っていても構いません。版の数字は執筆時点のもので、npm create の時期によってはもう少し新しい版が入ります。
{
"name": "gmap-shuyaku",
"private": true,
"type": "module",
"engines": {
"node": ">=24"
},
"scripts": {
"dev": "nuxt dev",
"build": "nuxt build",
"preview": "nuxt preview",
"generate": "nuxt generate",
"typecheck": "nuxt typecheck",
"postinstall": "nuxt prepare"
},
"dependencies": {
"@googlemaps/js-api-loader": "^2.1.3",
"nuxt": "^4.5.2",
"vue": "^3.5.43",
"vue-router": "^5.2.0"
},
"devDependencies": {
"@types/google.maps": "^3.66.4",
"typescript": "~6.0.3",
"vue-tsc": "^3.3.11"
}
}
tsconfig.json はひな形のまま変更しません。Nuxt が .nuxt/ の中に作る設定を参照する形になっていることを確認しておきます。
{
// https://nuxt.com/docs/guide/concepts/typescript
"files": [],
"references": [
{ "path": "./.nuxt/tsconfig.app.json" },
{ "path": "./.nuxt/tsconfig.server.json" },
{ "path": "./.nuxt/tsconfig.shared.json" },
{ "path": "./.nuxt/tsconfig.node.json" }
]
}
手順2:キーは runtimeConfig と .env で渡す
nuxt.config.ts では、キーの既定値を空文字にしておき、値は環境変数で上書きします。ソースコードにキーを書かないためです。あわせて、このあと作る CSS の読み込みと、ページの言語(日本語)・タイトルの設定も入れます。
nuxt.config.ts を次の内容に置き換えます。
// https://nuxt.com/docs/api/configuration/nuxt-config
export default defineNuxtConfig({
compatibilityDate: '2026-09-27',
devtools: { enabled: true },
css: ['~/assets/css/main.css'],
app: {
head: {
htmlAttrs: { lang: 'ja' },
title: '店舗検索マップ(サンプル)',
meta: [{ name: 'viewport', content: 'width=device-width, initial-scale=1' }],
},
},
// APIキーはソースに書かず、環境変数で上書きする。
// NUXT_PUBLIC_GOOGLE_MAPS_API_KEY -> runtimeConfig.public.googleMapsApiKey
// NUXT_PUBLIC_GOOGLE_MAPS_MAP_ID -> runtimeConfig.public.googleMapsMapId
// NUXT_GOOGLE_MAPS_SERVER_KEY -> runtimeConfig.googleMapsServerKey(サーバー専用)
runtimeConfig: {
googleMapsServerKey: '',
public: {
googleMapsApiKey: '',
googleMapsMapId: 'DEMO_MAP_ID',
},
},
typescript: {
strict: true,
},
})
runtimeConfig の public の中の値はブラウザにも渡り、外に書いた googleMapsServerKey はサーバーの中だけで使えます。2つのキーの置き場所を、最初からここで分けておきます。
環境変数のひな形 .env.example を作ります。値は空のままにしておく、Git に入れてよいファイルです。サーバー用キーは第6回から使いますが、置き場所だけ先に用意しておきます。
# .env.example
# コピーして .env を作成し、値を設定してください(.env はコミットしない)
# cp .env.example .env
#
# ブラウザ用キー(Maps JavaScript API 用)。
# Google Cloud コンソールで「ウェブサイト(HTTP リファラー)」制限と API 制限を必ず設定する。
# runtimeConfig.public.googleMapsApiKey に対応
NUXT_PUBLIC_GOOGLE_MAPS_API_KEY=
# Map ID(Advanced Markers に必須。開発中は DEMO_MAP_ID でも可)
# runtimeConfig.public.googleMapsMapId に対応
NUXT_PUBLIC_GOOGLE_MAPS_MAP_ID=DEMO_MAP_ID
# サーバー用キー(第6回: Geocoding API v4、第10回: Routes API をサーバーから呼ぶ場合に使用)。
# ブラウザ用キーとは別に発行し、API 制限(+可能なら IP アドレス制限)を設定する。
# runtimeConfig.googleMapsServerKey に対応(クライアントには公開されない)
NUXT_GOOGLE_MAPS_SERVER_KEY=
.gitignore を次の内容に置き換えます。ひな形にも .env は入っていますが、キーを含むファイルであることをコメントで明記しておきます。
# Nuxt build output
.output
.data
.nuxt
.nitro
.cache
dist
# Dependencies
node_modules
# Logs
logs
*.log
# Misc
.DS_Store
.fleet
.idea
# Local env files (APIキーを含むため絶対にコミットしない)
.env
.env.*
!.env.example
.env.example をコピーして .env を作り、発行したキーを設定します。.env は Git に入りません。
cp .env.example .env
# .env の NUXT_PUBLIC_GOOGLE_MAPS_API_KEY= に自分のブラウザ用キーを設定
📰 出典:Nuxt「Runtime Config」
注意点として、npm run dev では .env が読まれますが、ビルド後の本番サーバー(node .output/server/index.mjs)では .env は読まれません。本番では実行環境の環境変数として渡します(第12回で詳しく扱います)。
手順3:読み込み設定はプラグインで1回だけ
// app/plugins/google-maps.client.ts
import { setOptions } from '@googlemaps/js-api-loader'
// Maps JavaScript API の読み込み設定。setOptions() はアプリ全体で1回だけ呼ぶ
// (2回目以降は無視され、コンソールに警告が出る仕様)。
// ファイル名の .client により、このプラグインはブラウザでのみ実行される。
export default defineNuxtPlugin(() => {
const config = useRuntimeConfig()
const apiKey = config.public.googleMapsApiKey
// キー未設定なら読み込み設定をしない(useGoogleMaps 側で画面にエラーを出す)
if (!apiKey) return
setOptions({
key: apiKey,
v: 'weekly',
language: 'ja',
region: 'JP',
})
// キーの無効・リファラー制限違反などの認証エラー時に Google が呼ぶグローバル関数
window.gm_authFailure = () => {
useState<boolean>('gmaps-auth-failed').value = true
}
})
declare global {
interface Window {
gm_authFailure?: () => void
}
}
setOptions() はアプリ全体で1回だけ呼ぶ設計です。gm_authFailure は、認証に失敗したときに Maps JavaScript API が呼び出すグローバル関数で、公式ドキュメントで案内されている検知方法です。最後の declare global は、window.gm_authFailure を TypeScript に知らせる型の宣言で、これがないと型チェックでエラーになります。
📰 出典:Google Maps Platform「Events – Listen for authentication errors」
手順4:composableで読み込みとエラー状態をまとめる
// app/composables/useGoogleMaps.ts
import { importLibrary } from '@googlemaps/js-api-loader'
type LibraryName = keyof google.maps.ImportLibraryMap
/**
* Maps JavaScript API のライブラリを読み込む薄いラッパー。
* - キー未設定・認証エラーを画面に出せるよう、状態をまとめて返す
* - importLibrary() は同じライブラリなら同じ Promise を返すので、何度呼んでもよい
*/
export function useGoogleMaps() {
const config = useRuntimeConfig()
const isConfigured = computed(() => config.public.googleMapsApiKey.length > 0)
const mapId = config.public.googleMapsMapId || 'DEMO_MAP_ID'
// plugins/google-maps.client.ts の gm_authFailure から true にされる
const authFailed = useState<boolean>('gmaps-auth-failed', () => false)
async function load<T extends LibraryName>(name: T) {
if (!isConfigured.value) {
throw new Error('NUXT_PUBLIC_GOOGLE_MAPS_API_KEY が未設定です(.env を確認してください)')
}
return importLibrary(name)
}
return { isConfigured, mapId, authFailed, load }
}
composable(コンポーザブル)は、Vue で処理と状態をまとめて使い回すための関数です。同じライブラリなら何度呼んでも同じ結果が返るので、今後の回でピン(marker)や場所の情報(places)を使うときも、この load() を呼ぶだけです。
google.maps.* の型を使うため、次の1行だけのファイルを置きます。これがないと nuxt typecheck で「namespace ‘google’ が見つからない」エラーになります。
// app/types/google-maps.d.ts
// @types/google.maps の型(google.maps.*)をアプリ全体で使えるようにする
/// <reference types="google.maps" />
手順5:地図を表示するコンポーネント
<!-- app/components/MapView.vue -->
<script setup lang="ts">
// 地図を1枚表示するコンポーネント。ブラウザ専用なので <ClientOnly> の中で使う。
const props = withDefaults(
defineProps<{ center?: google.maps.LatLngLiteral; zoom?: number }>(),
{
center: () => ({ lat: 35.681236, lng: 139.767125 }), // 東京駅
zoom: 15,
},
)
const emit = defineEmits<{
ready: [map: google.maps.Map]
}>()
const { isConfigured, mapId, authFailed, load } = useGoogleMaps()
const mapEl = ref<HTMLDivElement | null>(null)
// 地図インスタンスは shallowRef で持つ(ref だと Vue が内部を深く監視して重くなる)
const map = shallowRef<google.maps.Map | null>(null)
const loadError = ref<string | null>(null)
onMounted(async () => {
if (!isConfigured.value || !mapEl.value) return
try {
const { Map } = await load('maps')
map.value = new Map(mapEl.value, {
center: props.center,
zoom: props.zoom,
mapId, // Advanced Markers(第2回)に必須
gestureHandling: 'greedy',
clickableIcons: false,
})
emit('ready', map.value)
} catch (e) {
loadError.value = e instanceof Error ? e.message : String(e)
}
})
defineExpose({ map })
</script>
<template>
<div class="map-view">
<div ref="mapEl" class="map-view__canvas" />
<p v-if="!isConfigured" class="map-view__error">
ブラウザ用APIキーが未設定です。<code>.env</code> の
<code>NUXT_PUBLIC_GOOGLE_MAPS_API_KEY</code> を設定して再起動してください。
</p>
<p v-else-if="authFailed" class="map-view__error">
Google Maps の認証に失敗しました。キーの値・HTTPリファラー制限・API制限・請求先アカウントを確認してください(詳細はブラウザのコンソール)。
</p>
<p v-else-if="loadError" class="map-view__error">
地図の読み込みに失敗しました: {{ loadError }}
</p>
</div>
</template>
地図の上に「キー未設定」「認証エラー」「読み込み失敗」のメッセージを重ねて、地図が真っ白なときに何を直せばいいかを画面に出すのがポイントです。地図のインスタンスを shallowRef で持つのは、Vue が地図の内部まで変更を監視して重くなるのを避けるためです。clickableIcons: false は、Google の地図に最初から出ている施設のアイコンを押せなくする指定で、自社の店舗のピンと混同されないようにしています。
手順6:ページに ClientOnly で地図を置く
<!-- app/pages/index.vue -->
<template>
<ClientOnly>
<MapView />
<template #fallback>
<div class="map-placeholder">地図を読み込み中…</div>
</template>
</ClientOnly>
</template>
Nuxt はサーバー側でHTMLを作ってから(SSR)ブラウザに送ります。地図はブラウザにしか描けないため、<ClientOnly> で囲み、サーバー側では「読み込み中」の枠だけを返します。
手順7:画面の枠とスタイルを用意する
ひな形の app/app.vue は Nuxt の歓迎画面を出すだけなので、レイアウトとページを表示する形に変えます。app/app.vue を次の内容に置き換えます。
<template>
<NuxtLayout>
<NuxtPage />
</NuxtLayout>
</template>
ヘッダーと本文の枠になるレイアウトを作ります。管理画面へのナビゲーションは第5回で足します。
<!-- app/layouts/default.vue -->
<template>
<div class="layout">
<header class="layout__header">
<NuxtLink to="/" class="layout__brand">店舗検索マップ</NuxtLink>
<span class="layout__sub">Nuxt + Google Maps Platform サンプル</span>
</header>
<main class="layout__main">
<slot />
</main>
</div>
</template>
スタイルは1つの CSS ファイルにまとめます。地図を描く div には高さが必要で、高さがないとキーが正しくても地図が見えません(.map-view の min-height)。次回以降は、この CSS に回ごとのスタイルを書き足します。
app/assets/css/main.css の全文(87行)
/* app/assets/css/main.css */
*,
*::before,
*::after {
box-sizing: border-box;
}
html,
body {
margin: 0;
height: 100%;
font-family: system-ui, -apple-system, 'Hiragino Sans', 'Noto Sans JP', sans-serif;
color: #1f2328;
background: #f6f8fa;
}
#__nuxt {
height: 100%;
}
.layout {
display: grid;
grid-template-rows: auto 1fr;
height: 100%;
}
.layout__header {
display: flex;
align-items: baseline;
gap: 12px;
padding: 10px 16px;
background: #fff;
border-bottom: 1px solid #d0d7de;
}
.layout__brand {
font-weight: 700;
color: inherit;
text-decoration: none;
}
.layout__sub {
font-size: 12px;
color: #57606a;
}
.layout__main {
min-height: 0;
padding: 16px;
}
/* 第1回: 地図 */
.map-view {
position: relative;
height: 100%;
min-height: 360px;
}
.map-view__canvas {
position: absolute;
inset: 0;
border-radius: 8px;
background: #e5e3df;
}
.map-view__error {
position: absolute;
top: 12px;
left: 12px;
right: 12px;
margin: 0;
padding: 10px 12px;
border: 1px solid #cf222e;
border-radius: 6px;
color: #cf222e;
background: #fff;
}
.map-placeholder {
display: grid;
place-content: center;
height: 100%;
min-height: 360px;
border-radius: 8px;
background: #e5e3df;
color: #57606a;
}
動作確認の方法
.envにブラウザ用キーを設定し、npm run dev→ http://localhost:3000 を開く- 東京駅を中心に地図が表示され、DevTools のコンソールに
InvalidKeyMapErrorやRefererNotAllowedMapErrorなどのエラーが出ていないことを確認 .envのキーを空にして再起動すると、地図の代わりに「ブラウザ用APIキーが未設定です」と表示されることを確認npm run buildとnpm run typecheckが通ることを確認
筆者の環境(Node.js 24)では、npm run build と npm run typecheck の成功、ビルド後のサーバーが返すHTMLに「地図を読み込み中…」の枠が入ること、ブラウザに渡る設定値にサーバー用キーが含まれないこと(ダミーの値で確認)までを確かめています。実際の地図の描画は、執筆環境に本物のAPIキーがないため確認できていません。ダミーのキーでは、画面に「認証に失敗しました」と表示されるところまでを確認しました。ご自身のキーを .env に設定して確認してください。
📰 出典:Google Maps Platform「Error Messages」
よく出るエラーと原因は次のとおりです。
| エラー | 主な原因 |
|---|---|
ApiNotActivatedMapError | プロジェクトで Maps JavaScript API が有効になっていない |
InvalidKeyMapError | キーの値が間違っている |
RefererNotAllowedMapError | 開いているURLがキーのリファラー制限に登録されていない(localhost:3000 と 127.0.0.1:3000 は別扱い) |
BillingNotEnabledMapError | プロジェクトに請求先が設定されていない |
ApiTargetBlockedMapError | キーのAPI制限で Maps JavaScript API が許可されていない |
地図が暗くなり「for development purposes only」と表示される場合も、キーか請求先の設定に問題があるサインです。
つまずきやすい点・セキュリティ上の注意
- キーを制限なしのまま放置しない。発行した直後に、リファラー制限とAPI制限を設定します。制限のないキーが他のサイトに流用されると、その費用は自社に請求されます
- キーをコミットしない。スクリーンショットや記事にもキーの値を載せないため、サンプルの画面はキーの「有無」だけを表示しています
- ブラウザ用キーとサーバー用キーを分ける。ブラウザ用キーは公開される前提なので、住所変換や所要時間の計算に流用しません(第6回・第10回)
- 予算アラートを先に設定する。Cloud コンソールの「お支払い」で予算とアラートを設定し、API ごとの上限(クォータ)も確認しておくと、想定外の利用に早く気づけます(第12回で総点検します)
- 地図の Google のロゴや著作権の表示を、CSS で隠さない。デザインの都合で消したくなりますが、規約で表示が求められています
発注者向けメモ
店舗検索マップを開発会社に頼むときに、最初に決めておきたいことです。
- Google Cloud のプロジェクト・請求先・APIキーは、原則として発注者の名義で作る。開発会社や担当者個人のアカウントで作ると、契約終了や退職のときにキーを止められない・請求を引き継げない、といった事態になりがちです。開発会社には「発注者のプロジェクトに権限を付与して作業してもらう」形を相談しましょう
- 地図の費用は「表示回数(マップロード)」で決まり、店舗検索は来訪者の数に比例して増えます。サイト全体の月間の訪問者数と、そのうち店舗検索ページを開く割合の見込みを、見積り前に伝えてください
- 「Google から取ったデータを保存しない」設計を要件に入れる。後から変えると作り直しになりやすく、規約の解釈が関わるので発注者側の法務担当にも確認してもらうと安心です
- キー制限・予算アラートが「作業項目」として見積りに入っているかを確認します。後回しにされやすいですが、漏えい時の被害を小さくする重要な設定です
開発会社への確認に使える質問例です。
- 「Google Cloud のプロジェクトと請求先は、どちらの名義で作る想定ですか?」
- 「ブラウザ用とサーバー用のAPIキーは分けますか?それぞれにどのような制限を設定しますか?」
- 「Google の API から取ったデータのうち、データベースに保存するものはありますか?」
- 「予算アラートとAPIごとの利用上限は、誰がどの値で設定しますか?」
まとめと次回予告
この回では、店舗検索マップの全体像(来訪者の画面と管理画面、保存するもの・しないもの、使う API とキーの分け方)と、Google Cloud でのキー・Map ID の準備、Nuxt 4 で地図を1枚表示するまでを解説しました。ポイントは、読み込み設定を1か所(クライアント専用プラグイン)にまとめること、キーは runtimeConfig と .env で扱いコードに書かないこと、エラーを画面に出して原因を分かりやすくすることの3つです。
次回は「Advanced Markersで業態ごとに色分けした店舗のピンを立てる」です。直営店・取扱店・ショールーム・修理窓口の4つの業態のサンプル店舗20件を、非推奨になった旧 Marker ではなく Advanced Markers で色分け表示します。続きは次回(第2回)をご覧ください。
この連載の記事一覧
この記事は連載「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キー制限・クォータ・予算アラート・管理画面の保護










コメント
コメント一覧 (4件)
[…] Maps API で社内向けの情報集約マップを作る連載の第2回です。前回(第1回)では、APIキーとMap IDを用意して、Nuxt 4 […]
[…] APIキーとMap IDを用意して、Nuxt 4で地図を1枚表示する […]
[…] 【NuxtとGoogle Mapsで作る店舗検索マップ 第1回】APIキーとMap IDを用意して、Nu… […]
[…] 【NuxtとGoogle Mapsで作る店舗検索マップ 第1回】APIキーとMap IDを用意して、Nu… […]