컨텐츠 영역

행정구역 코드 검색 API   

행정구역 코드 검색 API는 통계지리정보시스템에서 사용되고 있는 행정구역의 코드를 검색하는 API입니다.

1. 기본정보

기본정보 내용입니다.
Request URL http://sgis1.kostat.go.kr/OpenAPI2/getAddress.do
호출방법 HTTP GET, HTTP POST
검색결과포맷 JSON

2. 요청문서

2.1 요청문서 구성

행정구역 코드 검색 API의 요청 문서는 인증키, 행정코드, 기준년도로 구성됩니다.

요청문서 구성 내용입니다.
순번 Request Parameter 설명
1 apikey 통계지리정보서비스에서 발급받은 API이용키
2 code 행정코드(전국: 1, 시도: XX, 시군구: XXXXX)
3 base_year 기준년도(ex.2011)
2.2 행정코드 및 기준년도 설정

아래의 표는 행정코드(code) 및 기준년도(base_year)에 적용될 수 있는 값을 설명합니다.

요청문서 구성 내용입니다.
Parameter 요소명 설명
code 1 시도단위의 행정코드를 조회한다.
XX 시도코드(입력한 시도에 포함된 시군구를 조회)
XXXXX 시군구코드(입력한 시군구에 포함된 읍면동을 조회)
base_year 기준년도는 2000~2011년도까지 사용가능.

3. 응답문서

지정된 행정구역에 포함되는 하위 행전구역코드가 응답됩니다.

3.1 응답문서구성

행정구역 코드 검색 API의 응답 문서는 단위 행정구역코드(code)와 단위 행정구역명(name)의 배열로 구성된 data의 JSON파일로 구성됩니다.

요청문서 구성 내용입니다.
순번 Reponse Parameter 설명
1 data code 단위 행정구역코드
name 단위 행정구역명
예제실행하기