한국 주소

도로명·지번·우편번호·건물명으로 주소를 찾고, 주소를 좌표로, 좌표를 행정구역으로 바꾼다. 공급자가 달라도 같은 결과 모양이고, 공급자가 거부할 검색어는 묻기 전에 거른다

npm install @duolabs-deux/unit-kr-address

직접 넣어 보기

juso 검색어 규칙

찾은 주소가 없습니다

이름		설명
`JUSO_CONFM_KEY`	선택	도로명주소 검색 API 승인키(주소기반산업지원서비스). juso 어댑터를 쓸 때
`KAKAO_REST_API_KEY`	선택	카카오 개발자 앱의 REST API 키. kakao 어댑터를 쓸 때. 서버에서만 쓴다

id	종류	설명
`juso`	실제	행정안전부 도로명주소 검색. 주소 검색만 한다(좌표 없음). 한 쪽 최대 100건
`kakao`	실제	카카오 로컬. 검색·주소 → 좌표·좌표 → 행정구역. 주소로 안 잡히는 건물·장소 이름은 키워드 검색으로 한 번 더 찾는다
`fake`	가짜	키 없이 결정적으로 답한다. 가상 주소 여섯 개만 안다

종류	언제	할 일
`invalid-input`	검색어가 너무 짧거나 길 때, 공급자가 거부할 글자가 있을 때, 좌표가 대한민국 밖일 때. 밖으로 나가지 않는다	입력 칸에서 바로 알린다
`auth`	키가 없거나 맞지 않을 때, 승인 기간이 끝났을 때	운영자에게 알린다. 주소를 손으로 적게 하는 길을 남긴다
`quota`	호출 한도를 넘었을 때	캐시 TTL 을 늘리고, 타자마다 묻지 말고 잠깐 멈췄을 때 묻는다
`timeout`	공급자가 5초 안에 답하지 않을 때(1회 재시도 뒤)	다시 시도하게 하거나 손으로 적게 한다
`upstream-down`	공급자 서버 오류	timeout 과 같다
`unexpected`	응답 형식이 명세와 다를 때	명세가 바뀌었는지 사람이 확인한다