Google Maps API とNuxtで自社サイトの店舗検索マップを作る連載の第6回です。前回(第5回)では、管理画面で地図をクリックして店舗の位置を決め、登録できるようにしました。今回は来訪者の画面に戻り、住所や駅名を入れると、いちばん近い店舗を選んで見せる機能を作ります。住所を緯度経度(座標)に変換するのは Google の Geocoding API(ジオコーディング=住所を座標に変換するAPI)の v4 で、Nuxt のサーバーから呼ぶ構成にします。
「住所から位置を出すなら、ブラウザから直接 Google に聞けば早いのでは?それに、一度調べた住所の座標は保存しておけば次から速くならない?」
結論から言うと、サーバーを通すのはAPIキーを来訪者の目に触れさせないためで、変換結果を保存しないのは規約の保存期間(30日)の問題をそもそも生まないためです。ブラウザで使うキーは、画面を開いた人なら誰でも見られます。1回ごとに課金される住所変換のキーは別に発行し、サーバーの中だけで使います。変換した座標は「近い店舗を探す起点」に使うだけで、DB にもブラウザにも残しません。
この回で作るもの:住所・駅名からいちばん近い店舗を選ぶ
| 操作 | 画面の動き |
|---|---|
| 上部の欄に住所や駅名を入れて「近くの店舗を探す」 | 候補の住所が一覧で出る(精度も表示) |
| 候補をクリック | 地図に青い丸(起点)が出て、いちばん近い店舗が選ばれる。地図は起点と店舗が両方入る範囲に動く |
| 詳細パネルを見る | 住所・お知らせに加えて「起点から 直線で約 250m」が出る |
| 「起点を消す」 | 青い丸と距離の表示が消える |
| 近くに店舗が無い・見つからない住所 | 「近く(約50km 以内)に店舗が見つかりませんでした」などと表示 |
仕組み:ブラウザ → 自社サーバー → Google
| 経路 | 使うキー | キーの置き場所 |
|---|---|---|
| ブラウザ → Maps JavaScript API(地図表示) | ブラウザ用キー | NUXT_PUBLIC_GOOGLE_MAPS_API_KEY(公開前提。HTTPリファラー制限で守る) |
| ブラウザ → /api/geocode・/api/points/nearest(自社サーバー) | なし | — |
| 自社サーバー → Geocoding API v4 | サーバー用キー | NUXT_GOOGLE_MAPS_SERVER_KEY(サーバーの環境変数だけ) |
ブラウザが呼ぶのは自社サイトの API だけで、Google への問い合わせとサーバー用キーはサーバーの中で完結します。第1回で runtimeConfig の public の外に googleMapsServerKey を用意しておいたのは、この回のためです。
「いちばん近い店舗」は、Google には聞かずに自社のサーバーで計算します。店舗の座標は自社の DB にあるので、起点との直線距離を求めて並べるだけで済みます。追加の課金はありません。道のりや所要時間は第10回で Routes API を使って扱います。
Geocoding API v4 の要点
v4 は、従来の maps/api/geocode/json(v3)に代わる新しい版です。公式ドキュメントで確認した要点は次のとおりです(2026年11月時点)。
| 項目 | 内容 |
|---|---|
| リクエスト | GET https://geocode.googleapis.com/v4/geocode/address/{住所}(住所はURLエンコード) |
| キーの渡し方 | X-Goog-Api-Key ヘッダー |
| 返すフィールドの指定 | X-Goog-FieldMask ヘッダー。省略すると全フィールドが返る(指定は任意) |
| 言語・地域 | languageCode(省略時は英語)、regionCode |
| 応答 | results[] に placeId、location.latitude / location.longitude、formattedAddress、granularity(精度)など |
| 料金区分 | Geocoding は Essentials 区分。1回のリクエストごとに課金 |
📰 出典:Google Maps Platform「Geocoding API(v4)」
📰 出典:Google Maps Platform「Choose fields to return」
📰 出典:Google Maps Platform「Geocoding API Usage and Billing」
Geocoding API は住所を座標にするためのものです。「東京駅」のような駅名やランドマーク名でも候補が返ることがありますが、店名などで施設を探すのは Places API の役割です(第7回)。
実装
手順1:サーバー用キーを用意する
Google Cloud コンソールの「APIとサービス」で Geocoding API を有効にし、ブラウザ用とは別のAPIキーを作ります。API制限は「Geocoding API」のみ、可能ならアプリケーション制限に自社サーバーのIPアドレスを指定します。値は .env の NUXT_GOOGLE_MAPS_SERVER_KEY に書き、コミットしません。
📰 出典:Google Maps Platform「API security best practices」
サーバー用キーの欄は、第1回で作った .env.example にすでに用意してあります(ブラウザ用キーとは別の名前で、NUXT_PUBLIC_ が付いていない点に注目してください。付いていない値はブラウザに送られません)。
# .env.example(第1回で作成済み。抜粋)
# サーバー用キー(第6回: Geocoding API v4、第10回: Routes API をサーバーから呼ぶ場合に使用)。
# ブラウザ用キーとは別に発行し、API 制限(+可能なら IP アドレス制限)を設定する。
# runtimeConfig.googleMapsServerKey に対応(クライアントには公開されない)
NUXT_GOOGLE_MAPS_SERVER_KEY=
手順2:画面とサーバーで共有する型
住所変換の候補の型と、近い店舗の結果の型を shared/ に置きます。
// shared/types/geocode.ts
// GET /api/geocode が返す住所変換の候補(第6回)
export interface GeocodeCandidate {
placeId: string
formattedAddress: string
lat: number
lng: number
// 位置の精度(ROOFTOP=建物単位, RANGE_INTERPOLATED, GEOMETRIC_CENTER, APPROXIMATE など)
granularity: string | null
}
shared/types/point.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/shared/types/point.ts
+++ b/shared/types/point.ts
@@ -18,6 +18,9 @@
updatedAt: string // ISO 8601
}
+// 第6回: 起点から近い店舗を探した結果。distanceM は起点からの直線距離(メートル)
+export type NearbyPoint = Point & { distanceM: number }
+
// 業態ごとの表示名・ピンの色・ピン内の文字
export const CATEGORY_META: Record<
Category,
手順3:Geocoding API v4 を呼ぶ関数
// server/utils/geocode.ts
import type { GeocodeCandidate } from '#shared/types/geocode'
// Geocoding API v4 の応答のうち、使うフィールドだけの型(公式リファレンスの GeocodeResult より)
interface V4GeocodeResult {
placeId?: string
location?: { latitude?: number; longitude?: number }
formattedAddress?: string
granularity?: string
}
interface V4GeocodeAddressResponse {
results?: V4GeocodeResult[]
}
// 返してほしいフィールドだけを指定する(フィールドマスク)。省略すると全フィールドが返る
const FIELD_MASK = [
'results.placeId',
'results.location',
'results.formattedAddress',
'results.granularity',
].join(',')
/**
* 住所の文字列を Geocoding API v4 で緯度経度の候補に変換する。
* サーバー専用キーを使うので、この関数はブラウザから直接は呼ばれない(server/ 配下のみ)。
* 結果の緯度経度は規約上、保存できるのは30日まで。このサンプルでは保存せず、その場の検索にだけ使う。
*/
export async function geocodeAddress(address: string, apiKey: string): Promise<GeocodeCandidate[]> {
// 住所はパスの一部として送る。「/」「#」「+」なども含めて URL エンコードする
const url = `https://geocode.googleapis.com/v4/geocode/address/${encodeURIComponent(address)}`
const res = await $fetch<V4GeocodeAddressResponse>(url, {
headers: {
'X-Goog-Api-Key': apiKey, // キーは URL ではなくヘッダーで渡す(ログに残りにくい)
'X-Goog-FieldMask': FIELD_MASK,
},
query: { languageCode: 'ja', regionCode: 'JP' }, // 既定は英語なので日本語を指定
timeout: 5000,
retry: 0, // 課金対象のリクエストなので自動リトライはしない
})
return (res.results ?? []).flatMap((r) => {
const lat = r.location?.latitude
const lng = r.location?.longitude
if (!r.placeId || typeof lat !== 'number' || typeof lng !== 'number') return []
return [{
placeId: r.placeId,
formattedAddress: r.formattedAddress ?? '',
lat,
lng,
granularity: r.granularity ?? null,
}]
})
}
ポイントは3つです。住所に含まれる「/」「#」「+」なども encodeURIComponent でエンコードすること、フィールドマスクで画面に使う4項目だけを要求すること、retry: 0 で自動の再送を切ることです(Nuxt の $fetch は失敗時に再送することがあり、課金対象の API では避けます)。
応答の型は、公式リファレンスの GeocodeResult から使う項目だけを、すべて省略可能として書き出したものです。座標が無い結果は候補から外します。
📰 出典:Google Maps Platform「GeocodeResult(v4 リファレンス)」
手順4:ブラウザから呼ぶ住所変換の API
// server/api/geocode.get.ts
import { z } from 'zod'
const querySchema = z.object({
address: z.string().trim().min(2, '住所を入力してください').max(200),
})
// GET /api/geocode?address=… … 来訪者が入れた住所・駅名を緯度経度の候補に変換する(第6回)
// ブラウザ → このAPI → Google の順に呼ぶことで、サーバー用キーをブラウザに渡さない。
// 変換の結果は「近い店舗を探す起点」に使うだけで、DB にもログにも保存しない
export default defineEventHandler(async (event) => {
const { address } = await getValidatedQuery(event, (q) => querySchema.parse(q))
const { googleMapsServerKey } = useRuntimeConfig(event)
if (!googleMapsServerKey) {
throw createError({
statusCode: 503,
statusMessage: 'Geocoding is not configured',
message: 'サーバー用APIキー(NUXT_GOOGLE_MAPS_SERVER_KEY)が未設定です',
})
}
try {
const candidates = await geocodeAddress(address, googleMapsServerKey)
return { candidates }
} catch (e) {
// Google 側のエラー内容はサーバーのログにだけ出し、利用者には一般的なメッセージを返す
const status = (e as { statusCode?: number }).statusCode
const detail = (e as { data?: { error?: { status?: string; message?: string } } }).data?.error
console.error('[geocode] Geocoding API error', status, detail?.status, detail?.message)
throw createError({
statusCode: 502,
statusMessage: 'Geocoding failed',
message: '住所の変換に失敗しました。時間をおいて再度お試しください',
})
}
})
入力は zod で2〜200文字に制限し、キーが未設定なら 503、Google 側のエラーは 502 にまとめて返します。Google のエラー内容(キーが無効、制限に引っかかった等)は運用者には必要ですが、来訪者に見せる必要はないので、サーバーのログにだけ出します。来訪者が入れた住所そのものは、ログにも書きません。
手順5:2点間の直線距離
// shared/utils/distance.ts
// 第6回: 2点間の直線距離(メートル)。地球を半径 6,371km の球とみなす計算(ハーバーサインの式)。
// 店舗を「近い順」に並べる目安に使う。道のりや所要時間ではない(所要時間は第10回の Routes API)
const EARTH_RADIUS_M = 6_371_000
export function distanceMeters(
a: { lat: number; lng: number },
b: { lat: number; lng: number },
): number {
const toRad = (deg: number) => (deg * Math.PI) / 180
const dLat = toRad(b.lat - a.lat)
const dLng = toRad(b.lng - a.lng)
const h = Math.sin(dLat / 2) ** 2
+ Math.cos(toRad(a.lat)) * Math.cos(toRad(b.lat)) * Math.sin(dLng / 2) ** 2
return 2 * EARTH_RADIUS_M * Math.asin(Math.min(1, Math.sqrt(h)))
}
// 画面に出す距離の表記(1km 未満は 10m 単位、それ以上は 0.1km 単位)
export function formatDistance(m: number): string {
return m < 1000 ? `${Math.round(m / 10) * 10}m` : `${(m / 1000).toFixed(1)}km`
}
ハーバーサインの式(緯度経度から球面上の距離を出す計算式)です。数十kmの範囲で「どちらが近いか」を比べる目安には十分です。画面とサーバーの両方で使うので shared/utils/ に置きます。
手順6:起点から近い店舗を返す API
// server/api/points/nearest.get.ts
import { z } from 'zod'
import type { NearbyPoint } from '#shared/types/point'
import { distanceMeters } from '#shared/utils/distance'
import type { PointRow } from '../../utils/points'
// 起点のまわりで探す範囲。緯度0.5度 ≒ 約55km。経度は日本付近で緯度より短いので少し広めにとる
const SEARCH_LAT_DEG = 0.5
const SEARCH_LNG_DEG = 0.6
const querySchema = z.object({
lat: z.coerce.number().min(-90).max(90),
lng: z.coerce.number().min(-180).max(180),
limit: z.coerce.number().int().min(1).max(20).default(5),
})
// GET /api/points/nearest?lat=…&lng=…&limit=5 … 起点から近い順に店舗を返す(第6回)
// 起点(来訪者が入れた住所の位置・現在地)は受け取るだけで、どこにも保存しない
export default defineEventHandler(async (event): Promise<NearbyPoint[]> => {
const { lat, lng, limit } = await getValidatedQuery(event, (q) => querySchema.parse(q))
const db = useDatabase()
// 1) まず「緯度・経度の範囲」で候補を絞る(全件の距離を計算しないため)
const { rows } = await db.sql`SELECT * FROM points
WHERE lat BETWEEN ${lat - SEARCH_LAT_DEG} AND ${lat + SEARCH_LAT_DEG}
AND lng BETWEEN ${lng - SEARCH_LNG_DEG} AND ${lng + SEARCH_LNG_DEG}
LIMIT 10000`
// 2) 候補との直線距離を計算して、近い順に並べる
const origin = { lat, lng }
return (rows as unknown as PointRow[])
.map((row) => {
const p = toPoint(row)
return { ...p, distanceM: Math.round(distanceMeters(origin, p)) }
})
.sort((a, b) => a.distanceM - b.distanceM)
.slice(0, limit)
})
全店舗との距離を毎回計算すると、店舗が増えたときに重くなります。そこで、まず起点から南北に緯度0.5度・東西に経度0.6度(どちらもおよそ50km)の範囲に入る店舗だけを SQL で取り出し、その中で直線距離を計算して近い順に並べます。起点の緯度経度は、クエリで受け取って計算に使うだけで、どこにも保存しません。
手順7:起点を画面の中だけで持つ
// app/composables/useSearchOrigin.ts
/**
* 第6回: 近い店舗を探す「起点」(来訪者が入れた住所・駅名の位置)。
* - 画面の中(useState)だけで持ち、サーバーの DB にもブラウザの保存領域にも残さない
* - 起点は地図に青い丸で示す(店舗のピンと見分けやすくする)
*/
export interface SearchOrigin {
lat: number
lng: number
label: string // 画面に出す説明(住所検索の整形済み住所)
}
export function useSearchOrigin() {
const { load } = useGoogleMaps()
const origin = useState<SearchOrigin | null>('search-origin', () => null)
let marker: google.maps.marker.AdvancedMarkerElement | null = null
async function setOrigin(map: google.maps.Map, next: SearchOrigin) {
const { AdvancedMarkerElement } = await load('marker')
origin.value = { ...next, ...toLatLngLiteral(next) }
if (!marker) {
const dot = document.createElement('div')
dot.className = 'origin-dot'
marker = new AdvancedMarkerElement({ zIndex: 1001 }) // 店舗のピンより手前
marker.append(dot)
}
marker.title = `起点: ${next.label}`
marker.position = { lat: origin.value.lat, lng: origin.value.lng }
marker.map = map
}
function clearOrigin() {
origin.value = null
if (marker) marker.map = null
}
onScopeDispose(() => {
if (marker) marker.map = null
marker = null
})
return { origin, setOrigin, clearOrigin }
}
起点は useState(画面の中の状態)で持ち、localStorage などにも入れないので、ページを開き直すと消えます。地図では、店舗のピンと見分けられる青い丸で示します。
手順8:住所の検索欄と、いちばん近い店舗の表示
<!-- app/components/AddressSearch.vue -->
<script setup lang="ts">
// 第6回: 来訪者が住所・駅名を入力して、サーバー経由の Geocoding API v4 で緯度経度の候補を探す
// 選んだ候補は「近い店舗を探す起点」になる(保存はしない)
import type { GeocodeCandidate } from '#shared/types/geocode'
const emit = defineEmits<{ pick: [candidate: GeocodeCandidate] }>()
const address = ref('')
const candidates = ref<GeocodeCandidate[] | null>(null) // null = まだ検索していない
const searching = ref(false)
const errorMessage = ref<string | null>(null)
// 精度の表示名(Geocoding v4 の granularity)
const GRANULARITY_LABEL: Record<string, string> = {
ROOFTOP: '建物単位',
RANGE_INTERPOLATED: '推定(番地の補間)',
GEOMETRIC_CENTER: '区域の中心',
APPROXIMATE: 'おおよその位置',
}
async function search() {
errorMessage.value = null
searching.value = true
try {
// ブラウザが呼ぶのは自サイトの API だけ。Google へのリクエストとキーはサーバー側にある
const res = await $fetch<{ candidates: GeocodeCandidate[] }>('/api/geocode', {
query: { address: address.value },
})
candidates.value = res.candidates
} catch (e) {
candidates.value = null
const status = (e as { statusCode?: number }).statusCode
errorMessage.value =
status === 400 ? '住所を2文字以上で入力してください。'
: status === 503 ? '住所検索は未設定です(サーバー用APIキーを設定してください)。'
: '住所の変換に失敗しました。時間をおいて再度お試しください。'
} finally {
searching.value = false
}
}
function pick(c: GeocodeCandidate) {
emit('pick', c)
candidates.value = null
}
</script>
<template>
<div class="address-search">
<form class="address-search__form" role="search" @submit.prevent="search">
<input
v-model="address"
type="search"
placeholder="住所・駅名(例: 東京駅)"
aria-label="住所・駅名"
maxlength="200"
>
<button type="submit" :disabled="searching || address.trim().length < 2">
{{ searching ? '検索中…' : '近くの店舗を探す' }}
</button>
</form>
<p v-if="errorMessage" class="address-search__error" role="alert">{{ errorMessage }}</p>
<p v-else-if="candidates && candidates.length === 0" class="address-search__empty">
候補が見つかりませんでした。表記を変えて試すか、地図を動かして探してください。
</p>
<ul v-else-if="candidates" class="address-search__list">
<li v-for="c in candidates" :key="c.placeId">
<button type="button" @click="pick(c)">
{{ c.formattedAddress }}
<small v-if="c.granularity">({{ GRANULARITY_LABEL[c.granularity] ?? c.granularity }})</small>
</button>
</li>
</ul>
</div>
</template>
検索はボタンを押したときだけ実行します。1文字入力するごとに検索する作りにすると、その回数だけ課金されるためです。候補には granularity(精度)を「建物単位」「区域の中心」などと日本語で添え、来訪者が意図した場所かを判断しやすくしています。
<!-- app/components/OriginSummary.vue -->
<script setup lang="ts">
// 第6回: 起点と、いちばん近い店舗を表示する(「起点を消す」で元に戻す)
import type { NearbyPoint } from '#shared/types/point'
import { formatDistance } from '#shared/utils/distance'
import type { SearchOrigin } from '~/composables/useSearchOrigin'
defineProps<{ origin: SearchOrigin; nearest: NearbyPoint | null }>()
const emit = defineEmits<{ select: [id: number]; clear: [] }>()
</script>
<template>
<div class="origin-summary" role="status">
<span class="origin-summary__label">起点: {{ origin.label }}</span>
<button v-if="nearest" type="button" class="origin-summary__nearest" @click="emit('select', nearest.id)">
いちばん近い店舗: {{ nearest.name }}(約 {{ formatDistance(nearest.distanceM) }})
</button>
<span v-else>近く(約50km 以内)に店舗が見つかりませんでした。</span>
<button type="button" class="origin-summary__clear" @click="emit('clear')">起点を消す</button>
</div>
</template>
手順9:詳細パネルに直線距離を出す
app/components/PointDetail.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/components/PointDetail.vue
+++ b/app/components/PointDetail.vue
@@ -1,13 +1,21 @@
<!-- app/components/PointDetail.vue -->
<script setup lang="ts">
// 第4回: 選んだ店舗の詳細パネル。Google マップの経路案内へのリンクも出す
+// 第6回: 起点があれば起点からの直線距離も出す
import { CATEGORY_META, type Point } from '#shared/types/point'
+import { distanceMeters, formatDistance } from '#shared/utils/distance'
+import type { SearchOrigin } from '~/composables/useSearchOrigin'
const props = defineProps<{
point: Point | null
+ origin?: SearchOrigin | null
}>()
const emit = defineEmits<{ close: [] }>()
+const distance = computed(() =>
+ props.point && props.origin ? formatDistance(distanceMeters(props.origin, props.point)) : null,
+)
+
// Google マップの経路案内を開く URL(Maps URLs。APIキー不要・課金なし)。
// 出発地は指定しない(Google マップ側で利用者の現在地などから選べる)
const directionsUrl = computed(() => {
@@ -36,6 +44,10 @@ const directionsUrl = computed(() => {
<dt>住所</dt>
<!-- テキスト補間 {{ }} は自動でエスケープされる(v-html は使わない) -->
<dd>{{ point.address || '(未登録)' }}</dd>
+ <template v-if="distance">
+ <dt>起点から</dt>
+ <dd>直線で約 {{ distance }}</dd>
+ </template>
<template v-if="point.memo">
<dt>お知らせ</dt>
<dd class="point-detail__memo">{{ point.memo }}</dd>
origin は省略できる props にしたので、起点の無い管理画面(第5回)はそのまま動きます。
手順10:来訪者の画面で組み合わせる
候補を選ぶと、起点を置き、/api/points/nearest でいちばん近い1件を取り、その店舗を選んで地図を合わせます。この流れを moveOrigin にまとめました。第10回で「現在地から探す」を足すときも、この関数を使い回します。
app/pages/index.vue に次の変更を加えます(+ が追加、- が削除)。
app/pages/index.vue の変更(差分)
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -2,11 +2,14 @@
<script setup lang="ts">
// 来訪者向けの店舗検索の画面。
// 第4回: ピンを選ぶと InfoWindow と詳細パネルに店舗の情報を出す。
-import type { Point } from '#shared/types/point'
+// 第6回: 住所・駅名から起点を決め、いちばん近い店舗を選ぶ(起点は保存しない)。
+import type { NearbyPoint, Point } from '#shared/types/point'
+import type { GeocodeCandidate } from '#shared/types/geocode'
const { data: points } = await useFetch<Point[]>('/api/points', { default: () => [] })
const { render } = useMarkers()
-const { selectedId, clearSelection } = useSelection()
+const { selectedId, select, clearSelection } = useSelection()
+const { origin, setOrigin, clearOrigin } = useSearchOrigin()
const map = shallowRef<google.maps.Map | null>(null)
// 選択中の店舗。ID から探す(店舗データを複製して持たない)
@@ -18,6 +21,44 @@ function onMapReady(m: google.maps.Map) {
map.value = m
}
+// ── 第6回: 起点から近い店舗を探す ──
+const nearest = shallowRef<NearbyPoint | null>(null)
+
+async function moveOrigin(lat: number, lng: number, label: string) {
+ if (!map.value) return
+ await setOrigin(map.value, { lat, lng, label })
+ const [first] = await $fetch<NearbyPoint[]>('/api/points/nearest', {
+ query: { lat, lng, limit: 1 },
+ })
+ nearest.value = first ?? null
+ if (!first) {
+ map.value.panTo({ lat, lng })
+ return
+ }
+ select(first.id)
+ // 起点といちばん近い店舗の両方が入るように地図を合わせる
+ 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),
+ }, 80)
+}
+
+function onAddressPick(c: GeocodeCandidate) {
+ moveOrigin(c.lat, c.lng, c.formattedAddress)
+}
+
+function onClearOrigin() {
+ clearOrigin()
+ nearest.value = null
+}
+
+// 「いちばん近い店舗」のボタン → その店舗を選んで、ピンが地図の中央に来るよう移動する
+function onNearestSelect(id: number) {
+ select(id)
+ const p = nearest.value
+ if (p && p.id === id && map.value) map.value.panTo({ lat: p.lat, lng: p.lng })
+}
+
// 地図の準備ができた時点と、データが変わった時点でピンを描き直す
watch([map, points], ([m, list]) => {
if (m) render(m, list)
@@ -26,7 +67,17 @@ watch([map, points], ([m, list]) => {
<template>
<div class="map-page">
- <CategoryLegend :count="points.length" />
+ <div class="map-page__toolbar">
+ <AddressSearch @pick="onAddressPick" />
+ <OriginSummary
+ v-if="origin"
+ :origin="origin"
+ :nearest="nearest"
+ @select="onNearestSelect"
+ @clear="onClearOrigin"
+ />
+ <CategoryLegend :count="points.length" />
+ </div>
<div class="map-page__body">
<ClientOnly>
<MapView @ready="onMapReady" />
@@ -34,7 +85,10 @@ watch([map, points], ([m, list]) => {
<div class="map-placeholder">地図を読み込み中…</div>
</template>
</ClientOnly>
- <PointDetail :point="selectedPoint" @close="clearSelection" />
+ <PointDetail :point="selectedPoint" :origin="origin" @close="clearSelection">
+ <p>地図のピンを選ぶと、ここに店舗の詳細が表示されます。</p>
+ <p>住所・駅名を入れると、近い店舗を探せます。</p>
+ </PointDetail>
</div>
</div>
</template>
select(first.id) で選ぶと、第4回の仕組みで InfoWindow と詳細パネルが開きます。fitBounds の 80 は地図の端からの余白(ピクセル)で、起点と店舗のピンが端に寄りすぎないようにしています。
手順11:スタイルを足す
app/assets/css/main.css に次の変更を加えます(+ が追加、- が削除)。
app/assets/css/main.css の変更(差分)
--- a/app/assets/css/main.css
+++ b/app/assets/css/main.css
@@ -303,6 +303,128 @@
color: #fff;
}
+/* 第6回: 住所検索 */
+.map-page__toolbar {
+ display: flex;
+ flex-wrap: wrap;
+ align-items: flex-start;
+ justify-content: space-between;
+ gap: 8px 16px;
+}
+
+.map-page__toolbar .legend {
+ flex: 1 1 320px;
+}
+
+.address-search {
+ position: relative;
+ flex: 1 1 360px;
+ max-width: 520px;
+}
+
+.address-search__form {
+ display: flex;
+ gap: 6px;
+}
+
+.address-search__form input {
+ flex: 1;
+ min-width: 0;
+ padding: 6px 8px;
+ border: 1px solid #d0d7de;
+ border-radius: 6px;
+ font: inherit;
+}
+
+.address-search__form button {
+ padding: 6px 12px;
+ border: 1px solid #0b4fb3;
+ border-radius: 6px;
+ background: #1a73e8;
+ color: #fff;
+ cursor: pointer;
+}
+
+.address-search__form button:disabled {
+ opacity: 0.6;
+ cursor: default;
+}
+
+.address-search__list {
+ position: absolute;
+ z-index: 10;
+ left: 0;
+ right: 0;
+ margin: 4px 0 0;
+ padding: 4px 0;
+ list-style: none;
+ border: 1px solid #d0d7de;
+ border-radius: 6px;
+ background: #fff;
+ box-shadow: 0 4px 12px rgb(0 0 0 / 12%);
+}
+
+.address-search__list button {
+ display: block;
+ width: 100%;
+ padding: 6px 10px;
+ border: none;
+ background: none;
+ text-align: left;
+ font: inherit;
+ cursor: pointer;
+}
+
+.address-search__list button:hover,
+.address-search__list button:focus-visible {
+ background: #f6f8fa;
+}
+
+.address-search__error,
+.address-search__empty {
+ margin: 4px 0 0;
+ font-size: 13px;
+}
+
+.address-search__error {
+ color: #cf222e;
+}
+
+/* 第6回: 起点(住所検索・現在地)といちばん近い店舗 */
+.origin-dot {
+ width: 16px;
+ height: 16px;
+ border: 3px solid #fff;
+ border-radius: 50%;
+ background: #1a73e8;
+ box-shadow: 0 0 0 6px rgb(26 115 232 / 25%);
+ transform: translateY(50%); /* 点の中心を座標に合わせる */
+}
+
+.origin-summary {
+ display: flex;
+ flex-wrap: wrap;
+ align-items: center;
+ gap: 8px;
+ padding: 6px 10px;
+ border-radius: 6px;
+ background: #ddf4ff;
+ font-size: 13px;
+}
+
+.origin-summary button {
+ padding: 4px 8px;
+ border: 1px solid #d0d7de;
+ border-radius: 6px;
+ background: #fff;
+ font: inherit;
+ cursor: pointer;
+}
+
+.origin-summary__nearest {
+ font-weight: 700;
+}
+
/* 第5回: 管理画面(一覧なしの 地図 + フォーム) */
.map-page__note {
margin: 0;
Geocoding の結果を保存しない設計と利用規約
Google Maps Platform の Service Specific Terms の Geocoding API の項(2026年11月時点で確認)では、次のように定められています。
📰 出典:Google Maps Platform「Service Specific Terms」
- 6.2:Geocoding API の結果を、Google 以外の地図と組み合わせて使ってはならない
- 6.3.1:緯度・経度は連続30暦日まで一時的に保存(キャッシュ)でき、その後は削除する
- 6.3.2:例外として、リクエスト元アプリのエンドユーザー向けの機能のためだけに、エンドユーザーごとに分けて保存する場合は期限なく保存できる(複数のエンドユーザーをまたいで使ってはならない)
- place_id は保存の制限の対象外(Google ID Caching)
📰 出典:Google Maps Platform「Geocoding API Policies」
店舗の座標は、すべての来訪者が同じものを見る共有のデータです。住所変換の結果を店舗の座標として保存すると、6.3.2 の例外(エンドユーザーごとの分離)には当たらない可能性が高いと筆者は考えています。そこでこの連載では、住所変換の結果をそもそも保存しない設計にしました。保存しなければ、30日の期限を管理する仕組みも要りません。
| データ | 扱い |
|---|---|
| 店舗の座標・住所の表記 | 自社で決めた値(第5回の管理画面)を DB に保存する |
| 来訪者が入れた住所・駅名 | サーバーで Google に渡すだけ。DB・ログに残さない |
| 変換結果の緯度経度・整形済み住所 | 起点として画面の中(useState)だけで使う。ページを閉じれば消える |
| 起点からの距離 | 画面とサーバーでその都度計算する |
地図も Google の地図(Maps JavaScript API)なので、6.2 にも沿っています。ただし、これは筆者の読み方にもとづく設計例です。実際の運用可否は、契約内容と規約本文をもとに法務部門や専門家に確認してください。
動作確認の方法
- .env に NUXT_GOOGLE_MAPS_SERVER_KEY を設定して npm run dev
- 欄に「東京駅」と入れて「近くの店舗を探す」→ 候補が出ることを確認
- 候補をクリック → 青い丸が出て、いちばん近い店舗が選ばれ、詳細パネルに「起点から 直線で約 …」が出ることを確認
- 「起点を消す」→ 青い丸と距離が消えることを確認
- 開発者ツールの Network タブで、ブラウザが呼んでいるのが /api/geocode と /api/points/nearest だけで、サーバー用キーがどこにも出ないことを確認
筆者の環境では、npm run build と npm run typecheck の成功に加え、ビルド後のサーバーに対して curl で次を確認しました。東京駅付近の座標で /api/points/nearest を呼ぶと「丸の内店 246m・八重洲店 338m・呉服橋 修理窓口 441m」の順に返ること、札幌付近では0件、緯度 999 では 400。/api/geocode はサーバー用キー未設定で 503、住所が1文字で 400。ダミーのサーバー用キーでは Google まで届いて「INVALID_ARGUMENT(API key not valid)」が返り、画面向けには 502 と一般的なメッセージになること。ビルド後の HTML とブラウザ向けファイルに、サーバー用キー(ダミー値)が含まれないことも確認しています。
有効なキーが無いため、実際の変換結果(候補の内容・精度・日本語表記、駅名で候補が出るか)と、地図上の青い丸・地図の移動は確認できていません。 応答の形は公式ドキュメントの記載にもとづいて実装しています。ご自身のキーで確認してください。
つまずきやすい点・セキュリティ上の注意
- ブラウザ用キーを流用する:ブラウザ用キーは HTTPリファラー制限なので、サーバーからの呼び出しには合いません。用途ごとに別のキーにします
- /api/geocode は誰でも呼べる入口になる:自社サーバー経由でも、外部から大量に呼ばれればその分課金されます。第12回で回数制限を入れ、Cloud コンソールのクォータ(1日あたりの上限)と予算アラートも設定します
- 入力のたびに検索する:オートコンプリート風にすると回数が跳ね上がります。住所変換はボタン操作で1回にします
- 「次から速く」と変換結果を保存する:保存した時点で30日の期限の管理が必要になります。同じ住所でも、その都度変換します
- 直線距離を道のりと誤解させる:川や線路をまたぐと、直線では近くても歩くと遠いことがあります。表示は「直線で約」と明記しています
発注者向けメモ
- 住所検索の費用は、来訪者の検索回数に比例します(Geocoding は Essentials 区分)。店舗検索は公開ページなので、アクセスが増えれば検索も増えます。「1か月の来訪者数 × 検索する人の割合」で見込みを立て、単価は公式の料金ページで確認します
- ブラウザ用とサーバー用でキーを分けているかは、成果物のレビューで必ず確認したい点です。分けていないと、キーの悪用で想定外の請求が起きるリスクが高まります
- 「調べた住所を保存しない」ことは、要件として明記しておくと安心です。保存すると規約の保存期間の管理や、個人の住所を預かる責任が生じます
- いちばん近い店舗の計算は自社のサーバーで行うので、追加の課金はありません。所要時間まで出すかどうか(第10回)は、別の費用として検討します
📰 出典:Google Maps Platform「Billing overview」
発注者がやることのチェックリストです。
- ☐ ブラウザ用・サーバー用のAPIキーを分けて、自社名義のプロジェクトで発行した
- ☐ Geocoding API の1日あたりのクォータ上限と予算アラートを設定した
- ☐ 月の来訪者数と、住所検索を使う割合の見込みを出した
- ☐ 来訪者が入れた住所と変換結果を保存しない方針を、規約を踏まえて法務と確認した
開発会社への確認に使える質問例です。
- 「住所変換のAPIキーは、ブラウザに出ない形で管理されていますか?」
- 「来訪者が入れた住所や変換結果は、DB やログに残りますか?」
- 「住所検索が想定外に呼ばれたとき、回数や費用の上限はどう決まっていますか?」
- 「近い店舗の判定は直線距離ですか、道のりですか?」
まとめと次回予告
この回では、来訪者が入れた住所・駅名を Geocoding API v4 で座標に変換し、いちばん近い店舗を選んで直線距離を出せるようにしました。サーバー用キーはサーバーの中だけで使う、フィールドマスクで必要な項目だけを受け取る、変換結果は起点として使うだけで保存しない、の3点が押さえどころです。
次回は「Places API (New)で店舗をGoogleマップの情報と結びつけ、営業時間と評価を出す」です。管理画面で Google マップ上の同じ店舗を選んで place_id だけを保存し、来訪者の画面では営業時間と評価をその場で取得して表示します。要求する項目によって料金区分が変わる仕組みも解説します。
この連載の記事一覧
この記事は連載「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キー制限・クォータ・予算アラート・管理画面の保護










コメント
コメント一覧 (3件)
[…] Maps API とNuxtで社内向けの情報集約マップを作る連載の第7回です。前回(第6回)では、住所を Geocoding API v4 […]
[…] 住所を入力して緯度経度に変換する(Geocoding API v4をサーバー経由で) […]
[…] […]