내향인 지도
서울 실시간 혼잡도 지도
서울시 실시간 인구데이터로 지금 덜 붐비는 자치구와 장소를 SVG 지도에서 한눈에 보여 주는 서비스로, BFF 구조를 통해 서울시 API 응답을 하나로 묶고, 지도 데이터를 SVG로 가공해 확대 애니메이션까지 구현
기간 2026.11 - 진행 중역할 기획·개발기여도 100%
- Next.js
- TypeScript
- Tailwind CSS
- TanStack Query
- Recharts
- mapshaper
- d3-geo
스크린샷
주요 활동
[ BFF를 통한 API 호출 통합 및 캐싱 ]
- 장소 하나에 한 번씩 호출해야 하는 서울시 API를 Route Handler에서 121곳 동시에 모아, 브라우저 요청을 121번에서 1번으로 줄임
- 'use cache'로 서울시 데이터 갱신 주기에 맞춰 5분간 캐싱해, 사용자 수와 관계없이 서울시 API 호출이 5분에 한 번만 일어나도록 함
- 서울시 API 응답을 그대로 내려보내지 않고 화면에 필요한 필드만 서버에서 선별해 전달하여, 브라우저가 받는 응답 크기를 원본 대비 45% 줄임
- 일부 장소가 실패해도 나머지는 보여 주도록 Promise.allSettled를 사용하고, 실패해도 HTTP 200이 오는 API 특성에 맞춰 응답의 결과 코드로 성공 여부를 판별
[ SVG 지도 데이터 가공 ]
- mapshaper로 행정동 경계를 자치구 단위로 합치고, d3-geo로 위경도를 화면 좌표에 투영해 미리 SVG path로 변환해 두고, 브라우저는 계산 없이 그리기만 하도록 설계
- 자치구 정보가 없는 장소를 중심점이 아닌 면적이 가장 많이 겹치는 자치구에 배정해, 경계에 걸친 역이나 공원 등이 옆 자치구로 잘못 배정되지 않도록 함
[ FLIP 기법을 활용한 지도 확대 애니메이션 ]
- 자치구를 누르면 지도가 그 구로 확대되는 애니메이션을, 매 프레임 JS로 viewBox를 바꾸는 대신 FLIP 방식으로 구현
- 새 viewBox를 먼저 적용하고 transform으로 이전 화면처럼 되돌렸다가 풀어 주는 방식이라, 애니메이션 중에도 viewBox가 항상 주소와 일치
[ URL 기반 화면 상태 관리 ]
- 화면 상태를 useState 대신 주소의 쿼리스트링(?gu=중구&place=POI091)에 두어, 새로고침이나 링크 공유 등의 상황에서도 같은 화면을 제공
- 주소 검증은 API 응답을 기다리지 않고 미리 변환해 둔 지도 데이터와 비교해, 데이터를 기다리는 도중 올바른 주소가 첫 화면(/)으로 바뀌어 버리는 문제를 방지
트러블슈팅
[ 선택한 장소의 테두리가 일부만 그려지는 문제 ]
- 상황자치구를 확대한 지도에서 장소를 선택하면 테두리로 표시되는데, 영역이 옆 자치구까지 이어진 장소는 자치구 경계와 맞닿은 쪽에 테두리가 그려지지 않음
- 원인확대 지도에서는 자치구 모양의 clipPath로 장소 영역 중 선택한 자치구 밖으로 나간 부분을 잘라내고 보여 줌. 그래서 이런 장소는 화면에 보이는 가장자리 중 일부가 장소의 원래 경계가 아니라 잘린 자리, 즉 자치구 경계가 됨. 그런데 테두리는 장소의 원래 경계선만 따라 그리고 있어서, 자치구 밖의 경계선은 함께 잘려 나가고 잘린 자리에는 선이 없었음.
- 해결장소 모양의 clipPath를 하나 더 만들어 자치구 경계선을 잘라내고, 장소의 원래 경계선에 더해 자치구 경계선 중 장소와 겹치는 부분도 함께 그리도록 변경. 그 결과 화면에 보이는 장소 영역 전체를 테두리가 빈틈없이 감싸게 됨.
프로젝트 목록으로