공공데이터로 모은 경매 사진이 흐릿했던 두 가지 이유: 썸네일 파라미터와 합쳐진 사진
공매와 법원경매 물건 정보를 모아서 보여주는 사이트를 운영하고 있습니다. 물건마다 사진이 있어야 방문자가 판단하기 쉬운데, 사진 품질이 문제였습니다. “사진이 너무 흐려서 이대로는 서비스로 내놓기 어렵다”는 판단이 나왔고, 처음에는 데이터 출처 자체의 한계라고 생각했습니다.
그래서 유료 경매 데이터 업체, 지도 서비스의 거리뷰 API까지 조사했습니다. 결론부터 말하면 그쪽은 답이 아니었습니다. 대신 조사하는 과정에서 제 코드에 있던 버그 두 개를 찾았고, 그걸 고치니 사진 대부분이 선명해졌습니다.
외부 대안을 먼저 조사한 결과
| 대안 | 결론 |
|---|---|
| 유료 경매 데이터 API | 결국 같은 법원 감정평가서를 가공해서 제공. 원본 화질이 나아지지 않음 |
| 지도 서비스 거리뷰 | 정적 이미지 API가 없거나, 상업 사이트 게시에 약관상 제약 |
| 유명 유료 경매정보 사이트 | 고화질 사진은 API가 아니라 직원이 현장에 가서 직접 촬영 |
마지막 항목이 핵심이었습니다. 좋은 사진은 데이터 문제가 아니라 사람이 현장에 가는 인건비 문제였습니다. 코드로 해결할 수 있는 범위가 아니라는 걸 알게 되니, 오히려 “그럼 지금 가진 데이터를 최대한 제대로 쓰고 있나”로 관심이 돌아갔습니다.
버그 1: 원본인 줄 알았던 사진이 178×134 썸네일이었다
공매 물건 사진은 공공 API가 주는 이미지 URL로 받아옵니다. 목록 API에 썸네일 URL이 있고, 상세 API에 “사진 목록”이 따로 있어서, 예전에 상세 API의 사진을 “고화질”이라고 생각하고 연결해뒀습니다.
어느 날 “사진을 너무 늘려서 흐린 거 아니야?”라는 말을 듣고 실제 파일 크기를 확인했습니다. 대부분 178×134 픽셀, 8KB였습니다. 그걸 화면에 크게 늘려서 보여주고 있었던 겁니다.
URL을 자세히 보니 파일 서버 주소에 이런 파라미터가 붙어 있었습니다.
...dnldFile.do?...&downloadImageKind=THNL_NM
THNL은 썸네일(thumbnail)의 약자로 보입니다. 목록 API뿐 아니라 상세 API가 주는 URL도 기본값이 썸네일이었습니다. 이 값을 다른 값으로 바꾸면 같은 파일의 원본을 줍니다. 실측해 보니 부동산은 1024×768, 차량은 627×522가 원본이었습니다.
def full_res(url: str) -> str:
return url.replace("downloadImageKind=THNL_NM", "downloadImageKind=ORIGIN_NM")
좋았던 점은 API를 다시 호출할 필요가 없었다는 것입니다. 순수한 URL 문자열 치환이라, 이미 저장된 3만 5천여 건의 사진 주소를 한 번에 바꿀 수 있었습니다. 수집 코드 세 곳에도 같은 함수를 거치게 해서 앞으로 들어오는 사진도 원본으로 저장되게 했습니다.
버그 2: 사진 두 장이 한 장으로 합쳐져 있었다
법원경매 사진은 감정평가서 PDF 안에서 뽑아냅니다. 평가서에는 “사진용지”라는 페이지가 있고, 거기에 건물 사진이 들어 있습니다. 처음 구현에서는 그 페이지를 통째로 이미지로 저장했습니다.
그런데 실제로는 한 페이지에 사진 두 장이 위아래로 들어 있고, 사이에 “본건전경1(동측에서 촬영)” 같은 설명이 있었습니다. 두 장이 합쳐진 세로로 긴 이미지를 가로형 갤러리 칸에 넣으니 작게 눌려서 흐려 보였던 겁니다. 원본 해상도 자체는 낮지 않았습니다.
설명 문구로 사진을 나누려고 했지만 괄호가 있는 경우도 없는 경우도 있어서 텍스트 규칙으로는 불안정했습니다. 대신 이미지 자체를 분석했습니다.
- 이미지를 가로줄 단위로 훑으면서, 줄마다 흰색이 아닌 픽셀의 비율을 계산합니다.
- 사진 영역은 비율이 높고, 설명 문구나 여백은 비율이 낮습니다.
- 비율이 높은 줄이 연속으로 150픽셀 이상 이어지는 구간을 사진 하나로 잘라냅니다.
- 나누기에 실패하면 원래 페이지를 그대로 씁니다.
이 방식은 설명 문구가 어떤 형식이든 상관없이 동작했고, 샘플 페이지의 사진 네 장이 정확히 분리됐습니다.
배운 것
- “화질이 낮다”는 말을 들으면 파일의 실제 픽셀 크기부터 확인합니다. 화면에서 흐린 것과 파일이 작은 것은 다른 문제입니다.
- 공공 API의 이미지 URL에는 크기나 종류를 정하는 파라미터가 숨어 있는 경우가 많습니다. thumb, thnl, small 같은 단어가 보이면 의심해 볼 만합니다.
- 외부 대안 조사도 헛수고가 아니었습니다. 데이터 한계와 코드 문제를 구분할 수 있게 해줬고, 코드로 할 수 있는 일에 집중하게 해줬습니다.