주소를 입력하면 실제 지형이 반영된 3D 모델을 생성하고 3D 프린팅용 STL 파일까지 제공하는 서비스
type any address and get a 3D model of the place, with real terrain and an STL you can 3D print
핵심 요약
Claude Code를 활용해 주소만 입력하면 실제 지형 기반의 3D 모델을 생성하고 STL 파일로 출력할 수 있는 오픈소스 프로젝트입니다.
- 3D 모델 생성 — 주소 입력 시 주변 지형과 건물을 3D 모델로 구현함
- STL 파일 지원 — 3D 프린팅을 위한 모델 파일 다운로드 기능을 제공함
- 오픈소스 기반 — OpenStreetMap 데이터를 활용해 브라우저에서 즉시 실행됨
- 개발 과정 공유 — Claude Code를 활용한 테스트 자동화 및 데이터 처리 경험을 공유함
내가 가본 곳들을 3D 모델로 만들어서 건축적 특징도 구경하고 3D 프린트로 뽑아보고 싶었거든. 그래서 Claude Code로 'Your Place'를 만들어봤어.
이게 뭐 하는 거냐면: 주소 입력하면 그 주변 1, 2, 4km를 실제 지형 위에 모델로 뚝딱 만들어줌. 집 위치 찍고, 그 뷰 링크 공유하고, 포스터나 STL 파일로 다운로드도 가능함. 무료고, 가입 필요 없고, 브라우저에서 바로 돌아감: https://yourplace3d.github.io/3d-city/
오픈소스고 OpenStreetMap 데이터를 쓰는데, 이건 자원봉사자들이 직접 손으로 매핑하는 거라 지도 퀄리티가 곧 모델 퀄리티임. 대도시는 디테일한데 시골은 좀 휑할 수 있고, 건물 높이 데이터가 없으면 앱이 알아서 추정해서 몇 층인지 알려줌.
만들면서 배운 점:
- 테스트 코드 짜게 시키고 돌릴 때마다 계속 실행해. 브라우저 테스트가 내가 보기도 전에 버그를 다 잡아내더라. 앱 화면 가리는 "지원하지 않는 브라우저" 창이나 탭 제목에 "undefined" 뜨는 거 같은 거 말이야.
- 샘플 말고 실제 데이터로 테스트해라. 테스트용 도시는 잘 돌아갔는데, 실제 OpenStreetMap 데이터 넣으니까 3D 프린트 파일이 네 군데서 터지더라(타일 경계에서 건물 쪼개짐, 연립주택 벽 공유 문제, 안뜰이랑 벽 겹침, 외곽선 꼬임 등). Claude가 이거 다 고치고 쉘 38,692개를 일일이 검사해서 전부 방수(watertight) 처리 완료함.
- 샌드박스에서 지도 서버 접속이 안 되길래, 실시간 체크 기능을 GitHub Actions로 옮겼어. 영상 렌더링도 거기서 실시간 지도 데이터로 프레임 단위로 뽑아냈고.
- 공개하기 전에 GitHub에 개인정보 남아있는지 확인해달라고 시켜봐. 내가 놓친 것들을 얘가 다 찾아내더라.
코드 (MIT): https://github.com/yourplace3d/3d-city
작업 방식 궁금한 거 있으면 물어봐.
