Google Maps API とNuxtで自社サイトの店舗検索マップを作る連載の第10回です。前回(第9回)では、クラスタリングと表示範囲の読み込みで、店舗が数千件あっても地図が重くならないようにしました。今回は、ブラウザの位置情報で現在地を検索の起点にし、「現在地から半径◯km以内」の店舗だけを残したうえで、近い店舗までの徒歩・車の所要時間を Google の Routes API で調べる機能を作ります。
「近くの店舗を探しに来たお客様に、『歩いて何分か』まで見せたい。Google の費用はどれくらいかかるの?」
結論から言うと、現在地の取得と半径の判定はブラウザの機能と自前の計算なので、Google の追加の課金はありません。費用が発生するのは所要時間だけで、Routes API は「起点の数 × 店舗の数」の組み合わせ(要素)ごとに課金されます。 そこで所要時間は、ボタンを押したときだけ、近い順に最大10件まで調べ、結果は保存しません。
この回で作るもの:現在地・半径・所要時間で近くの店舗を探す
| 操作 | 画面の動き |
|---|---|
| 「現在地から探す」を押す | 許可すると現在地が検索の起点になり(第6回と同じ青い丸)、いちばん近い店舗が選ばれる。誤差の目安も出る |
| 「半径で絞り込む」を押す | 起点(なければ地図の中心)に円が出て、円の中の店舗だけが残る。スライダーやつまみで半径を変えられる |
| 所要時間の「徒歩」「車」を押す | 一覧の上から最大10件の所要時間を調べ、「320m / 徒歩 5分」のように出す |
| 別の起点を選ぶ | 前の起点の所要時間は消え、円も新しい起点に移る |
| 位置情報を拒否する | 「位置情報の利用が許可されていません」と表示する |
仕組み:使う機能と費用の関係
| やること | 使う機能 | Google の課金 |
|---|---|---|
| 現在地の取得 | ブラウザの navigator.geolocation(Geolocation API=ブラウザが端末の位置を教えてくれる仕組み) | なし(Google の Geolocation API は使わない) |
| 半径の円の表示と編集 | Maps JavaScript API の Circle(editable: true) | なし(地図の読み込みに含まれる) |
| 円の内側かどうか | 第6回の直線距離の計算(distanceMeters) | なし(自前の計算) |
| 徒歩・車の所要時間 | Routes API の Compute Route Matrix(サーバー経由) | あり(要素=起点×行き先ごと) |
Google にも「Geolocation API」という有料APIがありますが、Wi-Fi や携帯基地局の情報から位置を推定するサービスです。ブラウザで開く店舗検索なら、ブラウザ標準の位置情報で足ります。
📰 出典:MDN「Geolocation API」
なお、円や多角形を描く Drawing Library は2025年8月に非推奨となり、2026年5月に利用できなくなっています。今回の円は基本機能の Circle で作ります。
📰 出典:Google Maps Platform「Deprecations」
Routes API(Compute Route Matrix)の要点
Compute Route Matrix は、複数の起点と行き先の組み合わせの所要時間と道のりをまとめて返す API です。2026年11月時点の公式ドキュメントで確認した要点です。
| 項目 | 内容 |
|---|---|
| 呼び出し先 | POST https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
| フィールドマスク | X-Goog-FieldMask ヘッダー(返してほしい項目の指定)が必須。今回は originIndex,destinationIndex,duration,distanceMeters,condition だけ |
| 課金の単位 | 要素(element)=起点の数 × 行き先の数。起点1つ・店舗10件なら10要素 |
| 料金の区分 | 渋滞を考えない TRAFFIC_UNAWARE などの基本の機能は Essentials。渋滞を考える TRAFFIC_AWARE 以上は Pro |
経路の決め方(routingPreference) | 車(DRIVE)などのときだけ指定できる。徒歩で送るとエラーになる |
| 応答の形 | 要素の配列(並び順は保証されない)。エラーも [{ "error": {...} }] の配列で返る |
| 1回の上限 | 多くの場合625要素まで。公共交通機関(TRANSIT)と TRAFFIC_AWARE_OPTIMAL は100要素まで |
📰 出典:Google Maps Platform「Compute Route Matrix」
📰 出典:Google Maps Platform「Routes API Usage and Billing」
公共交通機関(電車・バス)は、日本での提供範囲を確認しきれなかったため使わず、徒歩と車だけにしました。
所要時間の結果は保存しない
Google Maps Platform の Service Specific Terms(2026年11月時点)の 19.3 では、Routes API から得た緯度経度の一時保存は連続30日までとされています。今回は座標を含む項目(経路の線など)をそもそも要求せず、所要時間と道のりも画面に出すだけで、DB にもブラウザにも残しません。
📰 出典:Google Maps Platform「Service Specific Terms」
これは筆者の読み方で、最終的な判断は契約内容と規約の本文をもとに法務・専門家に確認してください。来訪者の現在地も、第6回の起点と同じく保存しません。
実装
始める前に、Cloud コンソールで「Routes API」を有効にし、第6回で作ったサーバー用キーの「API の制限」に Routes API を追加しておきます(ブラウザ用キーには追加しません)。
| ファイル | 役割 |
|---|---|
useCurrentLocation.ts・useAreaFilter.ts(新規)・usePointFilter.ts | 現在地と半径の絞り込み |
shared/types/travel.ts・server/utils/routes.ts・server/api/travel-times.post.ts(新規) | 所要時間のサーバーAPI |
useTravelTimes.ts・AreaTools.vue(新規)・PointList.vue・PointDetail.vue | 所要時間を調べて表示する |
app/pages/index.vue・main.css | 組み合わせと見た目 |
手順1:現在地を取得する
// app/composables/useCurrentLocation.ts
/**
* 第10回: ブラウザの位置情報(navigator.geolocation)で現在地を取得する。
* - Google の Geolocation API は使わない(ブラウザの機能なので API 課金は発生しない)
* - 位置情報は HTTPS(または localhost)のページでしか使えない
* - 取得した位置は「起点」(useSearchOrigin)にするだけで、サーバーには保存しない
*/
export function useCurrentLocation() {
const accuracy = ref<number | null>(null) // 誤差の目安(メートル)
const locating = ref(false)
const error = ref<string | null>(null)
async function locate(): Promise<google.maps.LatLngLiteral | null> {
error.value = null
if (!window.isSecureContext || !('geolocation' in navigator)) {
error.value = 'この画面では位置情報を使えません(HTTPS で開いてください)。'
return null
}
locating.value = true
try {
const pos = await new Promise<GeolocationPosition>((resolve, reject) =>
navigator.geolocation.getCurrentPosition(resolve, reject, {
enableHighAccuracy: false, // true にすると GPS を使い、時間と電池を多く使う
timeout: 10_000,
maximumAge: 60_000, // 1分以内に取得した位置があれば再利用する
}),
)
accuracy.value = Math.round(pos.coords.accuracy)
return toLatLngLiteral({ lat: pos.coords.latitude, lng: pos.coords.longitude })
} catch (e) {
error.value = toMessage(e)
return null
} finally {
locating.value = false
}
}
return { accuracy, locating, error, locate }
}
// GeolocationPositionError の code: 1=許可されなかった, 2=取得できない, 3=時間切れ
function toMessage(e: unknown): string {
const code = (e as { code?: number }).code
if (code === 1) return '位置情報の利用が許可されていません。ブラウザの設定を確認してください。'
if (code === 3) return '現在地の取得に時間がかかりすぎました。もう一度お試しください。'
return '現在地を取得できませんでした。'
}
位置情報は HTTPS のページ(localhost は例外)でしか使えないので、window.isSecureContext で先に確かめます。コールバック形式の getCurrentPosition は Promise に包みました。
取得した位置は第6回の起点(useSearchOrigin)にするだけなので、青い丸・いちばん近い店舗・一覧の近い順は既存の仕組みがそのまま使えます。coords.accuracy は誤差の目安(メートル)で、パソコンでは数百メートル以上ずれることもあります。
📰 出典:MDN「Geolocation: getCurrentPosition() メソッド」
手順2:半径の円で絞り込む
app/composables/useAreaFilter.ts の全文
// app/composables/useAreaFilter.ts
import type { Point } from '#shared/types/point'
import { distanceMeters } from '#shared/utils/distance'
export type AreaMode = 'none' | 'circle'
const SHAPE_STYLE = {
strokeColor: '#1a73e8',
strokeWeight: 2,
fillColor: '#1a73e8',
fillOpacity: 0.08,
}
/**
* 第10回: 起点(または地図の中心)から半径◯km 以内の店舗だけを残す。
* - 円は Maps JavaScript API の Circle(editable で中心と半径をドラッグで直せる)
* - 内側かどうかは第6回の直線距離の計算(distanceMeters)で判定する
* - Google への追加リクエストは発生しない(地図の読み込みに含まれる機能だけを使う)
*/
export function useAreaFilter(map: Ref<google.maps.Map | null>) {
const { load } = useGoogleMaps()
const mode = ref<AreaMode>('none')
const radiusKm = ref(1)
// 店舗が範囲内かを返す関数。範囲の指定がなければ null(=絞り込まない)
const matcher = shallowRef<((p: Point) => boolean) | null>(null)
let circle: google.maps.Circle | null = null
async function startCircle(center: google.maps.LatLngLiteral) {
if (!map.value) return
const { Circle } = await load('maps')
clearArea()
circle = new Circle({
...SHAPE_STYLE,
map: map.value,
center,
radius: radiusKm.value * 1000, // メートル
editable: true, // 中心と外周のつまみをドラッグして直せる
clickable: false, // 円の内側のクリックでも、店舗のピンを選べるようにする
})
const update = () => {
const c = circle?.getCenter()?.toJSON()
const r = circle?.getRadius()
if (!c || !r) return
radiusKm.value = Math.round(r / 100) / 10 // 0.1km 単位で表示
matcher.value = (p) => distanceMeters(c, p) <= r
}
circle.addListener('radius_changed', update)
circle.addListener('center_changed', update)
update()
mode.value = 'circle'
fitToArea()
}
// スライダーから半径を変える
function setRadiusKm(km: number) {
if (!circle) return
circle.setRadius(km * 1000) // radius_changed → update() が呼ばれる
fitToArea()
}
// 起点が変わったら、円の中心も動かす
function moveCenter(center: google.maps.LatLngLiteral) {
if (!circle) return
circle.setCenter(center) // center_changed → update()
fitToArea()
}
// 円全体が見えるように地図を合わせる(第9回の表示範囲読み込みで、範囲内の店舗が取得される)
function fitToArea() {
const bounds = circle?.getBounds()
if (bounds && map.value) map.value.fitBounds(bounds, 24)
}
function clearArea() {
circle?.setMap(null)
circle = null
matcher.value = null
mode.value = 'none'
}
onScopeDispose(clearArea)
return { mode, radiusKm, matcher, startCircle, setRadiusKm, moveCenter, clearArea }
}
中心は matcher(店舗を受け取って「範囲内なら true」を返す関数)です。円が変わるたびに新しい関数に差し替えるので、絞り込み結果(computed)が自動で計算し直されます。スライダーで半径を変えたときも radius_changed 経由で同じ update が動きます。
判定には第6回の distanceMeters を使いました。一覧の距離表示と同じ計算なので、表示と判定が食い違いにくくなります。
第9回から、画面が持っている店舗は地図に見えている範囲だけです。そこで円を作ったり大きさを変えたりしたら、fitBounds で円全体が見えるまで地図を合わせ、第9回の仕組みで円の中の店舗を読み込ませます(1回の上限10,000件に収まる前提)。
手順3:業態の絞り込みと重ねる
app/composables/usePointFilter.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/app/composables/usePointFilter.ts
+++ b/app/composables/usePointFilter.ts
@@ -2,15 +2,22 @@
import { CATEGORIES, type Category, type Point } from '#shared/types/point'
/**
- * 第8回: 業態による絞り込み。
+ * 第8回: 業態による絞り込み。第10回: 半径の条件も重ねられる。
* 表示する業態を useState で共有し、地図のピンと一覧の両方が同じ結果を使う。
*/
-export function usePointFilter(points: Ref<Point[]>) {
+export function usePointFilter(
+ points: Ref<Point[]>,
+ // 第10回: 半径の判定。null なら絞り込まない
+ areaMatcher?: Ref<((p: Point) => boolean) | null>,
+) {
const visibleCategories = useState<Category[]>('visible-categories', () => [...CATEGORIES])
- const filteredPoints = computed(() =>
- points.value.filter((p) => visibleCategories.value.includes(p.category)),
- )
+ const filteredPoints = computed(() => {
+ const inArea = areaMatcher?.value
+ return points.value.filter(
+ (p) => visibleCategories.value.includes(p.category) && (!inArea || inArea(p)),
+ )
+ })
// 業態ごとの件数(絞り込み前)。チェックボックスの横に出す
const countByCategory = computed(() => {
手順4:所要時間を調べるサーバーAPI
所要時間の結果の型を、画面とサーバーの両方から使えるように shared/ に置きます。
// shared/types/travel.ts
// 第10回: POST /api/travel-times の結果(店舗ごとの所要時間。経路が無ければ null)
export interface TravelTimeResult {
id: number
durationSec: number | null
distanceM: number | null
}
Routes API の呼び出しは、サーバー用キーをブラウザに出さないようサーバー側にまとめます。
// server/utils/routes.ts
// 第10回: Routes API の Compute Route Matrix で、起点から複数の店舗までの所要時間と道のりを求める
export type TravelMode = 'WALK' | 'DRIVE'
export interface TravelTime {
durationSec: number // 所要時間(秒)
distanceM: number // 道のり(メートル)
}
// Routes API の応答(1要素 = 起点1つ × 行き先1つ)のうち、使うフィールドだけの型
interface MatrixElement {
originIndex?: number
destinationIndex?: number
duration?: string // 例: "485s"
distanceMeters?: number
condition?: string // ROUTE_EXISTS / ROUTE_NOT_FOUND
}
// 返してほしいフィールド。Routes API ではフィールドマスクの指定が必須
const FIELD_MASK = 'originIndex,destinationIndex,duration,distanceMeters,condition'
const toWaypoint = (p: { lat: number; lng: number }) => ({
waypoint: { location: { latLng: { latitude: p.lat, longitude: p.lng } } },
})
/**
* 起点1つから destinations の各店舗までの所要時間を返す(destinations と同じ順番。経路が無ければ null)。
* 課金は「起点の数 × 行き先の数」の要素ごと。渋滞を考えない(TRAFFIC_UNAWARE)基本の機能だけを使う。
* 結果は画面に出すだけで保存しない(規約上も、座標を含む結果の保存は30日までに限られる)。
*/
export async function computeTravelTimes(
origin: { lat: number; lng: number },
destinations: { lat: number; lng: number }[],
mode: TravelMode,
apiKey: string,
): Promise<(TravelTime | null)[]> {
const elements = await $fetch<MatrixElement[]>(
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix',
{
method: 'POST',
headers: {
'X-Goog-Api-Key': apiKey,
'X-Goog-FieldMask': FIELD_MASK,
},
body: {
origins: [toWaypoint(origin)],
destinations: destinations.map(toWaypoint),
travelMode: mode,
// 経路の決め方は車のときだけ指定できる。渋滞を考えない指定が基本料金の区分
...(mode === 'DRIVE' ? { routingPreference: 'TRAFFIC_UNAWARE' } : {}),
languageCode: 'ja',
regionCode: 'JP',
},
timeout: 5000,
retry: 0, // 課金対象のリクエストなので自動リトライはしない
},
)
// 応答の並び順は保証されないので、destinationIndex で元の順番に戻す
const results: (TravelTime | null)[] = destinations.map(() => null)
for (const e of elements) {
if (e.destinationIndex === undefined || e.condition !== 'ROUTE_EXISTS') continue
const sec = Number.parseInt(e.duration ?? '', 10)
if (Number.isNaN(sec)) continue
results[e.destinationIndex] = { durationSec: sec, distanceM: e.distanceMeters ?? 0 }
}
return results
}
duration は "485s" のような文字列なので数値に直します。経路が無い要素は null にしました。課金対象なので自動の再試行はしません。
// server/api/travel-times.post.ts
import { z } from 'zod'
import type { TravelTimeResult } from '#shared/types/travel'
import type { PointRow } from '../utils/points'
// 1回に所要時間を調べる店舗の数の上限(= Routes API の課金要素の数の上限)
const MAX_DESTINATIONS = 10
const bodySchema = z.object({
origin: z.object({
lat: z.number().min(-90).max(90),
lng: z.number().min(-180).max(180),
}),
ids: z.array(z.number().int().positive()).min(1).max(MAX_DESTINATIONS),
mode: z.enum(['WALK', 'DRIVE']),
})
// POST /api/travel-times … 起点から店舗までの所要時間(第10回)
// 店舗の座標はブラウザから受け取らず、DB の値を使う(任意の地点の経路計算に使われないようにする)
export default defineEventHandler(async (event): Promise<{ results: TravelTimeResult[] }> => {
const { origin, ids, mode } = await readValidatedBody(event, (b) => bodySchema.parse(b))
const { googleMapsServerKey } = useRuntimeConfig(event)
if (!googleMapsServerKey) {
throw createError({
statusCode: 503,
statusMessage: 'Routes is not configured',
message: 'サーバー用APIキー(NUXT_GOOGLE_MAPS_SERVER_KEY)が未設定です',
})
}
const db = useDatabase()
const stores: PointRow[] = []
for (const id of [...new Set(ids)]) {
const { rows } = await db.sql`SELECT * FROM points WHERE id = ${id}`
if (rows?.[0]) stores.push(rows[0] as unknown as PointRow)
}
if (stores.length === 0) {
throw createError({ statusCode: 404, statusMessage: 'Point not found' })
}
try {
const times = await computeTravelTimes(origin, stores, mode, googleMapsServerKey)
return {
results: stores.map((s, i) => ({
id: s.id,
durationSec: times[i]?.durationSec ?? null,
distanceM: times[i]?.distanceM ?? null,
})),
}
} catch (e) {
const status = (e as { statusCode?: number }).statusCode
// Routes API のエラーは、成功時と同じく配列([{ error: {...} }])で返ってくる
type GoogleError = { error?: { status?: string; message?: string } }
const data = (e as { data?: GoogleError | GoogleError[] }).data
const detail = (Array.isArray(data) ? data[0] : data)?.error
console.error('[travel-times] Routes API error', status, detail?.status, detail?.message)
throw createError({
statusCode: 502,
statusMessage: 'Routes failed',
message: '所要時間を調べられませんでした。時間をおいて再度お試しください',
})
}
})
大事な点は、行き先の座標をブラウザから受け取らず、店舗の ID だけを受け取って DB の座標を使うことです。座標を受け取る作りだと、「任意の地点の所要時間を、こちらのキーと費用で計算できる入口」として使われるおそれがあります。ID なら行き先は自社の店舗に限られ、1回10要素までに決まります。
起点はブラウザから受け取るしかありませんが、Routes API に渡すだけで保存しません。誰でも呼べる有料 API の入口なので、回数制限は第12回で入れます。
手順5:画面から所要時間を調べて表示する
// app/composables/useTravelTimes.ts
import type { TravelTimeResult } from '#shared/types/travel'
export type TravelMode = 'WALK' | 'DRIVE'
const MODE_LABEL: Record<TravelMode, string> = { WALK: '徒歩', DRIVE: '車' }
/**
* 第10回: 起点から近い店舗までの所要時間(サーバー経由で Routes API)。
* - 結果は画面の表示にだけ使い、保存しない。起点が変わったら消す
* - 1回に調べるのは近い順に最大10件(= Routes API の課金要素は最大10)
*/
export function useTravelTimes() {
const mode = ref<TravelMode | null>(null)
const times = shallowRef(new Map<number, TravelTimeResult>())
const loading = ref(false)
const error = ref<string | null>(null)
async function fetchTimes(origin: { lat: number; lng: number }, ids: number[], next: TravelMode) {
if (ids.length === 0) return
loading.value = true
error.value = null
try {
const res = await $fetch<{ results: TravelTimeResult[] }>('/api/travel-times', {
method: 'POST',
body: { origin: { lat: origin.lat, lng: origin.lng }, ids: ids.slice(0, 10), mode: next },
})
times.value = new Map(res.results.map((r) => [r.id, r]))
mode.value = next
} catch (e) {
const status = (e as { statusCode?: number }).statusCode
error.value = status === 503
? '所要時間の検索は未設定です(サーバー用APIキーを設定してください)。'
: '所要時間を調べられませんでした。時間をおいて再度お試しください。'
} finally {
loading.value = false
}
}
function clearTimes() {
times.value = new Map()
mode.value = null
error.value = null
}
// 一覧・詳細に出す文字(例: 「徒歩 8分」)。調べていない店舗は null
function label(id: number): string | null {
const t = times.value.get(id)
if (!t || !mode.value) return null
if (t.durationSec === null) return `${MODE_LABEL[mode.value]}の経路なし`
return `${MODE_LABEL[mode.value]} ${Math.max(1, Math.round(t.durationSec / 60))}分`
}
return { mode, times, loading, error, fetchTimes, clearTimes, label }
}
操作パネルは表示だけを担当し、押されたボタンをイベントでページに伝えます。
<!-- app/components/AreaTools.vue -->
<script setup lang="ts">
// 第10回: 現在地・半径・所要時間の操作パネル(表示だけを担当し、処理はページと composable)
import type { AreaMode } from '~/composables/useAreaFilter'
import type { TravelMode } from '~/composables/useTravelTimes'
defineProps<{
mode: AreaMode
radiusKm: number
locating: boolean
locationError: string | null
accuracy: number | null
hasOrigin: boolean // 起点があるときだけ、所要時間を調べられる
travelMode: TravelMode | null
travelLoading: boolean
travelError: string | null
disabled: boolean // 地図の準備ができていない間は操作できない
}>()
const emit = defineEmits<{
locate: []
'start-circle': []
radius: [km: number]
clear: []
travel: [mode: TravelMode]
}>()
function onRadiusChange(e: Event) {
emit('radius', Number((e.target as HTMLInputElement).value))
}
</script>
<template>
<div class="area-tools" role="group" aria-label="近くの店舗を探す">
<button type="button" :disabled="disabled || locating" @click="emit('locate')">
{{ locating ? '取得中…' : '現在地から探す' }}
</button>
<button type="button" :disabled="disabled" :aria-pressed="mode === 'circle'" @click="emit('start-circle')">
半径で絞り込む
</button>
<label v-if="mode === 'circle'" class="area-tools__radius">
半径 {{ radiusKm.toFixed(1) }} km
<input type="range" min="0.5" max="10" step="0.5" :value="radiusKm" @change="onRadiusChange">
</label>
<button v-if="mode !== 'none'" type="button" @click="emit('clear')">半径を解除</button>
<span class="area-tools__travel">
所要時間:
<button
type="button"
:disabled="disabled || !hasOrigin || travelLoading"
:aria-pressed="travelMode === 'WALK'"
@click="emit('travel', 'WALK')"
>
徒歩
</button>
<button
type="button"
:disabled="disabled || !hasOrigin || travelLoading"
:aria-pressed="travelMode === 'DRIVE'"
@click="emit('travel', 'DRIVE')"
>
車
</button>
</span>
<p v-if="locationError" class="area-tools__error" role="alert">{{ locationError }}</p>
<p v-else-if="travelError" class="area-tools__error" role="alert">{{ travelError }}</p>
<p v-else-if="accuracy !== null" class="area-tools__note">現在地の誤差: 約 {{ accuracy }} m</p>
</div>
</template>
スライダーは @change(指を離したとき)で受け取ります。@input だと動かしている間ずっと地図が動き、読み込みが何度も走るためです。
app/components/PointList.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/components/PointList.vue
+++ b/app/components/PointList.vue
@@ -9,6 +9,8 @@
points: Point[]
selectedId: number | null
origin: SearchOrigin | null
+ // 第10回: 所要時間の表示(調べていない店舗は null)
+ travelLabel?: (id: number) => string | null
}>()
const emit = defineEmits<{ select: [id: number] }>()
@@ -52,6 +54,7 @@
<span class="point-list__name">{{ p.name }}</span>
<span v-if="origin" class="point-list__distance">
{{ formatDistance(distanceMeters(origin, p)) }}
+ <template v-if="travelLabel?.(p.id)"> / {{ travelLabel(p.id) }}</template>
</span>
</button>
</li>
app/components/PointDetail.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/components/PointDetail.vue
+++ b/app/components/PointDetail.vue
@@ -1,7 +1,7 @@
<!-- app/components/PointDetail.vue -->
<script setup lang="ts">
// 第4回: 選んだ店舗の詳細パネル。Google マップの経路案内へのリンクも出す
-// 第6回: 起点があれば起点からの直線距離も出す
+// 第6回: 起点があれば起点からの直線距離、第10回: 調べた所要時間も出す
// 第7回: Google マップ上の店舗と結びついていれば、営業時間・評価を見られる
import { CATEGORY_META, type Point } from '#shared/types/point'
import { distanceMeters, formatDistance } from '#shared/utils/distance'
@@ -10,6 +10,7 @@ import type { SearchOrigin } from '~/composables/useSearchOrigin'
const props = defineProps<{
point: Point | null
origin?: SearchOrigin | null
+ travelLabel?: string | null
}>()
const emit = defineEmits<{ close: [] }>()
@@ -47,7 +48,7 @@ const directionsUrl = computed(() => {
<dd>{{ point.address || '(未登録)' }}</dd>
<template v-if="distance">
<dt>起点から</dt>
- <dd>直線で約 {{ distance }}</dd>
+ <dd>直線で約 {{ distance }}<template v-if="travelLabel">({{ travelLabel }})</template></dd>
</template>
<template v-if="point.memo">
<dt>お知らせ</dt>
app/pages/index.vue に次の変更を加えます(+ が追加、- が削除)。
app/pages/index.vue の変更(差分)
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -4,9 +4,11 @@
// 第6回: 住所・駅名から起点を決め、いちばん近い店舗を選ぶ(起点は保存しない)。
// 第8回: 業態で絞り込み、左の一覧(起点があれば近い順)と地図のピンを連動させる。
// 第9回: 地図の表示範囲(bbox)内の店舗だけを読み込み、ピンはクラスタリングで表示する。
+// 第10回: 現在地を起点にする・半径で絞り込む・所要時間を調べる。
import type { NearbyPoint, Point } from '#shared/types/point'
import type { GeocodeCandidate } from '#shared/types/geocode'
import { sortByDistance } from '#shared/utils/distance'
+import type { TravelMode } from '~/composables/useTravelTimes'
// 第9回: 表示範囲が変わると query が変わり、useFetch が自動で取り直す(古い要求は取り消される)
const bbox = ref(INITIAL_BBOX)
@@ -18,7 +20,10 @@
const { selectedId, select, clearSelection } = useSelection()
const { origin, setOrigin, clearOrigin } = useSearchOrigin()
const map = shallowRef<google.maps.Map | null>(null)
-const { visibleCategories, filteredPoints, countByCategory } = usePointFilter(points)
+const currentLocation = useCurrentLocation()
+const area = useAreaFilter(map)
+const travel = useTravelTimes()
+const { visibleCategories, filteredPoints, countByCategory } = usePointFilter(points, area.matcher)
// 一覧に並べる順番:起点があれば近い順
const listPoints = computed(() => sortByDistance(filteredPoints.value, origin.value))
@@ -53,6 +58,8 @@
async function moveOrigin(lat: number, lng: number, label: string) {
if (!map.value) return
await setOrigin(map.value, { lat, lng, label })
+ travel.clearTimes() // 起点が変わったら、前の起点の所要時間は使えない
+ area.moveCenter({ lat, lng })
const [first] = await $fetch<NearbyPoint[]>('/api/points/nearest', {
query: { lat, lng, limit: 1 },
})
@@ -76,6 +83,7 @@
function onClearOrigin() {
clearOrigin()
nearest.value = null
+ travel.clearTimes()
}
// 一覧の行を選ぶ → 選択して、そのピンが地図の中央に来るよう移動する
@@ -85,6 +93,29 @@
if (p && map.value) map.value.panTo({ lat: p.lat, lng: p.lng })
}
+// ── 第10回: 現在地・半径・所要時間 ──
+async function onLocate() {
+ const pos = await currentLocation.locate()
+ if (pos) await moveOrigin(pos.lat, pos.lng, '現在地')
+}
+
+// 半径の円は、起点があれば起点、なければ地図の中心に置く
+function onStartCircle() {
+ const center = origin.value ?? map.value?.getCenter()?.toJSON()
+ if (center) area.startCircle({ lat: center.lat, lng: center.lng })
+}
+
+// 一覧の上から(近い順に)最大10件の所要時間を調べる
+function onTravel(mode: TravelMode) {
+ if (!origin.value) return
+ travel.fetchTimes(origin.value, listPoints.value.slice(0, 10).map((p) => p.id), mode)
+}
+
+// 半径の絞り込みで選択中の店舗が外れたら、選択を解除する
+watch(area.matcher, (inArea) => {
+ if (inArea && selectedPoint.value && !inArea(selectedPoint.value)) clearSelection()
+})
+
// 業態の絞り込みで選択中の店舗が非表示になったら、選択を解除する
// (第9回: 地図の移動で範囲外に出ただけなら解除しない)
watch(visibleCategories, (cats) => {
@@ -116,12 +147,30 @@
:shown="filteredPoints.length"
:total="points.length"
/>
+ <AreaTools
+ :mode="area.mode.value"
+ :radius-km="area.radiusKm.value"
+ :locating="currentLocation.locating.value"
+ :location-error="currentLocation.error.value"
+ :accuracy="currentLocation.accuracy.value"
+ :has-origin="origin !== null"
+ :travel-mode="travel.mode.value"
+ :travel-loading="travel.loading.value"
+ :travel-error="travel.error.value"
+ :disabled="!map"
+ @locate="onLocate"
+ @start-circle="onStartCircle"
+ @radius="area.setRadiusKm"
+ @clear="area.clearArea"
+ @travel="onTravel"
+ />
</div>
<div class="map-page__body">
<PointList
:points="listPoints"
:selected-id="selectedId"
:origin="origin"
+ :travel-label="travel.label"
@select="onListSelect"
/>
<ClientOnly>
@@ -130,9 +179,14 @@
<div class="map-placeholder">地図を読み込み中…</div>
</template>
</ClientOnly>
- <PointDetail :point="selectedPoint" :origin="origin" @close="clearSelection">
+ <PointDetail
+ :point="selectedPoint"
+ :origin="origin"
+ :travel-label="selectedPoint ? travel.label(selectedPoint.id) : null"
+ @close="clearSelection"
+ >
<p>地図のピンを選ぶと、ここに店舗の詳細が表示されます。</p>
- <p>住所・駅名を入れると、近い店舗を探せます。</p>
+ <p>住所・駅名を入れるか「現在地から探す」で、近い店舗を探せます。</p>
</PointDetail>
</div>
</div>
ポイントは、現在地も住所検索も moveOrigin に集め、起点が変わったら前の所要時間を消して(travel.clearTimes())円も動かす(area.moveCenter())ことです。所要時間は、近い順で絞り込み後の一覧の先頭10件の ID だけを送ります。useAreaFilter は、円が2つできないようページで1回だけ呼びます。
直線で近い10件が、所要時間でも近いとは限りません。件数を増やせば精度は上がりますが、その分だけ費用も増えます。
app/assets/css/main.css に次の変更を加えます(+ が追加、- が削除)。
--- a/app/assets/css/main.css
+++ b/app/assets/css/main.css
@@ -619,6 +619,54 @@
font-size: 12px;
}
+/* 第10回: 現在地・半径・所要時間 */
+.area-tools {
+ display: flex;
+ flex: 1 1 100%;
+ flex-wrap: wrap;
+ align-items: center;
+ gap: 6px 10px;
+ font-size: 14px;
+}
+
+.area-tools button {
+ padding: 4px 10px;
+ border: 1px solid #d0d7de;
+ border-radius: 6px;
+ background: #fff;
+ font: inherit;
+ cursor: pointer;
+}
+
+.area-tools button[aria-pressed='true'] {
+ border-color: #1a73e8;
+ background: #ddf4ff;
+}
+
+.area-tools button:disabled {
+ opacity: 0.6;
+ cursor: default;
+}
+
+.area-tools__radius {
+ display: flex;
+ align-items: center;
+ gap: 6px;
+}
+
+.area-tools__hint,
+.area-tools__note {
+ margin: 0;
+ color: #57606a;
+ font-size: 13px;
+}
+
+.area-tools__error {
+ margin: 0;
+ color: #cf222e;
+ font-size: 13px;
+}
+
/* 第5回: 管理画面(一覧なしの 地図 + フォーム) */
.map-page__note {
margin: 0;
@@ -636,3 +684,10 @@
grid-template-rows: minmax(360px, 1fr) auto;
}
}
+
+/* 第10回: 所要時間のボタン */
+.area-tools__travel {
+ display: inline-flex;
+ align-items: center;
+ gap: 4px;
+}
動作確認の方法
.envのNUXT_GOOGLE_MAPS_SERVER_KEYに、Routes API を許可したサーバー用キーを設定してnpm run dev→ http://localhost:3000 を開く(localhost は位置情報を使える例外。スマートフォンなど別の端末から試す場合は HTTPS が必要)- 「現在地から探す」→ 許可 → 起点の青い丸が現在地に出て、いちばん近い店舗が選ばれることを確認
- 「半径で絞り込む」→ 円の外の店舗が消え、半径を変えると件数が変わることを確認
- 「徒歩」→ 一覧の上から10件に「徒歩 ◯分」が付くことを確認。Network タブで
/api/travel-timesの送信内容が店舗の ID だけで、サーバー用キーが出ていないことを確認 - 住所検索で別の起点を選ぶ → 所要時間が消え、円が移ることを確認
- 位置情報を「ブロック」にして「現在地から探す」→ メッセージが出ることを確認
筆者の環境では、npm run build と npm run typecheck の成功に加え、ビルド後のサーバーに curl で次を確認しました。
| 確認内容 | 結果 |
|---|---|
| 最初のHTMLの操作パネル | 「現在地から探す」「半径で絞り込む」「徒歩」「車」が、地図の準備前は押せない状態(disabled)で入る |
| サーバー用キーが未設定で所要時間を要求 | 503(「サーバー用APIキー(NUXT_GOOGLE_MAPS_SERVER_KEY)が未設定です」) |
| ダミーのキーで所要時間を要求 | Routes API まで届き、Google から 400「API key not valid」がエラーの配列で返る → 画面向けには 502 |
| 店舗を11件指定 | 400 |
移動手段に TRANSIT を指定 | 400(徒歩・車だけを受け付ける) |
| 存在しない店舗の ID だけを指定 | 404 |
一方、位置情報の許可・拒否、円の表示と編集、内側判定、実際の所要時間の値は、執筆環境に本物のAPIキーとブラウザでの操作環境がないため確認できていません。 日本で徒歩の経路がどの程度返るかも未確認です。ご自身のキーで確かめてください。
つまずきやすい点・セキュリティ上の注意
- フィールドマスクを付け忘れる:必須で、無いとエラーになります。必要な項目だけを指定します
- 徒歩なのに
routingPreferenceを送る:車以外ではエラーになります - エラーを
data.errorだけで読む:Routes API のエラーは配列で返ります - 地図を動かすたびに所要時間を自動で調べる:来訪者の操作の回数だけ課金が増えます。ボタンを押したときだけにします
- HTTP の検証環境で位置情報が動かない:位置情報は HTTPS 必須です
- 位置情報が残る場所に気づかない:現在地は保存しませんが、
/api/points/nearestのクエリとして自社サーバーに届きます。アクセスログ(=要求の記録)に URL が残る設定だと、位置も記録されます
発注者向けメモ
- 所要時間は「起点の数 × 店舗の数」の要素ごとに課金されます。1回のボタンで最大10要素、徒歩と車の両方なら20要素です。件数の上限・ボタンを押したときだけ・回数制限(第12回)・クォータ(1日の上限)で天井を決めます
- 「渋滞を考えた所要時間」「電車での所要時間」は別の検討が必要です。前者は料金の区分が上がり(Pro)、後者は1回の件数が少なく、提供範囲の確認も要ります
- 現在地の取得と半径の判定には Google の追加費用がかかりません。Google の Geolocation API(有料)の提案があれば、ブラウザ標準で足りない理由を確認しましょう。検証環境も HTTPS にしておかないと、受け入れテストで現在地を確認できません
- 位置情報の扱いを説明できるようにしておきましょう。保存しなくても、現在地は自社サーバーと Google に送られます。プライバシーポリシーやアクセスログの扱いは専門家に確認してください
発注者がやることのチェックリストです。
- ☐ 所要時間を出す件数(何件まで)と、移動手段(徒歩・車・電車)を決めた
- ☐ 所要時間の費用が「起点×店舗数」の要素で決まることを理解し、月の上限(クォータ・予算アラート)を決めた
- ☐ 検証環境・本番環境が HTTPS になっていることを確認した
- ☐ 現在地を保存しないこと、送り先(自社サーバー・Google)とアクセスログの扱いを確認した
- ☐ 店舗のある地域で、実際のキーを使って徒歩・車の所要時間が返ることを確かめる担当を決めた
開発会社への確認に使える質問例です。
- 「所要時間は、来訪者のどの操作で、1回に何要素ぶん調べますか?自動で呼ばれる場面はありますか?」
- 「所要時間の API に、店舗以外の地点を指定して呼ばれることはありませんか?」
- 「来訪者の現在地は、どこに送られ、どこかに記録されますか?」
まとめと次回予告
この回では、現在地を起点にし、半径の円の中の店舗だけを残して、近い順10件までの徒歩・車の所要時間を Routes API で調べました。範囲の判定は1つの関数にして業態の絞り込みに重ねる、所要時間はサーバー経由で店舗の ID だけを受け取り保存しない、が押さえどころです。
次回(第11回)は「CSVで既存の店舗台帳を一括取り込みする」です。自社の店舗台帳を CSV で読み込み、緯度・経度を含む行をまとめて登録します。
この連載の記事一覧
この記事は連載「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件)
[…] Google Maps API とNuxtで社内向けの情報集約マップを作る連載の第11回です。前回(第10回)では、現在地からの半径や地図上に描いたエリアで地点を絞り込めるようにしました。今回は、Excel などで管理している既存の台帳をCSVで一括取り込みする画面を作ります。緯度・経度がある行はそのまま登録し、住所しかない行はサーバーで1件ずつ住所を緯度・経度に変換(ジオコーディング)してから登録します。 […]
[…] […]