v1

latestOpenAPI 3.1.02026-07-14320308.9 KB

Geocoding

get/geo/geocoding

Query parameters

versioninteger required
city_dostring required

시/도 명칭입니다.<br>- UTF-8 기반 URL 인코딩 처리를 해야 합니다.<br><br>예) 서울특별시를 URL 인코딩하면, %EC%84%9C%EC%9A%B8%ED%8A%B9%EB%B3%84%EC%8B%9C

gu_gunstring required

군/구 명칭입니다.<br>- UTF-8 기반 URL 인코딩 처리를 해야 합니다.<br>- 세종특별시와 같이 구/군 명칭이 없는 경우 필수가 아닙니다.<br><br>예) 강서구를 URL 인코딩하면, %EA%B0%95%EC%84%9C%EA%B5%AC

dongstring required

- addressFlag : F01(구주소)의 경우 동 명칭입니다.<br>- addressFlag : F02(도로명주소)의 경우 도로명 명칭 입니다.<br>- UTF-8 기반 URL 인코딩 처리를 해야 합니다.<br><br>예) 화곡동을 URL 인코딩하면, %ED%99%94%EA%B3%A1%EB%8F%99

bunjistring

출력 좌표에 해당하는 지번입니다.<br>- UTF-8 기반 URL 인코딩 처리를 해야 합니다.<br>- 형식: 본번-부번, 산<br><br>예) 산1265를 URL 인코딩하면, %EC%82%B01265

detailAddressstring

상세 주소입니다.<br>- UTF-8 기반 URL 인코딩 처리를 해야 합니다.<br><br>예) SK텔레콤을 URL 인코딩하면, SK%ED%85%94%EB%A0%88%EC%BD%A4

addressFlagstring

주소 구분 코드입니다.<br><br><주소 구분 코드><br>F01<br>- 지번주소<br>- 구주소 타입<br><br>F02<br>- 새(도로명) 주소<br>- 새(도로명) 주소 타입<br><br>F00<br>- 구주소, 새(도로명)주소 타입 모두 가능합니다.

coordTypestring

지구 위의 위치를 나타내는 좌표 타입입니다.<br><br><좌표 타입><br>EPSG3857<br>- Google Mercator<br><br>WGS84GEO<br>- 경위도<br><br>KATECH<br>- TM128(Transverse Mercator:횡메카토르): 한국 표준<br><br>BESSELGEO<br>- GCS_Bessel_1841 타원체를 사용<br>- 원점의 경도: 127.002890<br>- 원점의 위도: 38.0000<br>- 축척 계수(Scale_Factor): 1.000<br>- 단위: Degree(도/분/초)<br><br>BESSELTM<br>- Transverse_Mercator 투영법과 GCS_Bessel_1841 타원체를 사용<br>- 원점의 경도: 127.002890<br>- 원점의 위도: 38.0000<br>- 축척 계수( Scale_Factor): 1.000<br>- EAST 방향의 상수: 200000.0<br>- NORTH 방향의 상수: 500000.0<br>- 단위: 미터(m)<br><br>GRS80GEO<br>- GRS_1980 타원체를 사용<br>- 원점의 경도: 127.0000<br>- 원점의 위도: 38.0000<br>- 축척 계수(Scale_Factor): 1.000<br>- 단위: Degree(도/분/초)<br><br>GRS80TM<br>- Transverse_Mercator 투영법과 GRS_1980 타원체를 사용<br>- 원점의 경도: 127.0000<br>- 원점의 위도: 38.0000<br>- 축척계수(Scale_Factor): 1.000<br>- EAST 방향의 상수: 200000.0<br>- NORTH 방향의 상수: 500000.0<br>- 단위:미터(m)

callbackstring

jsonp 포맷에서 사용하는 callback 함수명 정보입니다.<br>application/javascript 일 때 필수로 입력해야 합니다.

Request body

appKeystring required

<a href="https://openapi.sk.com/mypage/project/" target="_blank">마이페이지>앱</a>>앱키(appKey) 탭에서 확인 가능

Response

200

object required