프로젝트 목록으로

내향인 지도

서울 실시간 혼잡도 지도

서울시 실시간 인구데이터로 지금 덜 붐비는 자치구와 장소를 SVG 지도에서 한눈에 보여 주는 서비스로, BFF 구조를 통해 서울시 API 응답을 하나로 묶고, 지도 데이터를 SVG로 가공해 확대 애니메이션까지 구현

기간 2026.11 - 진행 중역할 기획·개발기여도 100%

주요 활동

[ 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를 하나 더 만들어 자치구 경계선을 잘라내고, 장소의 원래 경계선에 더해 자치구 경계선 중 장소와 겹치는 부분도 함께 그리도록 변경. 그 결과 화면에 보이는 장소 영역 전체를 테두리가 빈틈없이 감싸게 됨.

프로젝트 목록으로