도시권 목록
즐겨찾기

(도시화 분석지도) 도시권 목록 제공 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/category.json

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰

응답정보

출력변수 값 설명
district_cd String 도시권역 ID
district_nm String 도시권역명
order_no Integer 순번

호출결과 예제 

                        	{
									"id": "API_1401",
									"result": {
										"list": [
											{
												"district_cd": "UAL001",
												"district_nm": "수도권(서울, 경기, 인천)",
												"order_no": 1
											},
											{
												"district_cd": "UAL002",
												"district_nm": "강원권",
												"order_no": 2
											},
											{
												"district_cd": "UAL003",
												"district_nm": "세종권",
												"order_no": 3
											}
										]
									},
									"errMsg": "Success",
									"errCd": 0,
									"trId": "LlvP_API_1401_1656921267262"
							}

도시/준도시 목록
즐겨찾기

(도시화 분석지도) 도시/준도시 목록 제공 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/list.json

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰
base_year 2015년 : 2015
2016년 : 2016
2017년 : 2017
2018년 : 2018
2019년 : 2019
2020년 : 2020
2021년 : 2021
2022년 : 2022
2023년 : 2023 		선택 연도
district_cd String 선택 도시권역 ID
urban_type 도시:01
준도시:02		 선택 도시 타입

응답정보

출력변수 값 설명
base_year String 연도
urban_cd String 도시 ID
urban_nm String 도시명
urban_type String 도시타입
district_cd String 도시권역 ID

호출결과 예제 

                        	{
								"id": "API_1402",
								"result": {
									"list": [
										{
											"base_year": "2020",
											"urban_nm": "고양시 덕양구(화정1동,주교동,행신4동 등)",
											"district_cd": "UAL001",
											"urban_type": "01",
											"urban_cd": "Center_022"
										},
										{
											"base_year": "2020",
											"urban_nm": "광주시(초월읍,오포읍,탄벌동 등)",
											"district_cd": "UAL001",
											"urban_type": "01",
											"urban_cd": "Center_029"
										},
										{
											"base_year": "2020",
											"urban_nm": "남양주시(진접읍,오남읍)",
											"district_cd": "UAL001",
											"urban_type": "01",
											"urban_cd": "Center_028"
										}
									]
								},
								"errMsg": "Success",
								"errCd": 0,
								"trId": "pnj6_API_1402_1676510106510"
							}

도시/준도시 경계
즐겨찾기

(도시화 분석지도) 도시/준도시 경계 제공 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/boundary.geojson

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰
base_year 2015년 : 2015
2016년 : 2016
2017년 : 2017
2018년 : 2018
2019년 : 2019
2020년 : 2020
2021년 : 2021
2022년 : 2022
2023년 : 2023 		선택 연도
district_cd String 선택 도시권역 ID
urban_type 도시:01
준도시:02		 선택 도시 타입
urban_cd String 선택 도시 ID

응답정보

출력변수 값 설명
features LIST 경계속성정보
type String 경계속성타입
geometry Object 경계정보
   type String 경계타입
   coordinates Object 경계좌표
properties Object 속성정보
   base_year String 연도
   urban_cd String 도시 ID
   urban_nm String 도시명
   urban_type String 도시타입
   district_cd String 도시권역 ID
   area String 면적

호출결과 예제 

                            {
								"type": "FeatureCollection",
								"id": "API_1403",
								"errMsg": "Success",
								"errCd": 0,
								"trId": "7BO=_API_1403_1676510285480",
								"features": [
									{
										"type": "Feature",
										"geometry": {
											"type": "Polygon",
											"coordinates": [
												[
													[941000,1957000],
													[940000,1957000],
													[940000,1958000],
													[939000,1958000],
													[939000,1959000],
													[940000,1959000],
													[940000,1960000],
													[940000,1961000],
													[941000,1961000],
													[941000,1962000],
													[941000,1963000],
													[941000,1964000],
													[942000,1964000],
													[942000,1963000],
													[943000,1963000],
													[943000,1962000],
													[942000,1962000],
													[942000,1961000],
													[942000,1960000],
													[942000,1959000],
													[943000,1959000],
													[943000,1958000],
													[943000,1957000],
													[942000,1957000],
													[941000,1957000]
												]
											]
										},
										"properties": {
											"base_year": "2020",
											"area": "15000000",
											"district_cd": "UAL001",
											"urban_nm": "고양시 덕양구(화정1동,주교동,행신4동 등)",
											"urban_type": "01",
											"urban_cd": "Center_022"
										}
									}
								]
							}

도시별 인구 통계
즐겨찾기

(도시화 분석지도) 도시별 인구 통계 제공 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/ingu/data.json

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰
base_year 2016년 ~ 2023년 필수 연도
urban_cd String 필수 도시 ID

응답정보

출력변수 값 설명
base_yearString연도
urban_cdString도시 ID
urban_nmString도시명
urban_typeString도시타입
district_cdString도시권역 ID
dataObject통계 데이터
tot_cntInteger전체 인구수
man_cntInteger남자 인구
man_rateString남자 비율
woman_cntInteger여자 인구
woman_rateString여자 비율
age_1_cntInteger0~9세
age_2_cntInteger10~19세
age_3_cntInteger20~29세
age_4_cntInteger30~39세
age_5_cntInteger40~49세
age_6_cntInteger50~59세
age_7_cntInteger60~69세
age_8_cntInteger70~79세
age_9_cntInteger80세이상

호출결과 예제 

                        	{
								"id": "API_1404",
								"result": {
									"base_year": "2020",
									"urban_nm": "고양시 덕양구(화정1동,주교동,행신4동 등)",
									"district_cd": "UAL001",
									"data": {
										"woman_cnt": 119905,
										"age_4_cnt": 28178,
										"age_7_cnt": 27990,
										"age_3_cnt": 31493,
										"woman_rate": "51.34",
										"age_9_cnt": 9713,
										"age_2_cnt": 21733,
										"age_6_cnt": 46178,
										"tot_cnt": 233544,
										"age_8_cnt": 15586,
										"age_1_cnt": 14761,
										"man_cnt": 113639,
										"man_rate": "48.66",
										"age_5_cnt": 37912
									},
									"urban_type": "01",
									"urban_cd": "Center_022"
								},
								"errMsg": "Success",
								"errCd": 0,
								"trId": "Z0lW_API_1404_1676510634114"
							}

도시별 가구 통계
즐겨찾기

(도시화 분석지도) 도시별 가구 통계 제공 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/gagu/data.json

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰
base_year 2016년 ~ 2023년 필수 연도
urban_cd String 필수 도시 ID

응답정보

출력변수 값 설명
base_yearString연도
urban_cdString도시 ID
urban_nmString도시명
urban_typeString도시타입
district_cdString도시권역 ID
dataObject통계 데이터
tot_cntInteger총 가구수
family_3_cntInteger친족가구
family_1_cntInteger1인가구
family_2_cntInteger비친족가구

호출결과 예제 

                        	{
								"id": "API_1405",
								"result": {
									"base_year": "2020",
									"urban_nm": "고양시 덕양구(화정1동,주교동,행신4동 등)",
									"district_cd": "UAL001",
									"data": {
										"family_1_cnt": 24699,
										"family_3_cnt": 66655,
										"tot_cnt": 93471,
										"family_2_cnt": 2117
									},
									"urban_type": "01",
									"urban_cd": "Center_022"
								},
								"errMsg": "Success",
								"errCd": 0,
								"trId": "rYES_API_1405_1676510662280"
							}

도시별 주택 통계
즐겨찾기

(도시화 분석지도) 도시별 주택 통계 제공 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/ho/data.json

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰
base_year 2016년 ~ 2023년 필수 연도
urban_cd String 필수 도시 ID

응답정보

출력변수 값 설명
base_yearString연도
urban_cdString도시 ID
urban_nmString도시명
urban_typeString도시타입
district_cdString도시권역 ID
dataObject통계 데이터
tot_cntInteger총 주택수
house_1_cntInteger단독주택
house_2_cntInteger아파트
house_3_cntInteger연립주택
house_4_cntInteger다세대주택
house_5_cntInteger비주거용 건물내 주택

호출결과 예제 

                        	{
								"id": "API_1406",
								"result": {
									"base_year": "2020",
									"urban_nm": "고양시 덕양구(화정1동,주교동,행신4동 등)",
									"district_cd": "UAL001",
									"data": {
										"house_1_cnt": 2232,
										"house_2_cnt": 66036,
										"house_3_cnt": 2982,
										"house_4_cnt": 7052,
										"house_5_cnt": 362,
										"tot_cnt": 78664
									},
									"urban_type": "01",
									"urban_cd": "Center_022"
								},
								"errMsg": "Success",
								"errCd": 0,
								"trId": "0g2R_API_1406_1676510686197"
							}

사업체 통계
즐겨찾기

(도시화 분석지도) 사업체 통계 제공 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/corp/data.json

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰
base_year 2016년 ~ 2023년 필수 연도
urban_cd String 필수 도시 ID

응답정보

출력변수 값 설명
base_yearString연도
urban_cdString도시 ID
urban_nmString도시명
urban_typeString도시타입
district_cdString도시권역 ID
dataObject통계 데이터
tot_corp_cntString총 사업체 수
top3_corp_cntStringTop3 합계 사업체 수
top_1_corp_nmString1위 사업체 소분류명
top_1_corp_cntString1위 사업체 수
top_1_corp_rateString1위 사업체 비율
top_2_corp_nmString2위 사업체 소분류명
top_2_corp_cntString2위 사업체 수
top_2_corp_rateString2위 사업체 비율
top_3_corp_nmString3위 사업체 소분류명
top_3_corp_cntString3위 사업체 수
top_3_corp_rateString3위 사업체 비율
etc_corp_cntString기타 사업체 수
etc_corp_rateString기타 사업체 비율
tot_emp_cntString총 종사자 수
top3_emp_cntStringTop3 합계 종사자 수
top_1_emp_nmString1위 종사자 소분류명
top_1_emp_cntString1위 종사자 수
top_1_emp_rateString1위 종사자 비율
top_2_emp_nmString2위 종사자 소분류명
top_2_emp_cntString2위 종사자 수
top_2_emp_rateString2위 종사자 비율
top_3_emp_nmString3위 종사자 소분류명
top_3_emp_cntString3위 종사자 수
top_3_emp_rateString3위 종사자 비율
etc_emp_cntString기타 종사자 수
etc_emp_rateString기타 종사자 비율

호출결과 예제 

                        	{
								"id": "API_1407",
								"result": {
									"base_year": "2019",
									"urban_nm": "포항시 남구(오천읍,제철동)",
									"district_cd": "UAL008",
									"data": {
										"top_1_emp_rate": "16.2",
										"etc_emp_cnt": "8593",
										"top_3_corp_nm": "미용, 욕탕 및 유사 서비스업",
										"top_3_emp_rate": "6.4",
										"tot_corp_cnt": "3537",
										"top_1_emp_cnt": "1985",
										"top_1_emp_nm": "음식점업",
										"top_2_corp_nm": "주점 및 비알코올 음료점업",
										"etc_corp_cnt": "2250",
										"etc_emp_rate": "70.3",
										"top_1_corp_nm": "음식점업",
										"top_2_emp_nm": "비거주 복지시설 운영업",
										"top_2_corp_cnt": "288",
										"top_2_emp_rate": "7.1",
										"top_1_corp_rate": "20.3",
										"top_2_emp_cnt": "866",
										"top3_emp_cnt": "3637",
										"top_3_emp_nm": "종합 소매업",
										"top_3_corp_rate": "7.9",
										"tot_emp_cnt": "12230",
										"top_2_corp_rate": "8.1",
										"top3_corp_cnt": "1287",
										"top_1_corp_cnt": "718",
										"top_3_emp_cnt": "786",
										"etc_corp_rate": "63.6",
										"top_3_corp_cnt": "281"
									},
									"urban_type": "01",
									"urban_cd": "Center_064"
								},
								"errMsg": "Success",
								"errCd": 0,
								"trId": "DGCR_API_1407_1676510747197"
							}

주요지표 통계
즐겨찾기

(도시화 분석지도) 주요지표 통계 제공 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/to/data.json

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰
base_year 2016년 ~ 2023년 필수 연도
urban_cd String 필수 도시 ID

응답정보

출력변수 값 설명
base_yearString연도
urban_cdString도시 ID
urban_nmString도시명
urban_typeString도시타입
district_cdString도시권역 ID
dataObject통계 데이터
ppltn_density_itmString인구밀도
ppltn_density_allString인구밀도 도시평균
ppltn_density_rankInteger인구밀도 rank
ppltn_density_yearsObject인구밀도 시계열[연도 : 값]
avg_age_itmString평균나이
avg_age_allString평균나이 도시 평균
avg_age_rankInteger평균나이 rank
avg_age_yearsObject평균나이 시계열[연도 : 값]
old_child_ratio_itmString노령화 지수
old_child_ratio_allString노령화 지수 도시 평균
old_child_ratio_rankInteger노령화 지수 rank
old_child_ratio_yearsObject노령화 지수 시계열[연도 : 값]
psn_1_family_per_itmString1인가구 비율
psn_1_family_per_allString1인가구 비율 도시 평균
psn_1_family_per_rankInteger1인가구 비율 순위
psn_1_family_per_yearsString1인가구 비율 시계열 [연도 : 값]
apt_per_itmString아파트 비율
apt_per_allString아파트 비율 도시 평균
apt_per_rankString아파트 비율 순위
apt_per_yearsObject아파트 비율 시계열[연도 : 값]

호출결과 예제 

                        	{
								"id": "API_1408",
								"result": {
									"base_year": "2020",
									"urban_nm": "화성시(향남읍)",
									"district_cd": "UAL001",
									"data": {
										"avg_age_rank": 64,
										"apt_per_years": {
											"2016": "89.5",
											"2017": "89.4",
											"2018": "89.7",
											"2019": "88.1",
											"2020": "88.5",
											"2021": "88.5",
											"2022": "88.4"
										},
										"ppltn_density_itm": "6039.5",
										"apt_per_itm": "88.5",
										"ppltn_density_rank": 47,
										"psn_1_family_per_itm": "33.1",
										"old_child_ratio_rank": 63,
										"old_child_ratio_itm": "30.8",
										"avg_age_all": "40.9",
										"avg_age_years": {
											"2016": "33.2",
											"2017": "33.5",
											"2018": "34.2",
											"2019": "34.8",
											"2020": "35.2",
											"2021": "35.9",
											"2022": "36.6"
										},
										"apt_per_all": "77.7",
										"ppltn_density_years": {
											"2016": "6305.8",
											"2017": "6313.4",
											"2018": "6357.7",
											"2019": "5490.2",
											"2020": "6039.5",
											"2021": "6196.1",
											"2022": "6128"
										},
										"apt_per_rank": 12,
										"psn_1_family_per_rank": 17,
										"psn_1_family_per_all": "29.5",
										"ppltn_density_all": "7377.6",
										"avg_age_itm": "35.2",
										"psn_1_family_per_years": {
											"2016": "27.5",
											"2017": "26",
											"2018": "27.6",
											"2019": "32.2",
											"2020": "33.1",
											"2021": "34.1",
											"2022": "34.6"
										},
										"old_child_ratio_years": {
											"2016": "24",
											"2017": "24.9",
											"2018": "27.2",
											"2019": "29.7",
											"2020": "30.8",
											"2021": "34.3",
											"2022": "38.5"
										},
										"old_child_ratio_all": "94.5"
									},
									"urban_type": "01",
									"urban_cd": "Center_023"
								},
								"errMsg": "Success",
								"errCd": 0,
								"trId": "8uQb_API_1408_1713327968418"
							}

도시별 생활시설 통계
즐겨찾기

(도시화 분석지도) 도시별 생활시설 통계 API

요청주소

https://sgisapi.kostat.go.kr/OpenAPI3/urban/fac/data.json

요청정보(Body)

요청변수 값 Optional 설명
accessToken String 필수 액세스토큰
urban_cd String 필수 도시 ID

응답정보

출력변수 값 설명
urban_cdString도시 ID
urban_nmString도시명
urban_typeString도시타입
district_cdString도시권역 ID
dataObject통계 데이터
middle_schoolInteger중학교
kinder_gardenInteger유치원
elementary_schoolInteger초등학교
high_schoolInteger고등학교
child_centerInteger어린이집
libraryInteger도서관
public_healthInteger보건소
social_welfareInteger사회복지
fire_stationInteger소방서
hospitalInteger병원
police_officeInteger경찰서

호출결과 예제 

                        	{
									"id": "API_1409",
									"result": {
										"urban_nm": "대전 중심부 일대",
										"district_cd": "UAL005",
										"data": {
											"middle_school": 73,
											"kinder_garden": 195,
											"elementary_school": 121,
											"high_school": 41,
											"child_center": 941,
											"library": 71,
											"public_health": 9,
											"social_welfare": 549,
											"fire_station": 28,
											"hospital": 43,
											"police_office": 48
										},
										"urban_type": "01",
										"urban_cd": "Center_016"
									},
									"errMsg": "Success",
									"errCd": 0,
									"trId": "=xrD_API_1409_1699862468950"
                            }