Repository navigation
Releases: greatrima/roadnameconverter
Releases · greatrima/roadnameconverter
Release list
2.1.8
2.1.7
도로명변환기 2.1.7 업데이트 내역
✨ 새 기능
- 변환 알림: 변환되면 소리와 진동으로 알려 줍니다. 변환하지 못하면 소리 없이 진동이 두 번 울립니다. 설정 › 변환 알림에서 진동과 소리를 따로 끌 수 있습니다.
- 내 수정 기억 (설정 › 인식 보조, 기본 켜짐): 직접 입력하거나 고친 주소의 이름을 기억합니다. 같은 글자가 다시 잘못 읽히면 자동으로 넣어 변환하고, 자주 쓰는 이름을 후보 맨 위에 보여 줍니다. 번지와 동·호수는 저장하지 않고 폰 안에만 보관하며, "기억 지우기"로 지울 수 있습니다.
- 의견 보내기: 설정 › 정보에서 의견을 적어 바로 보낼 수 있습니다.
🎨 메인 화면
- 변환 결과를 두 줄로 보여 줍니다. 시·구는 작게, 도로명(또는 동 이름)과 번호는 크게 나옵니다.
- 결과 주소를 누르면 바로 복사됩니다.
- 카메라를 쓰는 동안 화면이 꺼지지 않습니다.
- 지역과 플래시 버튼을 카메라 화면 위로 옮겨 결과가 더 위에 보입니다.
- 주소를 직접 입력할 때 키보드의 검색 키로 바로 변환합니다.
⚙️ 설정
- 설정 화면을 인식 · 변환 알림 · 주소 검색 · 정보로 정리하고 설명 글을 줄였습니다.
- 주소 검색 API 세 가지는 "주소 검색 API" 한 줄 안으로 모았습니다.
2.1.3
도로명변환기 2.1.3 업데이트 내역
✨ 새 기능 — 인식 보조 (설정 › 인식 보조, 기본 꺼짐)
- 사전 자동 완성: "우정4"만 입력해도 "우정4길" 같은 후보를 보여 줍니다. 후보를 고른 뒤 건물번호만 입력하면 됩니다.
- 부분 인식 보정: 글자가 잘리거나 흐려 "우정4길"이 "우저4긱"으로 읽혀도 주소 사전과 비교해 보정 후보를 보여 줍니다. 틀릴 수 있어 직접 골라야 적용됩니다.
- 음성 입력: 켜면 입력칸 옆에 마이크 버튼이 생깁니다. 주소를 말하면 입력칸에 들어가고, 변환은 직접 누릅니다.
🎨 메인 화면 정리
- 꼭 필요한 글자만 남겼습니다. 진행 상황·출처 안내 문구와 라벨을 없애고, 오류나 선택이 필요할 때만 안내합니다.
- 인식 중 안내 문구가 계속 깜빡이던 문제가 사라졌습니다.
- "인식한 주소"는 입력칸 안에 표시되고, 복사 버튼은 각 칸 옆으로 옮겼습니다.
- 지역을 정하지 않았을 때 "지역 설정 하기"로 표시합니다.
- "주소 변환" 버튼 글자가 잘 보이게 바꾸고, "다시 인식" 버튼에 테두리를 넣었습니다. 버튼 간격도 고르게 맞췄습니다.
- 화면을 위로 올릴 때 버벅이던 문제를 고쳤습니다.
⚙️ 설정
- 기본 지역을 한 화면에서 시·도, 시·군·구, 읍·면·동을 보며 고를 수 있습니다. 메인에서 들어가면 저장 후 바로 돌아옵니다.
- 설정 화면을 한눈에 보기 쉬운 목록으로 정리했습니다.
- 노출 버튼 관리에서 "화면 정지"와 "선택 영역 인식"을 "영역 선택"으로, 두 복사 버튼을 "주소 복사"로 합쳤습니다.
♿ 접근성
- 변환 결과가 바뀌면 TalkBack이 알려 주고, 버튼과 뒤로 가기에 설명을 넣었습니다.
피드백 감사합니다.
후기
오늘 겸배구가 마침 대구분은 지번으로, 소구분은 도로명으로 하는 구역이라 테스트 해봤는데 확실히 반응속도가 많이 빨라진걸 느꼈습니다.
몇몇 텍스트가 인식이 안되서 차라리 음성 입력을 추가해보자 하고 음성인식을 추가하는 김에 실험적으로 인식보조 기능들도 추가했습니다.
메인 화면을 최대한 단조롭게 하여 꼭 필요한 정보만 눈에 들어올 수 있게 개선했습니다.
너무 많은 정보는 사용자에게 피곤함을 줍니다.
2.1.2
도로명변환기 2.1.2 업데이트 내역
✨ 새 기능
- 오프라인 모드: 설정에서 직접 켜면 인터넷 없이 내장 주소 사전으로 변환합니다.
- 볼륨 키 줌: 볼륨 버튼으로 카메라를 확대·축소할 수 있습니다.
- 버튼 표시 설정: 메인 화면에 보일 버튼(지역, 플래시, 지도, 변환, 화면 정지, 영역 인식, 주소 복사)을 고를 수 있습니다.
- 주소 복사 버튼: 입력한 주소와 변환 결과를 각각 복사할 수 있습니다.
- 넓어진 결과 화면: 결과를 위로 올리면 카메라 영역이 접혀 결과를 넓게 볼 수 있고, 키보드가 올라오면 카메라가 자동으로 접힙니다.
- 지하 주소 인식:
강남대로 지하 396같은 주소를 인식합니다.
🎯 주소 인식 개선
가산1길,성수동1가처럼 숫자가 들어간 도로명·동 이름이 잘못 나뉘어 변환에 실패하던 문제를 고쳤습니다.테헤란로 12길 34처럼 띄어 쓴 주소가 다른 주소(테헤란로 12)로 잘못 확정될 수 있던 문제를 고쳤습니다.을지로3가 12처럼 "○가"가 붙은 동 이름도 자동 변환됩니다.- 비슷한 번지(
12와123)가 함께 있을 때 한쪽 후보가 사라지던 문제를 고쳤습니다.
🛠 안정성
- 화면 정지 상태에서 주소 입력창을 누르면 입력과 결과가 지워지던 문제를 고쳤습니다.
- 사진 영역을 확대할 때 드물게 앱이 종료되던 문제를 고쳤습니다.
- API 설정이 없을 때 "변환 중"에서 멈추던 문제를 고쳤습니다. 이제 안내가 표시되고 스캐너 화면은 그대로 유지됩니다.
- 브라우저가 없는 기기에서 업데이트 버튼을 누르면 앱이 종료되던 문제를 고쳤습니다.
- 화면을 회전한 뒤에도 결과와 지도 버튼 상태가 제대로 복원됩니다.
- 응답이 없는 서버를 20초 넘게 기다리지 않습니다.
- 앱을 닫는 중이거나 메모리가 부족할 때 종료되거나 인식이 멈추던 문제를 고쳤습니다.
- 주소 사전 업데이트가 중간에 끊겨도 사전이 손상되지 않습니다.
- 업데이트 안내가 반복해서 뜨던 문제를 고쳤습니다.
- 카메라 권한을 거부한 뒤에도 "설정에서 권한 허용" 버튼으로 다시 허용할 수 있습니다.
⚡ 성능
- 카메라 인식 처리를 화면 처리와 분리해 버벅임을 줄였습니다.
- 결과 스크롤이 더 부드러워졌고, 사진 캡처 때 메모리를 덜 사용합니다.
🎨 화면·접근성
- 앱 전체의 표기를 통일했습니다(도로명변환기, 네이버 지도, 기본 API, 설정됨/설정 안 됨 등).
- 플래시가 켜져 있으면 버튼에 표시됩니다.
- TalkBack이 설정 스위치의 이름과 화면 제목을 읽어 줍니다.
- 다크 모드에서 설정 화면의 테두리 색이 자연스러워졌습니다.
도로명변환기 v2.0.0
도로명변환기 v2.0.0
아마도 이게 최종일 것 같습니다.
더는 개선할 게 안보이네요.
광고라도 달아서 겸직허가 받아야되나? 껄껄
주소 인식 및 검색 개선
- 번지 끝에 하이픈이 남아 있으면 미완성 번호로 판단합니다. OCR 요소를 묶으며 하이픈 앞에 공백이 들어가도 본번만 잘라 검색하지 않습니다.
- 가까운 다음 줄에 실제로 읽힌 부번이 있으면 연결합니다. 단위 없는 뒤쪽 숫자를 임의로 호수로 만들지 않으며, 멀리 떨어진 숫자·다른 열·전화번호·호수만 있는 줄은 연결하지 않습니다.
- 여러 줄로 나뉜 기본주소와 상세주소를 분리합니다. 번지 뒤에 호수나 층수가 있어도 기본주소 검색을 시작합니다.
- 숫자가 포함된 도로명과 다음 줄의 접미사를 복원합니다. 실제로 인식되지 않은 글자나 숫자는 만들지 않습니다.
- 완성된 원문 주소는 사전 조회를 기다리지 않고 검색하고, 최종 변환은 기존의 정확 일치 검증을 유지합니다. 유사 번지를 자동으로 정답 처리하지 않습니다.
화면 및 진단
- 하단 버튼은 왼쪽 ‘주소 변환’, 오른쪽 ‘다시 인식’ 순서입니다.
- 영역 변경 대기·OCR 처리·주소 추출 실패 안내를 실제 상태에 맞게 표시합니다.
- 개발자 모드에서 줄·요소 위치, 연결 및 거부 이유, 기본주소·상세주소를 확인할 수 있습니다. OCR 입력 이미지는 검색 결과와 구분합니다.
- 앱 이름은 ‘도로명변환기’, 버전은
2.0.0입니다. APK 파일명은 수식어 없이RoadNameConverter-v2.0.0.apk를 사용합니다.
검증 및 한계
- 하이픈 앞 공백 때문에 본번만 검색되던 문제를 수정 전 테스트에서 재현하고 수정 후 통과했습니다.
- JVM 회귀 테스트 122개 통과. Android APK 빌드 및 정적 검사 수행.
- OCR 엔진: ML Kit 한국어 16.0.1, CameraX 1.4.2 유지. 내장 사전 및 기본 API 설정은 변경하지 않았습니다.
- 검증은 OCR 문자열·합성 좌표·요소를 이용한 자동 테스트입니다. 제공 사진을 ML Kit로 직접 실행하거나 실기기 촬영·조작을 검증한 것은 아닙니다.
- 번호 경계나 줄 연결이 불명확하면 자동 추측하지 않습니다. 원본에서 하이픈 자체가 인식되지 않은 경우까지 복원할 수는 없습니다.
공개 소스
- Android 앱 소스, 리소스, 내장 사전, 빌드 구성, 테스트, 사전 갱신 도구를 포함합니다.
- 개인 API 인증정보, 로컬 경로 설정, 서명키, 사용자 사진, 작업용 인수인계 문서는 제외합니다. 직접 빌드할 때는 본인의 API 정보를 사용해야 합니다.
v1.12.2
v1.12.1
도로명 변환기 v1.12.0
RoadNameConverter-v1.12.0-precise-scan.apk 를 다운로드 받으시면 됩니다.
도로명변환기 v1.12.0 패치노트
주소 오인식 개선
- 지역·동/리·산 여부·본번·부번을 비교하도록 주소 검증을 강화했습니다.
5를5-1로 바꾸는 등 유사 지번의 자동 변환을 막았습니다.- 정확히 일치하지 않으면 ‘일치하는 주소 없음’을 표시하고, 유사 후보는 직접 선택하도록 변경했습니다.
- 글자 크기가 다른 여러 줄 주소와 줄바꿈으로 끊긴 도로명 인식을 개선했습니다.
- 기본주소와 건물명·동·층·호수를 구분하고, 전화번호 등이 번지로 섞이는 경우를 줄였습니다.
카메라 인식 개선
- 회전·확대·화면 잘림을 고려해 실제 OCR 영역을 화면의 인식칸에 맞췄습니다.
- 인식 실패 시 선택 영역의 대비를 제한적으로 보정해 재시도합니다.
- 이전 프레임이나 늦게 도착한 검색 결과가 현재 주소를 덮어쓰지 않도록 개선했습니다.
화면 정지 및 영역 선택 추가
설정에서 기능을 켜면 촬영 화면에 ‘화면 정지’ 버튼이 표시됩니다.
- 화면을 멈춘 뒤 원하는 주소 영역만 선택해 인식
- 선택 상자 이동·모서리 크기 조절·두 손가락 확대
- ‘선택 영역 인식’으로 재시도
- ‘촬영 재개’ 또는 뒤로가기로 실시간 촬영 복귀
인식에 실패해도 정지 화면은 유지됩니다. 사진은 자동 저장하지 않습니다.
조작 및 안정성 개선
- 주소를 직접 수정하는 동안 OCR이 입력 내용을 덮어쓰지 않도록 했습니다.
- 같은 주소의 반복 검색을 줄이고, 동·호수만 달라지면 기본주소 검색 결과를 재사용합니다.
- ‘다시 인식’으로 기존 인식 상태를 초기화할 수 있습니다.
- 설정에 개발자 모드를 추가했습니다. 켰을 때만 OCR 원문·처리 영역·검색 결과·실패 단계를 표시합니다.
참고
- 기존 기기 내 한국어 OCR 엔진과 내장 사전을 유지했습니다.
- 실제 사진 인식률 및 기기별 터치·확대 조작은 추가 확인이 필요합니다.
- 소스코드와 내장 사전을 GitHub에 공개했습니다. API 인증정보와 서명키는 포함하지 않았습니다.
v1.11.3: Enhance README with application details
사전은 설치 시 최초 자동으로 업데이트 됩니다.
지역별로 제한하는 설정이 정상작동합니다.
그 외에는 1.11.2 버전과 동일합니다.
아마 이게 거의 최종 업데이트 같습니다.
v1.11.2: Enhance README with application details
도로명변환기 v1.11 통합 패치노트
v1.11.0 ~ v1.11.2
주소 인식과 후보 선택을 개선하고, 기본 지역 설정과 연속 스캔 기능을 추가했습니다.
주소 인식 개선
- 전국 행정구역·지명·도로명 관계 사전을 앱에 내장했습니다. 별도 다운로드 없이 사용할 수 있습니다.
- 설정 지역과 주소 문맥을 활용한 문자 오인식 교정을 추가했습니다.
- 여러 줄로 나뉜 주소와 중간에 끊긴 도로명을 복원하도록 개선했습니다.
- 기본주소 뒤의 아파트 동·층·호수 등을 검색에서 제외하도록 개선했습니다.
- 내부 후보 생성과 실제 주소 확인·변환을 구분했습니다.
기본 지역 설정
- 설정에 ‘기본 지역’을 추가했습니다.
- 도 전체 또는 시·군까지만 지정할 수 있으며, 구·읍·면·동 선택은 필수가 아닙니다.
- 각 선택 단계에서 **‘여기까지 저장’**을 누르면 바로 저장됩니다. 더 좁은 지역은 ‘세부 선택’으로 지정할 수 있습니다.
- 읍·면·동·리는 여러 개 선택하거나 제한 없이 사용할 수 있습니다.
- 생략된 지역명은 설정값으로 보완하고, 다른 지역이 명확하게 인식되면 해당 지역을 우선합니다.
- 메인 화면에서 현재 지역을 확인하고 변경할 수 있습니다.
후보 표시 및 변환 속도 개선
- API 응답을 기다리지 않고 내부 사전의 주소 후보를 먼저 표시합니다.
- 하단 정보창에서 최대 3개의 후보를 선택할 수 있습니다.
- 완성된 후보를 누르면 즉시 검색·변환을 시작합니다.
- 확실한 완성 주소는 연속 2회 인식하면 자동 변환합니다.
- 후보 목록이 켜져 있거나 다른 후보가 있다는 이유로 자동 변환이 지연되던 문제를 수정했습니다.
- 일시적인 인식 변화로 후보가 자주 바뀌는 현상을 줄이고, 선택한 결과를 늦은 OCR·API 응답이 덮어쓰지 않도록 개선했습니다.
- 동일 주소의 중복 API 요청을 억제했습니다.
카메라 및 화면 구성 개선
- 상단 카메라 영역을 고정하고 불필요한 안내와 정보를 제거했습니다.
- 전체 영상을 인식한 뒤 걸러내던 방식에서, 네모칸 내부만 잘라 인식하는 방식으로 변경했습니다.
- 카메라 영상과 화면의 좌표 기준을 맞추고, 테두리·둥근 모서리 바깥을 인식용 이미지에서 제외했습니다.
- 하단 정보창은 스크롤할 수 있도록 구성하고 주요 조작 버튼은 고정했습니다.
연속 스캔 및 조작 개선
- 설정에 ‘연속 스캔’ 옵션을 추가했습니다.
- 연속 스캔에서는 명확한 다음 주소가 인식되면 새 주소로 전환합니다.
- 연속 스캔 사용 시 ‘다시 스캔’ 버튼이 ‘일시정지·재개’ 버튼으로 바뀝니다.
- 수동 입력 중 뒤로가기를 누르면 키보드를 먼저 닫도록 개선했습니다.
- 입력란 바깥이나 검색·후보 버튼을 누를 때 키보드가 닫히도록 개선했습니다.
- 시스템 내비게이션 버튼과 제스처 표시의 시인성을 개선했습니다.
주소 사전 업데이트
- APK를 다시 설치하지 않고 사전 파일만 업데이트할 수 있습니다.
- 최초 실행 시 사전 업데이트를 자동 확인하며, 설정에서도 수동 확인할 수 있습니다.
- 다운로드 중이거나 업데이트에 실패해도 기존 사전으로 사용할 수 있습니다.
※ 인터넷 연결 없이도 내부 사전 후보 표시·교정은 사용할 수 있습니다. 실제 주소 확인과 지번↔도로명 변환에는 인터넷 연결 및 API가 필요합니다.