이 사이트는 행정안전부가 제공하는 도로명주소 영문 API를 사용합니다. 같은 API로 직접 개발하려는 분들을 위해 신청 방법과 호출 예제를 정리했습니다.
1. API 키 신청 (무료)
- business.juso.go.kr 회원가입
- API 신청 → 검색 API → 영문주소 선택
- 개발용 키(90일)는 즉시 발급, 운영용 키는 도메인 등록 후 발급
2. 요청 파라미터
| 파라미터 | 설명 | 필수 |
|---|---|---|
| confmKey | 발급받은 승인키 | O |
| keyword | 검색할 한글 주소 | O |
| currentPage | 페이지 번호 (기본 1) | O |
| countPerPage | 페이지당 결과 수 | O |
| resultType | json 또는 xml | - |
3. 호출 예제 (JSONP)
juso.go.kr 영문 API는 CORS를 지원하지 않으므로 브라우저에서는 JSONP 엔드포인트(addrEngApiJsonp.do)를 사용합니다.
const params = new URLSearchParams({
confmKey: "발급받은_승인키",
currentPage: "1",
countPerPage: "10",
keyword: "세종대로 110",
resultType: "json",
});
const url = "https://business.juso.go.kr/addrlink/addrEngApiJsonp.do?"
+ params.toString() + "&callback=myCb";
function myCb(data) {
const juso = data.results.juso[0];
console.log(juso.roadAddr); // 110 Sejong-daero, Jung-gu, Seoul
console.log(juso.zipNo); // 04524
}
const s = document.createElement("script");
s.src = url;
document.body.appendChild(s);
4. 주요 응답 필드
| 필드 | 설명 |
|---|---|
| roadAddr | 영문 도로명주소 |
| jibunAddr | 영문 지번주소 |
| zipNo | 우편번호(5자리) |
| korAddr | 한글 도로명주소 |
| totalCount | 검색 결과 총 개수 |
더 간단하게 쓰고 싶다면
직접 API를 다루지 않고 변환 기능만 넣고 싶다면 위젯 임베드(블로그에 붙여넣기)로 iframe 한 줄만 붙이면 됩니다.