Geocoding

Query Params

version

int32

required

Defaults to 1

city_do

string

required

Defaults to 서울

시/도 명칭입니다.
- UTF-8 기반 URL 인코딩 처리를 해야 합니다.

예) 서울특별시를 URL 인코딩하면, %EC%84%9C%EC%9A%B8%ED%8A%B9%EB%B3%84%EC%8B%9C

gu_gun

string

required

Defaults to 중구

군/구 명칭입니다.
- UTF-8 기반 URL 인코딩 처리를 해야 합니다.
- 세종특별시와 같이 구/군 명칭이 없는 경우 필수가 아닙니다.

예) 강서구를 URL 인코딩하면, %EA%B0%95%EC%84%9C%EA%B5%AC

dong

string

required

Defaults to 을지로

- addressFlag : F01(구주소)의 경우 동 명칭입니다.
- addressFlag : F02(도로명주소)의 경우 도로명 명칭 입니다.
- UTF-8 기반 URL 인코딩 처리를 해야 합니다.

예) 화곡동을 URL 인코딩하면, %ED%99%94%EA%B3%A1%EB%8F%99

bunji

string

출력 좌표에 해당하는 지번입니다.
- UTF-8 기반 URL 인코딩 처리를 해야 합니다.
- 형식: 본번-부번, 산

예) 산1265를 URL 인코딩하면, %EC%82%B01265

detailAddress

string

상세 주소입니다.
- UTF-8 기반 URL 인코딩 처리를 해야 합니다.

예) SK텔레콤을 URL 인코딩하면, SK%ED%85%94%EB%A0%88%EC%BD%A4

addressFlag

string

Defaults to F02

주소 구분 코드입니다.

<주소 구분 코드>
F01
- 지번주소
- 구주소 타입

F02
- 새(도로명) 주소
- 새(도로명) 주소 타입

F00
- 구주소, 새(도로명)주소 타입 모두 가능합니다.

coordType

string

Defaults to WGS84GEO

지구 위의 위치를 나타내는 좌표 타입입니다.

<좌표 타입>
EPSG3857
- Google Mercator

WGS84GEO
- 경위도

KATECH
- TM128(Transverse Mercator:횡메카토르): 한국 표준

BESSELGEO
- GCS_Bessel_1841 타원체를 사용
- 원점의 경도: 127.002890
- 원점의 위도: 38.0000
- 축척 계수(Scale_Factor): 1.000
- 단위: Degree(도/분/초)

BESSELTM
- Transverse_Mercator 투영법과 GCS_Bessel_1841 타원체를 사용
- 원점의 경도: 127.002890
- 원점의 위도: 38.0000
- 축척 계수( Scale_Factor): 1.000
- EAST 방향의 상수: 200000.0
- NORTH 방향의 상수: 500000.0
- 단위: 미터(m)

GRS80GEO
- GRS_1980 타원체를 사용
- 원점의 경도: 127.0000
- 원점의 위도: 38.0000
- 축척 계수(Scale_Factor): 1.000
- 단위: Degree(도/분/초)

GRS80TM
- Transverse_Mercator 투영법과 GRS_1980 타원체를 사용
- 원점의 경도: 127.0000
- 원점의 위도: 38.0000
- 축척계수(Scale_Factor): 1.000
- EAST 방향의 상수: 200000.0
- NORTH 방향의 상수: 500000.0
- 단위:미터(m)

callback

string

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

Body Params

appKey

string

required

마이페이지>앱>앱키(appKey) 탭에서 확인 가능

xxxxxxxxxx
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geo/geocoding?version=1&city_do=%EC%84%9C%EC%9A%B8&gu_gun=%EC%A4%91%EA%B5%AC&dong=%EC%9D%84%EC%A7%80%EB%A1%9C&addressFlag=F02&coordType=WGS84GEO' \
     --header 'accept: application/json' \
     --header 'appKey: e8wHh2tya84M88aReEpXCa5XTQf3xgo01aZG39k5' \
     --header 'content-type: application/json'

200200

401401