지오코딩 예시

ReversGeocoding

  • REQUEST ( Reverse Geocoding )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geo/reversegeocoding?version=1&lat=EPSG3857%20&lon=EPSG3857%20&coordType=WGS84GEO&addressType=A02&appKey=a15s-iksdu12-sksui2-skq981&newAddressExtend=Y' \
     --header 'Accept: application/json'
  • RESPONSE ( Reverse Geocoding )
NameDate TypeMandatoryExampleDescription
addressInfoNodeN주소 정보입니다.
fullAddressStringN서울시 관악구 청림동 22-13전체 주소입니다.
- ‘addressType = A00’인경우 [행정동,법정동] 순서로 표출되며,
구분자(콤마)로 구분 되여 집니다.
- 예) 서울특별시 강서구 화곡3동,서울특별시 강서구 화곡동 1019-1
addressKeyStringN3004545827구 주소 POI 식별자입니다.
roadAddressKeyStringN4001807949새 주소 POI 식별자입니다.
addressTypeStringNA03주소 타입입니다.

<주소 타입>
A00
- 선택한 좌표계에 해당하는 행정동,법정동 주소 입니다.

A01
- 선택한 좌표게에 해당하는 행정동 입니다.
- 예) 망원2동, 일산1동

A02
- 선택한 좌표계에 해당하는 법정동 주소입니다.
- 예) 방화동, 목동

A03
- 선택한 좌표계에 해당하는 새주소 길입니다.

A04
- 선택한 좌표계에 해당하는 건물 번호입니다.
- 예) 양천로 14길 95-11

A10
선택한 좌표계에 해당하는 행정동+법정동+도로명 주소 입니다.
city_doStringN서울특별시, 부산광역시, 대구광역시주소에서 시/도에 해당하는 명칭입니다.
gu_gunStringN강서구, 부평구, 도봉구, 청원군주소에서 군/구에 해당하는 명칭입니다.
eup_myunStringN언양읍, 부발읍도로명 주소에서 읍/면 에 해당하는 명칭입니다.
adminDongStringN망원2동, 신림3동주소에서 행정동에 해당하는 명칭입니다.
adminDongCodeStringN1150056000 -> ‘화곡3동’행정동 명칭에 해당되는 코드 10자리 입니다.
legalDongStringN방화동, 화곡동, 쌍문동, 서천읍, 종천면주소에서 법정동(읍/면)에 해당하는 명칭입니다.
legalDongCodeStringN1132010500 -> '쌍문동'법정동 명칭에 해당하는 코드 10자리입니다.
- 행정표준코드관리시스템(https://www.code.go.kr)에서 조회가 가능합니다.
riStringN죽전리, 연화리, 송정리주소에서 리에 해당하는 명칭입니다.
roadNameStringN양천로14길, 강남대로주소에서 도로명에 해당하는 명칭입니다.
buildingIndexStringN95-11, 11-11주소 건물번호 부여체계를 기준으로 한 건물에 부여된 일련번호입니다.
buildingNameStringN신장미아파트, 영진그린빌라주소 건물명에 해당하는 집합건물의 명칭입니다.
mappingDistanceNumberN건물 출입문에 해당하는 위치 정보와 입력 좌표 사이의 거리입니다.
roadCodeStringN261104175064 -> '대청북길33번길'주소 도로명에 해당하는 코드 12자리입니다.
- 행정표준코드관리시스템(https://www.code.go.kr)에서 조회가 가능합니다.
bunjiStringN121-12주소에서 번지에 해당 합니다.
adminDongCoordNodeN주소에서 행정동에 해당하는 좌표 입니다.
latStringN위도 좌표입니다.
lonStringN경도 좌표입니다.
latEntrStringN입구점 위도 좌표입니다.
lonEntrStringN입구점 경도 좌표입니다.
legalDongCoordNodeN주소에서 법정동에 해당하는 좌표 입니다.
latStringN위도 좌표입니다.
lonStringN경도 좌표입니다.
latEntrStringN입구점 위도 좌표입니다.
lonEntrStringN입구점 경도 좌표입니다.
roadCoordNodeN주소에서 도로명에 해당하는 좌표 입니다.
latStringN위도 좌표입니다.
lonStringN경도 좌표입니다.
latEntrStringN입구점 위도 좌표입니다.
lonEntrStringN입구점 경도 좌표입니다.
  • ReversGeocoding RESPONSE ( type : javascript )
function(
{ "addressInfo": {
    "fullAddress": "서울시 마포구 상수동",
    "addressKey": "3004545827",
    "roadAddressKey": "4001807949",
    "addressType": "A10",
    "city_do": "서울시",
    "gu_gun": "마포구",
    "eup_myun": "",
    "adminDong": "망원2동",
    "adminDongCode": "1150056000",
    "legalDong": "상수1동",
    "legalDongCode": "1132010500",
    "ri": "죽전리",
    "roadName": "강남대로",
    "buildingIndex": "11-11",
    "buildingName": "영진그린빌라",
    "mappingDistance": 0,
    "roadCode": "261104175064",
    "bunji": "121-12",
    "adminDongCoord":{
    "lat": "37.56624167",
    "lon": "126.90194167",
    "latEntr": "37.56610000",
    "lonEntr": "126.90173889"
    },
    "legalDongCoord":{
    "lat": "37.56624167",
    "lon": "126.90194167",
    "latEntr": "37.56610000",
    "lonEntr": "126.90173889"
    },
    "roadCoord":{
    "lat": "37.56631111",
    "lon": "126.90161389",
    "latEntr": "37.56610000",
    "lonEntr": "126.90173889"
    }
}
)
  • ReversGeocoding RESPONSE ( type : json )
{
  "addressInfo": {
    "fullAddress": "서울시 마포구 상수동",
    "addressKey": "3004545827",
    "roadAddressKey": "4001807949",
    "addressType": "A10",
    "city_do": "서울시",
    "gu_gun": "마포구",
    "eup_myun": "",
    "adminDong": "망원2동",
    "adminDongCode": "1150056000",
    "legalDong": "상수1동",
    "legalDongCode": "1132010500",
    "ri": "죽전리",
    "roadName": "강남대로",
    "buildingIndex": "11-11",
    "buildingName": "영진그린빌라",
    "mappingDistance": 0,
    "roadCode": "261104175064",
    "bunji": "121-12",
    "adminDongCoord":{
    "lat": "37.56624167",
    "lon": "126.90194167",
    "latEntr": "37.56610000",
    "lonEntr": "126.90173889"
    },
    "legalDongCoord":{
    "lat": "37.56624167",
    "lon": "126.90194167",
    "latEntr": "37.56610000",
    "lonEntr": "126.90173889"
    },
    "roadCoord":{
    "lat": "37.56631111",
    "lon": "126.90161389",
    "latEntr": "37.56610000",
    "lonEntr": "126.90173889"
    }
}
  • ReversGeocoding RESPONSE ( type : xml )
<?xml version="1.0" encoding="UTF-8"?> 
<addressinfo> 
<fulladdress><!--[CDATA[서울시 마포구 상수동]]--></fulladdress> 
<addresskey>3004545827</addresskey>
<roadaddresskey>4001807949</roadaddresskey>
<addresstype>A10</addresstype> 
<city_do>서울시</city_do> 
<gu_gun>마포구</gu_gun> 
<eup_myun></eup_myun> 
<admindong>망원2동</admindong> 
<admindongcode>1150056000</admindongcode> 
<legaldong>상수1동</legaldong> 
<legaldongcode>1132010500</legaldongcode> 
<ri>죽전리</ri> 
<roadname>강남대로</roadname> 
<buildingindex>11-11</buildingindex> 
<buildingname>영진그린빌라</buildingname> 
<mappingdistance>0</mappingdistance> 
<roadcode>261104175064</roadcode> 
<bunji>121-12</bunji> </addressinfo>
<admindongcoord>
<lat>37.56624167</lat>
<lon>126.90194167</lon>
<latentr>37.56610000</latentr>
<lonentr>126.90173889</lonentr>
</admindongcoord>
<legaldongcoord>
<lat> 37.56624167</lat>
<lon> 126.90194167</lon>
<latentr> 37.56610000</latentr>
<lonentr> 126.90173889</lonentr>
</legaldongcoord>
<roadcoord>
<lat> 37.56631111</lat>
<lon> 126.90161389</lon>
<latentr> 37.56610000</latentr>
<lonentr> 126.90173889</lonentr>
</roadcoord>
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

Geocoding

  • REQUEST ( Geocoding )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geo/geocoding?version=1&city_do=%EC%84%9C%EC%9A%B8%ED%8A%B9%EB%B3%84%EC%8B%9C&gu_gun=%EA%B0%95%EC%84%9C%EA%B5%AC&dong=%ED%99%94%EA%B3%A1%EB%8F%99&addressFlag=F01&coordType=WGS84GEO&appKey=159sq-s9e7h-kauwq-jks9y' \
     --header 'Accept: application/json'
  • RESPONSE ( Geocoding )
NameDate TypeMandatoryExampleDescription
coordinateInfoNodeN좌표 정보입니다.
coordTypeStringN지구 위의 위치를 나타내는 좌표 타입입니다.

<좌표 타입>
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)
addressFlagStringN주소 구분 코드입니다.

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

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

F00
- 구주소, 새(도로명)주소 타입
matchFlagStringN매칭 구분 코드입니다.

<매칭 구분 코드>
M11
- 법정동 정매칭
- 법정동 코드 + 지번이 모두 일치

M12
- 법정동 부지번 근사 매칭
- 법정동 코드 + 지번의 주번이 같고 부번이 ±5 이내로 부번과 일치

M13
- 법정동 주지번 근사 매칭
- 법정동 코드 + 지번의 주번이 동일하지 않고 ±5 이내로 주번과 일치

M21
- 행정동 정매칭
- 행정동 코드 + 지번이 모두 일치

M22
- 행정동 부지번 근사 매칭
- 행정동 코드 + 지번의 주번이 같고 부번이 ±5 이내로 부번과 일치

M23
- 행정동 주지번 근사 매칭
- 행정동 코드 + 지번의 주번이 동일하지 않고 ±5 이내로 주번과 일치

M31
- 법정리 중심 매칭
- 읍/면/동/리의 중심 매칭

M32
- 행정동의 중심 매칭

M33
- 법정동의 중심 매칭

M41:
- 법정동 코드 + 건물명칭이 일치(동일 법정동 내 동일 건물명이 없다는 전제)

행정동 코드및 법정동 코드는 행정표준코드관리시스템(https://www.code.go.kr)에서 조회가 가능합니다.
latNumberN위도 좌표입니다
lonNumberN경도 좌표입니다
city_doStringN서울시, 부산광역시, 대구광역시출력 좌표에 해당하는 시/도 명칭입니다
gu_gunStringN강서구, 부평구, 도봉구출력 좌표에 해당하는 군/구 명칭입니다.
eup_myunStringN언양읍, 부발읍출력 좌표에 해당하는 도로명 주소 읍면동 명칭입니다.
legalDongStringN방화동, 화곡동, 쌍문동출력 좌표에 해당하는 법정동 명칭입니다.
legalDongCodeStringN1132010500 -> '쌍문동'법정동 명칭에 해당하는 코드 10자리입니다.
- 행정표준코드관리시스템(https://www.code.go.kr)에서 조회가 가능합니다.
adminDongStringN방화1동, 방화2동, 화곡1동, 화곡2동출력 좌표에 해당하는 행정동 명칭입니다.
adminDongCodeStringN1150056000 -> ‘화곡3동’행정동 명칭에 해당되는 코드 10자리 입니다.
riStringN죽전리, 연화리, 송정리출력 좌표에 해당하는 리 명칭입니다.
bunjiStringN1-1, 2-1출력 좌표에 해당하는 지번입니다.
newMatchFlagStringN새(도로명) 주소 좌표 매칭 구분입니다.

<매칭 구분 코드>

N51
- 새(도로명) 주소 정매칭입니다.
- 새(도로명) 주소 도로명이 일치하고 건물의 주번/부번이 모두 일치

N52
- 새(도로명) 주소 근사 매칭(2차 종속)
- 2차 종속도로에서 주번이 같고 부번이 다름(직전 부번[좌/우 구분]의 끝 좌표를 반환)

N53
- 새(도로명) 주소 근사 매칭(1차 종속)
- 1차 종속도로에서 주번이 같고 부번이 다름(직전 부번[좌/구 구분]의 끝 좌표를 반환)

N54
- 새(도로명) 주소 근사 매칭(0차 종속)
- 0차 종속도로에서 주번이 같은 것이 없어서 가장 가까운 직전 주번[좌/우 구분]의 가장 끝 좌표

N55
- 새(도로명) 주소 길 중심 매칭
- 새(도로명) 주소 도로명은 일치하나 주번/부번의 직전 근사값이 없는 경우, 새(도로명) 주소 길 중심 좌표를 반환

N61
- 새(도로명) 주소 도로명이 틀리나 동일구 내 1개의 건물명과 일치하는 경우, 해당하는 건물 좌표를 반환

N62
- 새주소 도로명이 틀리나 동일구 내 1개의 건물명과 동명이 일치하는 경우, 해당하는 건물 좌표를 반환
newLonNumberN새(도로명) 주소 매칭을 한 경우, 경도 좌표를 반환합니다.
newLatNumberN새(도로명) 주소 매칭을 한 경우, 위도 좌표를 반환합니다.
newRoadNameStringN새(도로명) 주소 매칭을 한 경우, 길 이름을 반환합니다.
newBuildngIndexStringN새(도로명) 주소 매칭을 한 경우, 건물 번호를 반환합니다.
newBuildngNameStringN새(도로명) 주소 건물명 매칭을 한 경우, 건물 이름을 반환합니다.
newBuildngCateNameStringN우, 건물군 이름을 반환합니다.
remainderStringN정매치 시
주소매칭에 사용되고
남은 주소에 대한 나머지 주소입니다.
< 정매칭인 경우 >
-matchFlag=M11,M21
-newMatchFlag=N51
  • Geocoding RESPONSE ( type : javascript )
function({"coordinateInfo": {
    "coordType": "C01",
    "addressFlag": "F01",
    "matchFlag": "M01",
    "lat": "37.547018160513865",
    "lon": "126.9288940941746",
    "city_do": "서울시",
    "gu_gun": "마포구",
    "eup_myun": "",
    "legalDong": "상수동",
    "legalDongCode": "1132010500",
    "adminDong": "상수동",
    "adminDongCode": "1150056000",
    "ri": "",
    "bunji": "101",
    "newMatchFlag": "NM01",
    "newLat": "37.547064945673384",
    "newLon": "126.92881362789741",
    "newRoadName": "상수로",
    "newBuildngIndex": "1",
    "newBuildngName": "홍익빌딩",
    "newBuildngCateName": "",
    "remainder": ""
      }
  }
)
  • Geocoding RESPONSE ( type : json)
{
  "coordinateInfo": {
  "coordType": "C01",
  "addressFlag": "F01",
  "matchFlag": "M01",
  "lat": "37.547018160513865",
  "lon": "126.9288940941746",
  "city_do": "서울시",
  "gu_gun": "마포구",
  "eup_myun": "",
  "legalDong": "상수동",
  "legalDongCode": "1132010500",
  "adminDong": "상수동",
  "adminDongCode": "1150056000",
  "ri": "",
  "bunji": "101",
  "newMatchFlag": "NM01",
  "newLat": "37.547064945673384",
  "newLon": "126.92881362789741",
  "newRoadName": "상수로",
  "newBuildngIndex": "1",
  "newBuildngName": "홍익빌딩",
  "newBuildngCateName": "",
  "remainder": ""
   
    }
}
  • Geocoding RESPONSE ( type : xml)
<?xml version="1.0" encoding="UTF-8"?>
<coordinateinfo>
    <coordtype>C01</coordtype>
    <addressflag>F01</addressflag>
    <matchflag>M01</matchflag>
    <lat>37.547018160513865</lat>
    <lon>126.9288940941746</lon>
    <city_do>서울시</city_do>
    <gu_gun>마포구</gu_gun>
    <eup_myun></eup_myun>
    <legaldong>상수동</legaldong>
    <legaldongcode>1132010500</legaldongcode>
    <admindong>상수동</admindong>
    <admindongcode>1150056000</admindongcode>
    <ri></ri>
    <bunji>101</bunji>
    <newmatchflag>NM01</newmatchflag>
    <newlat>37.547064945673384</newlat>
    <newlon>126.92881362789741</newlon>
    <newroadname>상수로</newroadname>
    <newbuildngindex>01</newbuildngindex>
    <newbuildngname>홍익빌딩</newbuildngname>
    <newbuildngcatename></newbuildngcatename>
    <remainder></remainder>
</coordinateinfo>

Full Text Geocoding

  • REQUEST ( Full Text Geocoding )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geo/fullAddrGeo?addressFlag=F01&coordType=WGS84GEO&version=1&fullAddr=%EC%84%9C%EC%9A%B8%EC%8B%9C+%EA%B0%95%EB%82%A8%EA%B5%AC+%EC%8B%A0%EC%82%AC%EB%8F%99&page=1&count=20&appKey=ja09q-skpz8-2j1ks-920kas' \
     --header 'Accept: application/json'
  • RESPONSE ( Full Text Geocoding )
NameDate TypeMandatoryExampleDescription
coordinateInfoNodeN좌표 정보입니다.
coordTypeStringN지구 위의 위치를 나타내는 좌표 타입입니다.

<좌표 타입>
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)
addressFlagStringN주소 구분 코드입니다.

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

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

F00
- 구주소, 새(도로명)주소 타입
pageStringY페이지 번호 입니다.
countStringY페이지당 출력 갯수 입니다.
totalCountStringY전체 조회된 수 입니다.
coordinateNodeN좌표 정보 입니다.
matchFlagStringN매칭 구분 코드입니다.

<매칭 구분 코드>
M11
- 법정동 정매칭
- 법정동 코드 + 지번이 모두 일치

M12
- 법정동 부지번 근사 매칭
- 법정동 코드 + 지번의 주번이 같고 부번이 ±5 이내로 부번과 일치

M13
- 법정동 주지번 근사 매칭
- 법정동 코드 + 지번의 주번이 동일하지 않고 ±5 이내로 주번과 일치

M21
- 행정동 정매칭
- 행정동 코드 + 지번이 모두 일치

M22
- 행정동 부지번 근사 매칭
- 행정동 코드 + 지번의 주번이 같고 부번이 ±5 이내로 부번과 일치

M23
- 행정동 주지번 근사 매칭
- 행정동 코드 + 지번의 주번이 동일하지 않고 ±5 이내로 주번과 일치

M31
- 법정리 중심 매칭
- 읍/면/동/리의 중심 매칭

M32
- 행정동의 중심 매칭

M33
- 법정동의 중심 매칭

M41:
- 법정동 코드 + 건물명칭이 일치(동일 법정동 내 동일 건물명이 없다는 전제)

M42 :
- 법정동 코드 + 건물 동이 매칭
latNumberN위도 좌표입니다.
lonNumberN경도 좌표입니다.
latEntrNumberN주소 입구점 위도 좌표입니다.
lonEntrNumberN주소 입구점 경도 좌표입니다.
city_doStringN서울시, 부산광역시, 대구광역시출력 좌표에 해당하는 시/도 명칭입니다.
gu_gunStringN강서구, 부평구, 도봉구출력 좌표에 해당하는 군/구 명칭입니다.
eup_myunStringN옥천읍, 산청읍, 물금읍출력 좌표에 해당하는 주소 읍면동 명칭입니다.
legalDongStringN방화동, 화곡동, 쌍문동출력 좌표에 해당하는 법정동 명칭입니다.
- 읍면 단위인 경우 법정동 명칭이 나갈 수 있으며 읍면 필드와 중복될 수 있습니다.
legalDongCodeStringN1132010500 -> '쌍문동'법정동 명칭에 해당하는 코드 10자리입니다.
- 행정표준코드관리시스템(https://www.code.go.kr)에서 조회가 가능합니다.
adminDongStringN방화1동, 방화2동, 화곡1동, 화곡2동출력 좌표에 해당하는 행정동 명칭입니다.
- 읍면 단위인 경우 행정동 명칭이 나갈 수 있으며 읍면 필드와 중복될 수 있습니다.
adminDongCodeStringN1150056000 -> ‘화곡3동’행정동 명칭에 해당되는 코드 10자리 입니다.
riStringN금구리, 지리, 대포리출력 좌표에 해당하는 리 명칭입니다.
bunjiStringN1-1, 2-1출력 좌표에 해당하는 지번입니다.
buildingNameStringN구주소 매칭을 한 경우 건물 명을 반환합니다.
buildingDongStringN구주소 매칭을 한 경우 건물 동을 반환합니다.
newMatchFlagStringN새(도로명) 주소 좌표 매칭 구분입니다.

<매칭 구분 코드>

N51
- 새(도로명) 주소 정매칭입니다.
- 새(도로명) 주소 도로명이 일치하고 건물의 주번/부번이 모두 일치

N52
- 새(도로명) 주소 근사 매칭(2차 종속)
- 2차 종속도로에서 주번이 같고 부번이 다름(직전 부번[좌/우 구분]의 끝 좌표를 반환)

N53
- 새(도로명) 주소 근사 매칭(1차 종속)
- 1차 종속도로에서 주번이 같고 부번이 다름(직전 부번[좌/구 구분]의 끝 좌표를 반환)

N54
- 새(도로명) 주소 근사 매칭(0차 종속)
- 0차 종속도로에서 주번이 같은 것이 없어서 가장 가까운 직전 주번[좌/우 구분]의 가장 끝 좌표

N55
- 새(도로명) 주소 길 중심 매칭
- 새(도로명) 주소 도로명은 일치하나 주번/부번의 직전 근사값이 없는 경우, 새(도로명) 주소 길 중심 좌표를 반환

N61
- 새(도로명) 주소 도로명이 틀리나 동일구 내 1개의 건물명과 일치하는 경우, 해당하는 건물 좌표를 반환

N62
- 새주소 도로명이 틀리나 동일구 내 1개의 건물명과 동명이 일치하는 경우, 해당하는 건물 좌표를 반환
newLatNumberN새주소 매칭을 한 경우, 새주소 위도 좌표를 반환합니다.
newLonNumberN새주소 매칭을 한 경우, 새주소 경도 좌표를 반환합니다.
newLatEntrNumberN새주소 매칭을 한 경우, 새주소 위도 입구점 좌표를 반환합니다.
newLonEntrNumberN새주소 매칭을 한 경우, 새주소 경도 입구점 좌표를 반환합니다.
newRoadNameStringN새(도로명) 주소 매칭을 한 경우, 길 이름을 반환합니다.
newBuildingIndexStringN새(도로명) 주소 매칭을 한 경우, 건물 번호를 반환합니다.
newBuildingNameStringN새(도로명) 주소 건물명 매칭을 한 경우, 건물 이름을 반환합니다.
newBuildingDongStringN새주소 건물을 매칭한 경우 새주소 건물 동을 반환 합니다
newBuildingCateNameStringN
zipcodeStringN우편번호
remainderStringN정매치 시
주소매칭에 사용되고
남은 주소에 대한 나머지 주소입니다.
< 정매칭인 경우 >
-matchFlag=M11,M21
-newMatchFlag=N51
  • Full Text Geocoding RESPONSE ( type : json )
{
    "coordinateInfo":{
        "coordType": "WGS84GEO",
        "addressFlag": "F00",
        "page": "1",
        "count": "20",
        "totalCount": "1",
        "coordinate":[
            {
                "matchFlag": "",
                "lat": "",
                "lon": "",
                "latEntr": "",
                "lonEntr": "",
                "city_do": "서울특별시",
                "gu_gun": "영등포구",
                "eup_myun": "",
                "legalDong": "",
                "legalDongCode": "",
                "adminDong": "",
                "adminDongCode": "",
                "ri": "",
                "bunji": "",
                "buildingName": "당산 삼성 래미안",
                "buildingDong": "410동",
                "newMatchFlag": "N51",
                "newLat": "37.532201",
                "newLon": "126.902556",
                "newLatEntr": "37.532775",
                "newLonEntr": "126.901322",
                "newRoadName": "당산로",
                "newBuildingIndex": "214",
                "newBuildingName": "당산 삼성 래미안",
                "newBuildingCateName": "",
                "newBuildingDong": "410동",
                "zipcode": "07214",
                "remainder": "삼성래미안4차아파트 410동 2002호"
            }
        ]
    }
}
  • Full Text Geocoding RESPONSE ( type : xml )
<?xml version="1.0" encoding="UTF-8"?>
<document>
    <coordinateinfo>
        <coordtype>WGS84GEO</coordtype>
        <addressflag>F00</addressflag>
        <page>1</page>
        <count>20</count>
        <totalcount>1</totalcount>
        <coordinate>
            <city_do>서울특별시</city_do>
            <gu_gun>영등포구</gu_gun>
            <buildingname>당산 삼성 래미안</buildingname>
            <buildingdong>410동</buildingdong>
            <newmatchflag>N51</newmatchflag>
            <newlat>37.532201</newlat>
            <newlon>126.902556</newlon>
            <newlatentr>37.532775</newlatentr>
            <newlonentr>126.901322</newlonentr>
            <newroadname>당산로</newroadname>
            <newbuildingindex>214</newbuildingindex>
            <newbuildingname>당산 삼성 래미안</newbuildingname>
            <newbuildingdong>410동</newbuildingdong>
            <zipcode>07214</zipcode>
            <remainder>삼성래미안4차아파트 410동 2002호</remainder>
        </coordinate>
    </coordinateinfo>
</document>

좌표변환

  • REQUEST ( 좌표변환 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geo/coordconvert?version=1&lat=EPSG3857%20&lon=EPSG3857%20&fromCoord=WGS84GEO&toCoord=WGS84GEO&appKey=jska0-92js8-kla172-28j17' \
     --header 'Accept: application/json'
  • RESPONSE ( 좌표변환 )
NameDate TypeMandatoryExampleDescription
coordinateNodeY좌표 정보입니다.
latNumberY지구위의 위치를 나타내는 위도 좌표입니다.
lonNumberY지구위의 위치를 나타내는 경도 좌표입니다.
  • 좌표변환 RESPONSE ( type : javascript )
function (
    {"coordinate": {
        "lat": 37.5446283608815,
        "lon": 126.83529138565
    }}
)
  • 좌표변환 RESPONSE ( type : json)
{
  "coordinate": {
    "lat": 37.5446283608815,
    "lon": 126.83529138565
  }
}
  • 좌표변환 RESPONSE ( type : xml)
<?xml version="1.0" encoding="UTF-8"?>
<coordinate>
    <lat>37.5446283608815</lat>
    <lon>126.83529138565</lon>
</coordinate>
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

주소 변환

  • REQUEST ( 주소 변환 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geo/convertAddress?version=1&searchTypCd=NtoO%20&reqAdd=reqAdd&reqMulti=S&appKey=js012-sks8i-101jss-ska982' \
     --header 'Accept: application/json'
  • RESPONSE ( 주소 변환 )
NameDate TypeMandatoryExampleDescription
ConvertAddNodeY주소변환 상세정보
resCountNumberY응답 총개수
resMultiStringY변환 주소 다중 응답 판정
- M : 복수건 응답
- S : 단건 응답
reqAddressStringY요청주소 입력값 기준 주소
- N : 새주소
- O : 구주소(법정동)
upperDistCodeStringY[공용] 대분류 코드
upperDistNameStringY[공용] 대분류 명칭(구주소/새주소)
middleDistCodeStringY[공용] 중분류 코드
middleDistNameStringY[공용] 중분류 명칭(구주소/새주소)
legalLowerDistCodeStringY법정 소분류 코드(구주소)
legalLowerDistNameStringY법정 소분류 명칭(구주소)
legalDetailCodeStringY법정 세분류 코드(구주소)
legalDetailNameStringY법정 세분류 명칭(구주소)
adminLowerDistCodeStringY행정 소분류 코드(구주소)
adminDistNameStringY행정 소분류 명칭(구주소)
primaryStringY본번(구주소)
secondaryStringY부번(구주소)
mlClassStringY산/대지구분(구주소)
oldLatStringY중심 X좌표(구주소)
oldLonStringY중심 Y좌표(구주소)
newAddressListNodeY새주소 리스트
newAddressNodeY새주소
newLatStringY중심 X좌표(새주소)
newLonStringY중심 Y좌표(새주소)
roadNameStringY도로명(새주소)
bldNo1StringY건물번호1(새주소)
bldNo2StringY건물번호2(새주소)
roadIdStringY도로명 코드(새주소)
  • 주소 변환 RESPONSE ( type : javascript )
function (
{
    "ConvertAdd":{
     "resCount": "1",
     "resMulti": "S",
     "reqAddress": "O",
     "upperDistCode": "41",
     "upperDistName": "경기",
     "middleDistCode": "410",
     "middleDistName": "군포시",
     "legalLowerDistCode": "105",
     "legalLowerDistName": "금정동",
     "legalDetailCode": "00",
     "legalDetailName": "",
     "adminLowerDistCode": "570",
     "adminDistName": "null",
     "primary": "744",
     "secondary": "1",
     "mlClass": "1",
     "oldLat":"37.361616",
     "oldLon":"126.940224",
     "newAddressList":{
         "newAddress":[
             {
             "newLat":"37.361616",
             "newLon":"126.940224",
             "roadName":"번영로",
             "bldNo1":"580",
             "bldNo2":"0",
             "roadId":"00220"
             }
         ]
     }
    }
}
)
  • 주소 변환 RESPONSE ( type : json)
{
    "ConvertAdd":{
         "resCount": "1",
         "resMulti": "S",
         "reqAddress": "O",
         "upperDistCode": "41",
         "upperDistName": "경기",
         "middleDistCode": "410",
         "middleDistName": "군포시",
         "legalLowerDistCode": "105",
         "legalLowerDistName": "금정동",
         "legalDetailCode": "00",
         "legalDetailName": "",
         "adminLowerDistCode": "570",
         "adminDistName": "null",
         "primary": "744",
         "secondary": "1",
         "mlClass": "1",
         "oldLat":"37.361616",
         "oldLon":"126.940224",
         "newAddressList":{
             "newAddress":[
             {
             "newLat":"37.361616",
             "newLon":"126.940224",
             "roadName":"번영로",
             "bldNo1":"580",
             "bldNo2":"0",
             "roadId":"00220"
             }
            ]
        }
    }
}
  • 주소 변환 RESPONSE ( type : xml)
<?xml version="1.0" encoding="UTF-8"?>
<convertadd>
    <rescount>1</rescount>
    <resmulti>S</resmulti>
    <reqaddress>O</reqaddress>
    <upperdistcode>41</upperdistcode>
    <upperdistname><!--[CDATA[경기]]--></upperdistname>
    <middledistcode>410</middledistcode>
    <middledistname><!--[CDATA[군포시]]--></middledistname>
    <legallowerdistcode>105</legallowerdistcode>
    <legallowerdistname><!--[CDATA[금정동]]--></legallowerdistname>
    <legaldetailcode>00</legaldetailcode>
    <legaldetailname></legaldetailname>
    <adminlowerdistcode>570</adminlowerdistcode>
    <admindistname><!--[CDATA[null]]--></admindistname>
    <primary>744</primary>
    <secondary>1</secondary>
    <mlclass>1</mlclass>
    <oldlat>37.361616</oldlat>
    <oldlon>126.940224</oldlon>
    <newaddresslist>
        <newaddress>
            <newlat>37.361616</newlat>
            <newlon>126.940224</newlon>
            <roadname><!--[CDATA[번영로]]--></roadname>
            <bldno1>580</bldno1>
            <bldno2>0</bldno2>
            <roadid>00220</roadid>
        </newaddress>
    </newaddresslist>
</convertadd>
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

가까운도로찾기

  • REQUEST ( 가까운도로찾기 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/road/nearToRoad?version=1&appKey=ksf82-aksyq-28hj2-kl1ys&lat=lat&lon=lon&opt=0&vehicleType=0&radius=100' \
     --header 'Accept: application/json'
  • RESPONSE ( 가까운도로찾기 )
NameDate TypeMandatoryExampleDescription
headerNodeY
totalDistanceintY링크의 총 거리 (단위: m)
idxNameStringY링크의 Mesh Id
linkIdStringY매칭된 링크의 ID
speedintY매칭된 링크의 제한 속도 (Km/H)
tollLinkintY유무료 도로 코드
0:무료, 1:유료
roadNameStringN도로 명칭
laneintY차로
1:1차로, 2:2차로, 3:3차로, 4:4차로, 5:5차로, 6:6차로, 7:7차로, 8:8차로, 9:9차로
laneTypeintY편도/ 왕복 구분 필드
0:편도차선, 1:왕복차선
roadCategoryintY원도로등급
(0:고속국도, 1:도시고속화도로,
2:국도, 3;국가지원지방도,
4:지방도, 5:주요도로 1,
6:주요도로 2, 7:주요도로 3,
8:기타도로 1, 9:이면도로,
10:페리항로, 11:단지내도로,
12 :이면도로 2(세도로))
linkFacilintN링크 도로 시설물 코드
0:일반도로, 1:교량,
2:터널, 3:고가도로, 4:지하도로
linkPoints(body)NodeY매칭된 링크의 형상정보 데이터.
locationNodeN요청된 좌표 정보
latitudeStringN요청 좌표의 위도
longitudeStringN요청 좌표의 경도
  • 가까운도로찾기 RESPONSE ( type : json)
{
  "resultData": {
    "header": {
      "linkId": "2078",
      "tollLink": 0,
      "idxName": "56540000",
      "totalDistance": 171,
      "speed": 10,
      "roadName": "",
      "lane": 1,
      "laneType":0,
      "roadCategory": 11,
      "linkFacil": 0
    },
    "linkPoints": [
      {
        "location": {
          "latitude": 36.63112777777778,
          "longitude": 127.50781944444445
        }
      },
      {
        "location": {
          "latitude": 36.63061944444444,
          "longitude": 127.50731388888889
        }
      },
      {
        "location": {
          "latitude": 36.63059444444445,
          "longitude": 127.50730555555556
        }
      },
      {
        "location": {
          "latitude": 36.63056944444445,
          "longitude": 127.50730833333333
        }
      },
      {
        "location": {
          "latitude": 36.63048611111111,
          "longitude": 127.50743333333334
        }
      },
      {
        "location": {
          "latitude": 36.63048611111111,
          "longitude": 127.50746666666667
        }
      },
      {
        "location": {
          "latitude": 36.630497222222225,
          "longitude": 127.50749166666666
        }
      },
      {
        "location": {
          "latitude": 36.631011111111114,
          "longitude": 127.50801111111111
        }
      }
    ]
  }
}
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

우편번호 검색

  • REQUEST ( 우편번호 검색 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geo/postcode?version=1&appKey=dhs8w-sk291-ka82o-lsu91&callback=function&addr=%EC%84%9C%EC%9A%B8%EC%8B%9C+%EA%B0%95%EB%82%A8%EA%B5%AC+%EC%8B%A0%EC%82%AC%EB%8F%99&addressFlag=F01&coordType=WGS84GEO&page=1&count=20' \
     --header 'Accept: application/json'
  • RESPONSE ( 우편번호 검색 )
NameDate TypeMandatoryExampleDescription
coordinateInfoNodeN우편번호 정보입니다.
coordTypeStringN지구 위의 위치를 나타내는 좌표 타입입니다.

<좌표 타입>
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)
addressFlagStringN주소 구분 코드입니다.

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

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

F00
- 구주소, 새(도로명)주소 타입
pageStringY페이지 번호 입니다.
countStringY페이지당 출력 갯수 입니다.
totalCountStringY전체 조회된 수 입니다.
coordinateNodeN우편번호 정보 입니다.
latNumberY위도 좌표입니다.
lonNumberY경도 좌표입니다.
city_doStringN서울시, 부산광역시, 대구광역시출력 좌표에 해당하는 시/도 명칭입니다.
gu_gunStringN강서구, 부평구, 도봉구출력 좌표에 해당하는 군/구 명칭입니다.
eup_myunStringN출력 좌표에 해당하는 도로명 주소 읍면동 명칭입니다.
legalDongStringN방화동, 화곡동, 쌍문동출력 좌표에 해당하는 법정동 명칭입니다.
adminDongStringN방화1동, 방화2동, 화곡1동, 화곡2동출력 좌표에 해당하는 행정동 명칭입니다.
riStringN출력 좌표에 해당하는 리 명칭입니다.
bunjiStringN1-1, 2-1출력 좌표에 해당하는 지번입니다.
buildingNameStringN구주소 매칭을 한 경우 건물 명을 반환합니다.
buildingDongStringN구주소 매칭을 한 경우 건물 동을 반환합니다.
latEntrNumberY주소 입구점 위도 좌표입니다.
lonEntrNumberY주소 입구점 경도 좌표입니다.
newRoadNameStringN새(도로명) 주소 매칭을 한 경우, 길 이름을 반환합니다.
newBuildingIndexStringN새(도로명) 주소 매칭을 한 경우, 건물 번호를 반환합니다.
zipcodeStringN우편번호입니다.
  • 우편번호 검색 RESPONSE ( type : json )
{
  "coordinateInfo": {
    "coordType": "WGS84GEO",
    "addressFlag": "F00",
    "page": "1",
    "count": "10",
    "totalCount": "4",
    "coordinate": [
      {
        "lat": "37.531081",
        "lon": "126.904143",
        "city_do": "서울특별시",
        "gu_gun": "영등포구",
        "eup_myun": "",
        "legalDong": "당산동5가",
        "adminDong": "",
        "ri": "",
        "bunji": "42",
        "buildingName": "당산 삼성 래미안",
        "buildingDong": "424동",
        "latEntr": "37.532775",
        "lonEntr": "126.901322",
        "newRoadName": "당산로",
        "newBuildingIndex": "214",
        "zipcode": "07214"
      },
      {
        "lat": "35.855327",
        "lon": "128.547984",
        "city_do": "대구광역시",
        "gu_gun": "서구",
        "eup_myun": "",
        "legalDong": "내당동",
        "adminDong": "",
        "ri": "",
        "bunji": "457-31",
        "buildingName": "",
        "buildingDong": "",
        "latEntr": "35.855386",
        "lonEntr": "128.547926",
        "newRoadName": "당산로",
        "newBuildingIndex": "214",
        "zipcode": "41855"
      },
      {
        "lat": "36.552325",
        "lon": "127.278417",
        "city_do": "세종특별자치시",
        "gu_gun": "세종특별자치시",
        "eup_myun": "연기면",
        "legalDong": "연기면",
        "adminDong": "",
        "ri": "",
        "bunji": "363-3",
        "buildingName": "",
        "buildingDong": "",
        "latEntr": "36.552302",
        "lonEntr": "127.278358",
        "newRoadName": "당산로",
        "newBuildingIndex": "214",
        "zipcode": "30058"
      },
      {
        "lat": "37.369268",
        "lon": "126.939783",
        "city_do": "경기도",
        "gu_gun": "군포시",
        "eup_myun": "",
        "legalDong": "산본동",
        "adminDong": "",
        "ri": "",
        "bunji": "232-14",
        "buildingName": "",
        "buildingDong": "",
        "latEntr": "37.36927",
        "lonEntr": "126.939714",
        "newRoadName": "당산로",
        "newBuildingIndex": "214",
        "zipcode": "15811"
      }
    ]
  }
}
  • 우편번호 검색 RESPONSE ( type : xml)
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<coordinateinfo>
    <coordtype>WGS84GEO</coordtype>
    <addressflag>F00</addressflag>
    <page>1</page>
    <count>10</count>
    <totalcount>4</totalcount>
    <coordinate>
        <lat>37.531081</lat>
        <lon>126.904143</lon>
        <city_do>
            <!--[CDATA[서울특별시]]-->
        </city_do>
        <gu_gun>
            <!--[CDATA[영등포구]]-->
        </gu_gun>
        <eup_myun></eup_myun>
        <legaldong>
            <!--[CDATA[당산동5가]]-->
        </legaldong>
        <admindong></admindong>
        <ri></ri>
        <bunji>42</bunji>
        <buildingname>
            <!--[CDATA[당산 삼성 래미안]]-->
        </buildingname>
        <buildingdong>
            <!--[CDATA[424동]]-->
        </buildingdong>
        <latentr>37.532775</latentr>
        <lonentr>126.901322</lonentr>
        <newroadname>
            <!--[CDATA[당산로]]-->
        </newroadname>
        <newbuildingindex>214</newbuildingindex>
        <zipcode>07214</zipcode>
    </coordinate>
    <coordinate>
        <lat>35.855327</lat>
        <lon>128.547984</lon>
        <city_do>
            <!--[CDATA[대구광역시]]-->
        </city_do>
        <gu_gun>
            <!--[CDATA[서구]]-->
        </gu_gun>
        <eup_myun></eup_myun>
        <legaldong>
            <!--[CDATA[내당동]]-->
        </legaldong>
        <admindong></admindong>
        <ri></ri>
        <bunji>457-31</bunji>
        <buildingname></buildingname>
        <buildingdong></buildingdong>
        <latentr>35.855386</latentr>
        <lonentr>128.547926</lonentr>
        <newroadname>
            <!--[CDATA[당산로]]-->
        </newroadname>
        <newbuildingindex>214</newbuildingindex>
        <zipcode>41855</zipcode>
        </coordinate>
        <coordinate>
        <lat>36.552325</lat>
        <lon>127.278417</lon>
        <city_do>
            <!--[CDATA[세종특별자치시]]-->
        </city_do>
        <gu_gun>
            <!--[CDATA[세종특별자치시]]-->
        </gu_gun>
        <eup_myun>
            <!--[CDATA[연기면]]-->
        </eup_myun>
        <legaldong>
            <!--[CDATA[연기면]]-->
        </legaldong>
        <admindong></admindong>
        <ri></ri>
        <bunji>363-3</bunji>
        <buildingname></buildingname>
        <buildingdong></buildingdong>
        <latentr>36.552302</latentr>
        <lonentr>127.278358</lonentr>
        <newroadname>
            <!--[CDATA[당산로]]-->
        </newroadname>
        <newbuildingindex>214</newbuildingindex>
        <zipcode>30058</zipcode>
    </coordinate>
    <coordinate>
        <lat>37.369268</lat>
        <lon>126.939783</lon>
        <city_do>
            <!--[CDATA[경기도]]-->
        </city_do>
        <gu_gun>
            <!--[CDATA[군포시]]-->
        </gu_gun>
        <eup_myun></eup_myun>
        <legaldong>
            <!--[CDATA[산본동]]-->
        </legaldong>
        <admindong></admindong>
        <ri></ri>
        <bunji>232-14</bunji>
        <buildingname></buildingname>
        <buildingdong></buildingdong>
        <latentr>37.36927</latentr>
        <lonentr>126.939714</lonentr>
        <newroadname>
            <!--[CDATA[당산로]]-->
        </newroadname>
        <newbuildingindex>214</newbuildingindex>
        <zipcode>15811</zipcode>
    </coordinate>
</coordinateinfo>
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

Reverse Label

  • REQUEST ( Reverse Label )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/geo/reverseLabel?version=1&format=json&centerLat=centerLat&centerLon=centerLon&reqLevel=7&appKey=shkf9-k92u1-h2pq0-sj0a9' \
     --header 'Accept: application/json'
  • RESPONSE( Reverse Label )
NameDate TypeMandatoryExampleDescription
poiInfoPOI 상세정보
idStringY해당 지점 poi id 정보
해당 지점의 poi 정보가 없는경우 ‘id=0’
poiLatStringYpoi 위도 정보
poiLonStringYpoi 경도 정보
nameStringN건국대학병원시설물 명칭입니다.
  • Reverse Label RESPONSE( type : json )
{
    "poiInfo": {
        "id": "1128603",
        "name": "SKT타워",
        "poiLat": "37.566489",
        "poiLon": "126.985031"
    }
}
  • Reverse Label RESPONSE( type : xml )
<!--?xml version="1.0" encoding="utf-8" standalone="yes" ?-->
<poiinfo>
    <id>1128603</id>
    <name>
        <!--[CDATA[SKT타워]]-->
    </name>
    <poilat>37.566489</poilat>
    <poilon>126.985031</poilon>
</poiinfo>
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.