로컬 탐색 제품의 성패는 대부분 화면 하나, 지도에서 갈립니다. 사용자는 "지금 근처에서 무슨 행사가 열리고 있을까?"라는 단순한 질문 하나로 앱을 열고, 지도에서 답을 찾습니다. 핀이 정확하고, 필터가 빠르고, 검색 엔진이 실제로 읽을 수 있는 이벤트 정보를 갖춘 지도를 만드는 것이 이벤트 가이드 서비스의 핵심 개발 작업입니다.
이 글에서는 도시 이벤트 지도를 처음부터 만듭니다. 이벤트 데이터 모델 설계, 장소 주소의 지오코딩, 마커 표시와 클러스터링, 카테고리와 동네별 필터링, 검색 노출까지 차례로 다룹니다. 기본 지도를 렌더링하는 방법은 이미 안다고 가정합니다. 아직 모른다면 웹사이트에 인터랙티브 지도를 추가하는 방법을 먼저 보고, 이벤트에 필요한 부분은 이 글에서 이어 가세요.
장소를 중심으로 이벤트 모델 설계하기
이벤트는 정해진 시간에 특정 장소에서 열립니다. 지도에 올라가는 것은 장소이므로, 데이터 모델의 기준도 장소입니다. 최소한의 이벤트 레코드는 다음과 같습니다.
const event = {
id: 'evt_8471',
title: 'Late Night Jazz at The Vortex',
category: 'live-music',
venue: 'The Vortex Jazz Club, 11 Gillett Square, London N16 8AZ',
coords: null, // 지오코딩으로 한 번만 채움
neighbourhood: null, // 리버스 지오코딩으로 한 번만 채움
startsAt: '2026-07-09T20:30:00Z',
url: 'https://example.com/tickets/8471',
};
두 null 필드가 중요합니다. 지도를 열 때마다 장소를 지오코딩할 필요는 없습니다. 이벤트를 등록하거나 가져올 때 한 번만 지오코딩하고, 좌표를 저장해 고정값으로 쓰세요.
1단계: 장소마다 좌표로 지오코딩하기
지오코딩은 사람이 읽는 주소를 지도에 표시할 수 있는 위도와 경도로 바꿉니다. 장소 문자열을 Geocoding API에 보내고 첫 번째 결과에서 좌표를 읽으세요.
async function geocodeVenue(address) {
const url = new URL('https://gateway.mapmetrics-atlas.net/forward-geocode/');
url.searchParams.set('text', address);
url.searchParams.set('size', '1');
url.searchParams.set('token', API_KEY);
const res = await fetch(url);
const data = await res.json();
const top = data.features?.[0];
if (!top) return null;
const [lon, lat] = top.geometry.coordinates;
return { lat, lon, label: top.properties.label };
}
이 코드는 이벤트가 시스템에 들어오는 저장 시점에 실행하고, 받은 좌표를 레코드에 저장하세요. 핀 위치가 왜 정확해야 하는지, 지붕 중심 좌표가 사람이 실제로 들어가는 출입문과 어떻게 다른지는 건물 출입구 지오코딩에서 자세히 설명합니다.
2단계: 이벤트를 마커로 표시하기
모든 이벤트에 좌표가 있으면 표시는 반복문 하나로 끝납니다. 카테고리마다 다른 색을 지정하면 지도를 한눈에 읽을 수 있습니다.
const CATEGORY_COLORS = {
'live-music': '#E75480',
'theatre': '#006BA6',
'comedy': '#EE7C0E',
'food': '#16A34A',
'nightlife': '#7C3AED',
};
function plotEvents(map, events) {
events.forEach((evt) => {
if (!evt.coords) return;
const popup = new mapmetricsgl.Popup().setHTML(
`<strong>${evt.title}</strong><br>${new Date(evt.startsAt).toLocaleString()}` +
`<br><a href="${evt.url}">Tickets</a>`,
);
new mapmetricsgl.Marker({ color: CATEGORY_COLORS[evt.category] || '#0c3456' })
.setLngLat([evt.coords.lon, evt.coords.lat])
.setPopup(popup)
.addTo(map);
});
}
실제 서비스도 이 패턴을 씁니다. OnlyHere는 런던에서 할 만한 일을 매일 소개하는 가이드입니다. 모든 장소를 지오코딩하고 그날의 이벤트를 인터랙티브 MapAtlas 지도에 표시합니다. 사용자는 긴 목록을 스크롤하지 않고 장소와 동네별로 행사를 둘러봅니다.
3단계: 이벤트가 많아지면 클러스터로 묶기
이벤트가 몇 개뿐이라면 개별 마커로 충분합니다. 하지만 도시 전체 피드는 훨씬 많습니다. 핀이 100~200개를 넘으면 이벤트를 GeoJSON 소스로 옮기고 지도가 클러스터로 묶게 하세요.
map.addSource('events', {
type: 'geojson',
cluster: true,
clusterRadius: 50,
data: {
type: 'FeatureCollection',
features: events.filter((e) => e.coords).map((e) => ({
type: 'Feature',
geometry: { type: 'Point', coordinates: [e.coords.lon, e.coords.lat] },
properties: { title: e.title, category: e.category },
})),
},
});
이제 도심에 행사가 몰린 밤에도 핀 100개가 겹치지 않고 개수가 적힌 원 하나가 보입니다. 사용자가 확대하면 클러스터가 다시 나뉩니다.
4단계: 카테고리와 동네로 필터링하기
필터를 붙이면 이벤트 지도가 이벤트 서비스가 됩니다. 전체 목록을 메모리에 두고 배열을 필터링한 다음, 마커를 직접 다시 만들지 말고 필터링한 결과를 지도 소스에 넘기세요.
function applyFilters(map, allEvents, { category, neighbourhood }) {
const filtered = allEvents.filter((e) =>
(!category || e.category === category) &&
(!neighbourhood || e.neighbourhood === neighbourhood),
);
map.getSource('events').setData({
type: 'FeatureCollection',
features: filtered.filter((e) => e.coords).map((e) => ({
type: 'Feature',
geometry: { type: 'Point', coordinates: [e.coords.lon, e.coords.lat] },
properties: { title: e.title },
})),
});
return filtered;
}
neighbourhood 필드는 장소 좌표를 한 번 리버스 지오코딩해서 행정구역 이름을 저장해 채우세요. 이 값 하나로 동네 선택 메뉴, "이 동네에서 열리는 행사" 보기, 더 깔끔한 목록 페이지를 만들 수 있습니다. 실행 중에 다시 조회할 필요도 없습니다.
5단계: 이벤트 정보를 검색에 노출하기
지도는 이미 앱에 들어온 사람의 질문에만 답합니다. 검색 엔진이나 AI 어시스턴트에 "오늘 밤 Shoreditch에서 열리는 행사"를 묻는 훨씬 많은 사람에게는 아무 도움이 되지 않습니다. 이런 시스템은 화면의 픽셀이 아니라 구조화된 데이터를 읽습니다.
모든 이벤트를 schema.org Event 필드로 마크업하고, 이미 가진 좌표를 다시 쓰세요.
{
"@context": "https://schema.org",
"@type": "Event",
"name": "Late Night Jazz at The Vortex",
"startDate": "2026-07-09T20:30:00Z",
"location": {
"@type": "Place",
"name": "The Vortex Jazz Club",
"geo": { "@type": "GeoCoordinates", "latitude": 51.5462, "longitude": -0.0753 }
}
}
핀을 그리는 좌표가 구조화된 데이터에도 들어가므로, 화면 표시와 검색 노출이 같은 원본 데이터에서 나옵니다. 보기 좋은 지도와 사람들이 실제로 찾아오는 서비스의 차이가 여기에 있습니다. 기계가 읽을 수 있는 위치 데이터가 AI 검색 노출에 왜 중요한지는 지역 비즈니스를 위한 Google AI 개요 가이드를 참고하세요.
정리
도시 이벤트 지도는 다섯 부분으로 이루어집니다. 장소 중심의 데이터 모델, 저장 시점의 지오코딩, 카테고리별 색 마커, 이벤트가 많을 때의 클러스터링, 배열 기반 필터링입니다. 그리고 이 모두가 검색 노출을 담당하는 구조화된 데이터 위에 놓입니다. 이 부분들을 하나의 지리공간 플랫폼에서 만들면 좌표가 지오코더에서 지도로, 다시 스키마로 그대로 이어집니다. 같은 주소를 두 번 조회할 일도, 데이터가 서로 어긋날 일도 없습니다.
MapAtlas는 지오코딩, 리버스 지오코딩, 장소 검색, 지도 렌더링을 EU에서 호스팅하는 GDPR 준수 인프라로 제공합니다. Geocoding API와 Search API를 살펴보고 원하는 도시의 지도를 만들어 보세요.
자주 묻는 질문
도시 이벤트 지도를 만들려면 어떤 데이터가 필요한가요?
이벤트마다 최소한 장소 주소, 카테고리, 시작 시간이 있어야 합니다. 이벤트를 지도 위 핀으로 만드는 것은 주소입니다. 주소를 한 번 지오코딩해 위도와 경도를 얻고, 그 좌표를 저장한 뒤 이벤트를 표시할 때마다 다시 씁니다. 티켓 링크, 이미지, 설명 같은 나머지 정보는 마커 팝업에 붙이는 메타데이터입니다.
장소 주소를 지도 좌표로 어떻게 바꾸나요?
지오코딩 API에 장소 주소 문자열을 보내고, 응답에서 위도와 경도를 읽습니다. MapAtlas Geocoding API를 쓴다면 주소를 텍스트 쿼리로 https://gateway.mapmetrics-atlas.net/forward-geocode/ 에 보내고 첫 번째 결과의 좌표를 사용하세요. 장소는 페이지를 열 때마다가 아니라 이벤트를 등록할 때 한 번만 지오코딩하세요. 그래야 지도가 빠르고 API 사용량도 적습니다.
이벤트 마커를 몇 개까지 표시해야 지도가 느려지지 않나요?
개별 마커는 축소한 화면에서 핀 100~200개 정도까지 부드럽게 표시됩니다. 그보다 많으면 GeoJSON 소스 클러스터링으로 바꾸세요. 클러스터링은 낮은 줌에서 가까운 이벤트를 개수가 적힌 원 하나로 묶고, 사용자가 확대하면 다시 나눕니다. 이벤트가 수백 개인 도시 전체 피드라면 처음부터 클러스터링을 쓰세요.
사용자가 카테고리나 동네별로 이벤트를 필터링하게 하려면 어떻게 하나요?
전체 이벤트 목록을 메모리에 배열로 두고, 항목마다 카테고리와 동네를 붙인 뒤 사용자가 선택할 때마다 배열을 필터링하세요. 그다음 마커를 지우고 다시 만들지 말고, 필터링한 결과로 지도 소스를 갱신하세요. 동네별 보기도 같은 방식입니다. 좌표가 선택한 영역 안에 있는 이벤트나, 리버스 지오코딩으로 얻은 행정구역 이름이 같은 이벤트만 남기면 됩니다.
이벤트 지도에 구조화된 데이터가 왜 필요한가요?
지도는 사람에게 유용하지만, 검색 엔진과 AI 어시스턴트는 구조화된 데이터를 읽습니다. 각 이벤트를 schema.org Event 필드로 마크업하고 장소 이름, 좌표, 시작 시간을 넣어야 '오늘 밤 Shoreditch에서 열리는 행사' 같은 질문의 답변에 이벤트가 나타납니다. 지도에 표시하는 좌표가 구조화된 데이터에도 그대로 들어가므로, 화면 표시와 검색 노출이 같은 원본 데이터에서 나옵니다.

