행정안전부 주소 영문변환 API 문서
행정안전부 주소 영문변환 API
행정안전부 실시간 영문주소정보 조회 - 검색API는 한글주소를 영문주소로 변환해 주는 API입니다. 정부에서 제공하는 공공데이터이고 행정안전부 주소정책과에서 제공합니다. 무료이며 이용허락범위에 제한이 없습니다. API를 사용하기 위해서는 먼저 API를 신청해서 승인키를 발급받아야 합니다. 신청하면 휴대폰 문자메시지 등을 이용한 본인인증 절차를 거친 후 즉시 발급됩니다.
요청 주소
메소드
파라메터
API 신청 시 발급받을 수 있는 승인키이며, confirmKey가 아닌confmKey입니다. (예: ACu02JekXBq37VdaxdLfkJgdLf32o897fDkLjDU=)
주소를 검색하기 위한 검색어입니다. 전체 주소를 입력해도 되고 일부만 입력해도 됩니다. 초성만 입력해도 됩니다. (예: 한누리대로 411)
주의할 점은 특정 검색어를 사용할 경우, API에서 이를 해킹 공격으로 간주한다고 합니다. 사용할 수 없는 검색어는 다음과 같습니다. %, =, >, <, OR, SELECT, INSERT, DELETE, UPDATE, CREATE, DROP, EXEC, UNION, FETCH, DECLARE, TRUNCATE
검색결과를 페이지로 나눈다고 했을 때 한 페이지 당 검색결과의 수입니다. 즉 검색결과 중 한 번 요청에 반환받을 항목의 수입니다. 예를 들어 countPerPage가 10인 경우 검색건수가 50건이라고 하면 한 번 요청시 10건씩 반환합니다. 기본값은 10입니다.
검색건수가 countPerPage를 넘을 경우 한 번 요청에 모든 검색결과를 반환받을 수 없습니다. currentPage는 검색결과 중 몇 번째 페이지를 반환받을 지를 정합니다. 기본값은 1입니다.
결과를 무슨 형식으로 가공하여 반환받을 지를 정합니다. xml, json 중 하나를 선택할 수 있습니다. 기본값은 xml입니다.
결과
common 항목
총 검색건수입니다.
검색결과 중 파라메터에서 요청된 페이지 번호입니다.
파라메터에서 요청된 페이지 당 검색결과의 수입니다.
요청을 처리할 때 발생한 에러 코드입니다. 에러가 없었을 경우 0입니다.
에러 메시지입니다. 에러가 없었을 경우 "정상"입니다.
juso 항목
영문 도로명주소입니다. (예: 411 Hannuri-daero, Sejong-si)
영문 지번주소입니다. (예: 539 Eojin-dong, Sejong-si)
우편번호입니다. (예: 30116)
행정구역코드입니다. (예: 3611011000)
도로명코드입니다. (예: 361102000002)
공동주택인지 여부입니다. 1은 공동주택을, 0은 비공동주택을 의미합니다.
영문 시도명입니다. (예: Sejong-si)
영문 시군구명입니다.
영문 읍면동명입니다. (예: Eojin-dong)
영문 법정리명입니다.
영문 도로명입니다. (예: Hannuri-daero)
지하인지 여부입니다. 1은 지하를, 0은 지상을 의미합니다.
건물본번입니다. (예: 411)
건물부번입니다. (예: 0)
산인지 여부입니다. 1은 산을, 0은 대지를 의미합니다.
지번본번(번지)입니다. (예: 539)
지번부번(호)입니다. (예: 0)
한글 도로명주소입니다. (예: 세종특별자치시 한누리대로 411)
예시
curl
curl "https://www.juso.go.kr/addrlink/addrEngApi.do?keyword=한누리대로%20411&resultType=json&confmKey=ACu02JekXBq37VdaxdLfkJgdLf32o897fDkLjDU="
Node.js
fetch("https://www.juso.go.kr/addrlink/addrEngApi.do?keyword=한누리대로%20411&resultType=json&confmKey=ACu02JekXBq37VdaxdLfkJgdLf32o897fDkLjDU=")
.then((response) => response.json())
.then((data) => console.log(data));결과
{
"results": {
"common": {
"errorMessage": "정상",
"countPerPage": "10",
"totalCount": "1",
"errorCode": "0",
"currentPage": "1"
},
"juso": [
{
"zipNo": "30116",
"emdNm": "Eojin-dong",
"rn": "Hannuri-daero",
"jibunAddr": "539 Eojin-dong, Sejong-si",
"siNm": "Sejong-si",
"sggNm": "",
"admCd": "3611011000",
"udrtYn": "0",
"lnbrMnnm": "539",
"roadAddr": "411 Hannuri-daero, Sejong-si",
"korAddr": "세종특별자치시 한누리대로 411",
"lnbrSlno": "0",
"buldMnnm": "411",
"bdKdcd": "0",
"rnMgtSn": "361102000002",
"liNm": "",
"mtYn": "0",
"buldSlno": "0"
},
...
]
}
}