이미지 품질 요구사항

이 페이지는 이미지 수집 › 이미지 요구사항의 포맷·해상도 권장을 모듈별로 구체화합니다. precheck와 정식 분석에 공통으로 적용됩니다.

왜 해상도가 중요한가

분석 파이프라인은 먼저 가벼운 게이트 모델로 "이 사진에 분석 대상이 있는가"를 판단합니다. 이 게이트 모델들의 내부 입력 크기가 곧 유의미한 해상도의 하한을 정합니다.

precheck는 이 게이트 단계만 실행합니다. 모델이 입력을 내부 입력 크기로 축소해 처리하므로, precheck 이미지를 게이트 입력 크기(트레드 640px, 사이드월 1280px)보다 키워도 판정에는 거의 도움이 되지 않고 용량과 지연이 늘어납니다.

정식 분석은 게이트를 통과한 뒤 홈 깊이를 재고 각인 글자를 읽습니다. 이 단계는 게이트보다 높은 해상도가 필요하므로 precheck 해상도를 정식 분석 이미지에 그대로 쓰지 마세요. ATRACE가 측정에 사용한 샘플에서는 트레드를 긴 변 1280px까지 줄여도 홈 깊이 측정 오차가 거의 달라지지 않았습니다. 사이드월은 규격 판독이 1280px까지 거의 유지됐지만, DOT처럼 작은 글자는 1920px보다 줄이면 읽지 못하는 경우가 늘었습니다. 같은 샘플에서 JPEG 품질 0.85 이상은 해상도보다 영향이 훨씬 작았습니다. 촬영 환경에 따라 결과가 달라질 수 있으므로 아래 권장 프로필을 기준으로 삼으세요.

권장 프로필

용도별 긴 변 해상도와 JPEG 품질입니다. ATRACE 웹 촬영 화면도 같은 값을 쓰며, 저속 망 프로필은 프로젝트 설정의 데이터 절약 모드에 해당합니다.

• precheck — 지연과 용량을 줄이는 것이 우선입니다. 촬영 직후 판독 가부만 빠르게 확인합니다.
• 정식 분석 — 기본 — 저장하고 측정하는 이미지입니다. 특별한 제약이 없으면 이 프로필로 보내세요.
• 정식 분석 — 저속 망 — 업로드가 느린 현장용입니다. 트레드 해상도와 사이드월 품질만 낮추고 사이드월 해상도는 유지합니다.

용량 참고

안드로이드 기기에서 측정·추정한 장당 중앙값입니다. 기기와 장면에 따라 달라지며, 아이폰은 같은 품질값에서도 압축이 약해 파일이 더 큽니다.

4K 같은 큰 원본은 권장 프로필 크기로 줄여 보내기를 권장합니다. 원본을 그대로 보내면 전송량과 지연이 늘어날 수 있습니다.

크기 상한

권장 해상도로 보내면 상한에 닿을 일이 없습니다. 다만 원본을 그대로 보내는 구현이라면 다음 상한을 지켜야 합니다. 상한을 넘으면 precheck와 정식 분석 모두 400 image_too_large입니다.

• 파일 크기 50MB, 긴 변 16384px까지 받습니다.
• 긴 변이 16384px 이하여도 200MP 모드처럼 화소 수가 지나치게 많은 사진은 거절될 수 있습니다.
• image_url로 보낼 때도 서버가 내려받는 이미지는 50MB까지입니다.

밝기

트레드 사진이 너무 어두우면 그루브(홈)의 경계가 보이지 않아 깊이를 잴 수 없습니다. 이때 정식 분석은 400 photo_too_dark, precheck는 200 { analyzable: false, reason: "photo_too_dark" }를 돌려줍니다.

• 실내·지하 주차장·야간에는 휴대폰 조명(플래시 라이트)을 켜고 촬영하세요.
• 타이어가 차체 그늘에 들어가 있으면 조명을 비추거나 각도를 바꿔 홈 안쪽까지 보이게 하세요.
• 노출을 억지로 올리는 후처리보다 촬영할 때 빛을 확보하는 편이 결과가 좋습니다.
• 재촬영으로 해결되는 거절이므로 사용자에게 "밝은 곳에서 다시 촬영"을 안내하세요.

선명도(흔들림·초점)

트레드 사진이 흔들렸거나 초점이 맞지 않으면 그루브 경계가 뭉개져 깊이를 잴 수 없습니다. 이때 정식 분석은 400 photo_too_blurry, precheck는 200 { analyzable: false, reason: "photo_too_blurry" }를 돌려줍니다.

• 셔터를 누르는 순간 카메라를 고정하세요. 어두운 곳에서는 셔터가 느려져 흔들리기 쉬우므로 조명을 함께 켜세요.
• 너무 가까이 대면 초점이 맞지 않습니다. 트레드를 탭해 초점을 맞춘 뒤 촬영하세요.
• 저장·전송 전에 이미지를 과하게 축소하거나 블러 처리하지 마세요. 정식 분석은 권장 프로필의 해상도면 충분합니다.
• 재촬영으로 해결되는 거절이므로 사용자에게 "카메라를 고정하고 다시 촬영"을 안내하세요.

밝기·선명도 판정은 트레드에만 적용됩니다. 판정 기준은 공개하지 않으며 모델 업데이트에 따라 조정될 수 있으므로, 클라이언트에서 같은 기준을 흉내 내기보다 precheck 결과를 따르세요.

포맷·인코딩

• 포맷: JPEG 또는 PNG.
• 회전 보정 불필요: AI가 시각적으로 회전을 판단하고 리포트 표시 시 바로 세웁니다. 클라이언트가 EXIF 회전을 보정하거나 HEIC/EXIF를 정규화할 필요가 없습니다. AI Engine API를 직접 호출해 자체 화면에 그릴 때는 응답의 tire_rotation으로 호출자가 세웁니다(트레드 그루브 오버레이). 사이드월 text_regions 좌표는 EXIF 방향 태그를 적용하지 않은 원본 픽셀 기준이므로, 화면에 그릴 때는 display_orientation으로 변환해야 합니다(AI Engine API 레퍼런스의 SidewallTextRegion 참고).
• 전송 방식: precheck·AI Engine 직접 호출에는 image **바이트(multipart)**를 권장합니다. URL 방식은 서버가 그 URL을 내려받는 왕복 지연이 더해집니다.

프레이밍 — 잘림에 주의

• 트레드: 홈(그루브)이 프레임을 가로질러 끝까지 이어지도록, 접지면이 화면을 채우게 촬영합니다.
• 사이드월: 규격 각인이 프레임 중앙에 크게 들어오도록 가까이서 촬영합니다.
• 화면을 정사각으로 잘라 올리는 경우, 타이어 특징(트레드 밴드 / 규격 각인)이 잘려 나가지 않도록 프레임 안쪽에 두세요. 가장자리에 걸친 특징은 크롭에서 사라질 수 있습니다.

precheck 해상도와의 관계 (false-pass 주의)

precheck 이미지는 정식 분석에 보낼 사진을 축소해 만드세요. 같은 사진이어야 프레이밍이 같아 precheck 결과가 정식 분석을 대표합니다. 파이프라인은 작은 이미지를 거부하지 않고 업스케일하기 때문에, 권장 프로필의 precheck 크기보다 더 작게 줄이면 precheck만 통과하고 정식 분석에서 실패할 수 있습니다. 사이드월 precheck는 권장 프로필대로 1280px로 보내기를 권장합니다.

precheck 통과가 정식 분석 결과를 보장하지는 않습니다. precheck는 게이트 해상도에서 분석 대상이 있는지만 보므로, 홈 깊이 측정과 글자 판독의 품질은 정식 분석 이미지의 해상도와 선명도가 정합니다.

다음 단계