지오코딩 예시

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 )

Name

Date Type

Mandatory

Example

Description

addressInfo

Node

N

주소 정보입니다.

fullAddress

String

N

서울시 관악구 청림동 22-13

전체 주소입니다.

  • ‘addressType = A00’인경우 [행정동,법정동] 순서로 표출되며,
    구분자(콤마)로 구분 되여 집니다.
  • 예) 서울특별시 강서구 화곡3동,서울특별시 강서구 화곡동 1019-1

addressKey

String

N

3004545827

구 주소 POI 식별자입니다.

roadAddressKey

String

N

4001807949

새 주소 POI 식별자입니다.

addressType

String

N

A03

주소 타입입니다.

<주소 타입>
A00

  • 선택한 좌표계에 해당하는 행정동,법정동 주소 입니다.

A01

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

A02

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

A03

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

A04

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

A10
선택한 좌표계에 해당하는 행정동+법정동+도로명 주소 입니다.

city_do

String

N

서울특별시, 부산광역시, 대구광역시

주소에서 시/도에 해당하는 명칭입니다.

gu_gun

String

N

강서구, 부평구, 도봉구, 청원군

주소에서 군/구에 해당하는 명칭입니다.

eup_myun

String

N

언양읍, 부발읍

도로명 주소에서 읍/면 에 해당하는 명칭입니다.

adminDong

String

N

망원2동, 신림3동

주소에서 행정동에 해당하는 명칭입니다.

adminDongCode

String

N

1150056000 -> ‘화곡3동’

행정동 명칭에 해당되는 코드 10자리 입니다.

legalDong

String

N

방화동, 화곡동, 쌍문동, 서천읍, 종천면

주소에서 법정동(읍/면)에 해당하는 명칭입니다.

legalDongCode

String

N

1132010500 -> '쌍문동'

법정동 명칭에 해당하는 코드 10자리입니다.

ri

String

N

죽전리, 연화리, 송정리

주소에서 리에 해당하는 명칭입니다.

roadName

String

N

양천로14길, 강남대로

주소에서 도로명에 해당하는 명칭입니다.

buildingIndex

String

N

95-11, 11-11

주소 건물번호 부여체계를 기준으로 한 건물에 부여된 일련번호입니다.

buildingName

String

N

신장미아파트, 영진그린빌라

주소 건물명에 해당하는 집합건물의 명칭입니다.

mappingDistance

Number

N

건물 출입문에 해당하는 위치 정보와 입력 좌표 사이의 거리입니다.

roadCode

String

N

261104175064 -> '대청북길33번길'

주소 도로명에 해당하는 코드 12자리입니다.

bunji

String

N

121-12

주소에서 번지에 해당 합니다.

adminDongCoord

Node

N

주소에서 행정동에 해당하는 좌표 입니다.

lat

String

N

위도 좌표입니다.

lon

String

N

경도 좌표입니다.

latEntr

String

N

입구점 위도 좌표입니다.

lonEntr

String

N

입구점 경도 좌표입니다.

legalDongCoord

Node

N

주소에서 법정동에 해당하는 좌표 입니다.

lat

String

N

위도 좌표입니다.

lon

String

N

경도 좌표입니다.

latEntr

String

N

입구점 위도 좌표입니다.

lonEntr

String

N

입구점 경도 좌표입니다.

roadCoord

Node

N

주소에서 도로명에 해당하는 좌표 입니다.

lat

String

N

위도 좌표입니다.

lon

String

N

경도 좌표입니다.

latEntr

String

N

입구점 위도 좌표입니다.

lonEntr

String

N

입구점 경도 좌표입니다.

  • 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 )

Name

Date Type

Mandatory

Example

Description

coordinateInfo

Node

N

좌표 정보입니다.

coordType

String

N

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

<좌표 타입>
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)

addressFlag

String

N

주소 구분 코드입니다.

<주소 구분 코드>
F01

  • 지번주소
  • 구주소 타입

F02

  • 새(도로명) 주소
  • 새(도로명) 주소 타입

F00

  • 구주소, 새(도로명)주소 타입

matchFlag

String

N

매칭 구분 코드입니다.

<매칭 구분 코드>
M11

  • 법정동 정매칭
  • 법정동 코드 + 지번이 모두 일치

M12

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

M13

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

M21

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

M22

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

M23

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

M31

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

M32

  • 행정동의 중심 매칭

M33

  • 법정동의 중심 매칭

M41:

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

행정동 코드및 법정동 코드는 행정표준코드관리시스템(https://www.code.go.kr)에서 조회가 가능합니다.

lat

Number

N

위도 좌표입니다

lon

Number

N

경도 좌표입니다

city_do

String

N

서울시, 부산광역시, 대구광역시

출력 좌표에 해당하는 시/도 명칭입니다

gu_gun

String

N

강서구, 부평구, 도봉구

출력 좌표에 해당하는 군/구 명칭입니다.

eup_myun

String

N

언양읍, 부발읍

출력 좌표에 해당하는 도로명 주소 읍면동 명칭입니다.

legalDong

String

N

방화동, 화곡동, 쌍문동

출력 좌표에 해당하는 법정동 명칭입니다.

legalDongCode

String

N

1132010500 -> '쌍문동'

법정동 명칭에 해당하는 코드 10자리입니다.

adminDong

String

N

방화1동, 방화2동, 화곡1동, 화곡2동

출력 좌표에 해당하는 행정동 명칭입니다.

adminDongCode

String

N

1150056000 -> ‘화곡3동’

행정동 명칭에 해당되는 코드 10자리 입니다.

ri

String

N

죽전리, 연화리, 송정리

출력 좌표에 해당하는 리 명칭입니다.

bunji

String

N

1-1, 2-1

출력 좌표에 해당하는 지번입니다.

newMatchFlag

String

N

새(도로명) 주소 좌표 매칭 구분입니다.

<매칭 구분 코드>

N51

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

N52

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

N53

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

N54

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

N55

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

N61

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

N62

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

newLon

Number

N

새(도로명) 주소 매칭을 한 경우, 경도 좌표를 반환합니다.

newLat

Number

N

새(도로명) 주소 매칭을 한 경우, 위도 좌표를 반환합니다.

newRoadName

String

N

새(도로명) 주소 매칭을 한 경우, 길 이름을 반환합니다.

newBuildngIndex

String

N

새(도로명) 주소 매칭을 한 경우, 건물 번호를 반환합니다.

newBuildngName

String

N

새(도로명) 주소 건물명 매칭을 한 경우, 건물 이름을 반환합니다.

newBuildngCateName

String

N

우, 건물군 이름을 반환합니다.

remainder

String

N

정매치 시
주소매칭에 사용되고
남은 주소에 대한 나머지 주소입니다.
< 정매칭인 경우 >
-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 )

Name

Date Type

Mandatory

Example

Description

coordinateInfo

Node

N

좌표 정보입니다.

coordType

String

N

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

<좌표 타입>
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)

addressFlag

String

N

주소 구분 코드입니다.

<주소 구분 코드>
F01

  • 지번주소
  • 구주소 타입

F02

  • 새(도로명) 주소
  • 새(도로명) 주소 타입

F00

  • 구주소, 새(도로명)주소 타입

page

String

Y

페이지 번호 입니다.

count

String

Y

페이지당 출력 갯수 입니다.

totalCount

String

Y

전체 조회된 수 입니다.

coordinate

Node

N

좌표 정보 입니다.

matchFlag

String

N

매칭 구분 코드입니다.

<매칭 구분 코드>
M11

  • 법정동 정매칭
  • 법정동 코드 + 지번이 모두 일치

M12

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

M13

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

M21

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

M22

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

M23

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

M31

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

M32

  • 행정동의 중심 매칭

M33

  • 법정동의 중심 매칭

M41:

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

M42 :

  • 법정동 코드 + 건물 동이 매칭

lat

Number

N

위도 좌표입니다.

lon

Number

N

경도 좌표입니다.

latEntr

Number

N

주소 입구점 위도 좌표입니다.

lonEntr

Number

N

주소 입구점 경도 좌표입니다.

city_do

String

N

서울시, 부산광역시, 대구광역시

출력 좌표에 해당하는 시/도 명칭입니다.

gu_gun

String

N

강서구, 부평구, 도봉구

출력 좌표에 해당하는 군/구 명칭입니다.

eup_myun

String

N

옥천읍, 산청읍, 물금읍

출력 좌표에 해당하는 주소 읍면동 명칭입니다.

legalDong

String

N

방화동, 화곡동, 쌍문동

출력 좌표에 해당하는 법정동 명칭입니다.

  • 읍면 단위인 경우 법정동 명칭이 나갈 수 있으며 읍면 필드와 중복될 수 있습니다.

legalDongCode

String

N

1132010500 -> '쌍문동'

법정동 명칭에 해당하는 코드 10자리입니다.

adminDong

String

N

방화1동, 방화2동, 화곡1동, 화곡2동

출력 좌표에 해당하는 행정동 명칭입니다.

  • 읍면 단위인 경우 행정동 명칭이 나갈 수 있으며 읍면 필드와 중복될 수 있습니다.

adminDongCode

String

N

1150056000 -> ‘화곡3동’

행정동 명칭에 해당되는 코드 10자리 입니다.

ri

String

N

금구리, 지리, 대포리

출력 좌표에 해당하는 리 명칭입니다.

bunji

String

N

1-1, 2-1

출력 좌표에 해당하는 지번입니다.

buildingName

String

N

구주소 매칭을 한 경우 건물 명을 반환합니다.

buildingDong

String

N

구주소 매칭을 한 경우 건물 동을 반환합니다.

newMatchFlag

String

N

새(도로명) 주소 좌표 매칭 구분입니다.

<매칭 구분 코드>

N51

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

N52

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

N53

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

N54

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

N55

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

N61

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

N62

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

newLat

Number

N

새주소 매칭을 한 경우, 새주소 위도 좌표를 반환합니다.

newLon

Number

N

새주소 매칭을 한 경우, 새주소 경도 좌표를 반환합니다.

newLatEntr

Number

N

새주소 매칭을 한 경우, 새주소 위도 입구점 좌표를 반환합니다.

newLonEntr

Number

N

새주소 매칭을 한 경우, 새주소 경도 입구점 좌표를 반환합니다.

newRoadName

String

N

새(도로명) 주소 매칭을 한 경우, 길 이름을 반환합니다.

newBuildingIndex

String

N

새(도로명) 주소 매칭을 한 경우, 건물 번호를 반환합니다.

newBuildingName

String

N

새(도로명) 주소 건물명 매칭을 한 경우, 건물 이름을 반환합니다.

newBuildingDong

String

N

새주소 건물을 매칭한 경우 새주소 건물 동을 반환 합니다

newBuildingCateName

String

N

zipcode

String

N

우편번호

remainder

String

N

정매치 시
주소매칭에 사용되고
남은 주소에 대한 나머지 주소입니다.
< 정매칭인 경우 >
-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 ( 좌표변환 )

Name

Date Type

Mandatory

Example

Description

coordinate

Node

Y

좌표 정보입니다.

lat

Number

Y

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

lon

Number

Y

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

  • 좌표변환 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 ( 주소 변환 )

Name

Date Type

Mandatory

Example

Description

ConvertAdd

Node

Y

주소변환 상세정보

resCount

Number

Y

응답 총개수

resMulti

String

Y

변환 주소 다중 응답 판정

  • M : 복수건 응답
  • S : 단건 응답

reqAddress

String

Y

요청주소 입력값 기준 주소

  • N : 새주소
  • O : 구주소(법정동)

upperDistCode

String

Y

[공용] 대분류 코드

upperDistName

String

Y

[공용] 대분류 명칭(구주소/새주소)

middleDistCode

String

Y

[공용] 중분류 코드

middleDistName

String

Y

[공용] 중분류 명칭(구주소/새주소)

legalLowerDistCode

String

Y

법정 소분류 코드(구주소)

legalLowerDistName

String

Y

법정 소분류 명칭(구주소)

legalDetailCode

String

Y

법정 세분류 코드(구주소)

legalDetailName

String

Y

법정 세분류 명칭(구주소)

adminLowerDistCode

String

Y

행정 소분류 코드(구주소)

adminDistName

String

Y

행정 소분류 명칭(구주소)

primary

String

Y

본번(구주소)

secondary

String

Y

부번(구주소)

mlClass

String

Y

산/대지구분(구주소)

oldLat

String

Y

중심 X좌표(구주소)

oldLon

String

Y

중심 Y좌표(구주소)

newAddressList

Node

Y

새주소 리스트

newAddress

Node

Y

새주소

newLat

String

Y

중심 X좌표(새주소)

newLon

String

Y

중심 Y좌표(새주소)

roadName

String

Y

도로명(새주소)

bldNo1

String

Y

건물번호1(새주소)

bldNo2

String

Y

건물번호2(새주소)

roadId

String

Y

도로명 코드(새주소)

  • 주소 변환 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 ( 가까운도로찾기 )

Name

Date Type

Mandatory

Example

Description

header

Node

Y

totalDistance

int

Y

링크의 총 거리 (단위: m)

idxName

String

Y

링크의 Mesh Id

linkId

String

Y

매칭된 링크의 ID

speed

int

Y

매칭된 링크의 제한 속도 (Km/H)

tollLink

int

Y

유무료 도로 코드
0:무료, 1:유료

roadName

String

N

도로 명칭

lane

int

Y

차로
1:1차로, 2:2차로, 3:3차로, 4:4차로, 5:5차로, 6:6차로, 7:7차로, 8:8차로, 9:9차로

laneType

int

Y

편도/ 왕복 구분 필드
0:편도차선, 1:왕복차선

roadCategory

int

Y

원도로등급
(0:고속국도, 1:도시고속화도로,
2:국도, 3;국가지원지방도,
4:지방도, 5:주요도로 1,
6:주요도로 2, 7:주요도로 3,
8:기타도로 1, 9:이면도로,
10:페리항로, 11:단지내도로,
12 :이면도로 2(세도로))

linkFacil

int

N

링크 도로 시설물 코드
0:일반도로, 1:교량,
2:터널, 3:고가도로, 4:지하도로

linkPoints(body)

Node

Y

매칭된 링크의 형상정보 데이터.

location

Node

N

요청된 좌표 정보

latitude

String

N

요청 좌표의 위도

longitude

String

N

요청 좌표의 경도

  • 가까운도로찾기 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 ( 우편번호 검색 )

Name

Date Type

Mandatory

Example

Description

coordinateInfo

Node

N

우편번호 정보입니다.

coordType

String

N

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

<좌표 타입>
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)

addressFlag

String

N

주소 구분 코드입니다.

<주소 구분 코드>
F01

  • 지번주소
  • 구주소 타입

F02

  • 새(도로명) 주소
  • 새(도로명) 주소 타입

F00

  • 구주소, 새(도로명)주소 타입

page

String

Y

페이지 번호 입니다.

count

String

Y

페이지당 출력 갯수 입니다.

totalCount

String

Y

전체 조회된 수 입니다.

coordinate

Node

N

우편번호 정보 입니다.

lat

Number

Y

위도 좌표입니다.

lon

Number

Y

경도 좌표입니다.

city_do

String

N

서울시, 부산광역시, 대구광역시

출력 좌표에 해당하는 시/도 명칭입니다.

gu_gun

String

N

강서구, 부평구, 도봉구

출력 좌표에 해당하는 군/구 명칭입니다.

eup_myun

String

N

출력 좌표에 해당하는 도로명 주소 읍면동 명칭입니다.

legalDong

String

N

방화동, 화곡동, 쌍문동

출력 좌표에 해당하는 법정동 명칭입니다.

adminDong

String

N

방화1동, 방화2동, 화곡1동, 화곡2동

출력 좌표에 해당하는 행정동 명칭입니다.

ri

String

N

출력 좌표에 해당하는 리 명칭입니다.

bunji

String

N

1-1, 2-1

출력 좌표에 해당하는 지번입니다.

buildingName

String

N

구주소 매칭을 한 경우 건물 명을 반환합니다.

buildingDong

String

N

구주소 매칭을 한 경우 건물 동을 반환합니다.

latEntr

Number

Y

주소 입구점 위도 좌표입니다.

lonEntr

Number

Y

주소 입구점 경도 좌표입니다.

newRoadName

String

N

새(도로명) 주소 매칭을 한 경우, 길 이름을 반환합니다.

newBuildingIndex

String

N

새(도로명) 주소 매칭을 한 경우, 건물 번호를 반환합니다.

zipcode

String

N

우편번호입니다.

  • 우편번호 검색 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 )

Name

Date Type

Mandatory

Example

Description

poiInfo

POI 상세정보

id

String

Y

해당 지점 poi id 정보
해당 지점의 poi 정보가 없는경우 ‘id=0’

poiLat

String

Y

poi 위도 정보

poiLon

String

Y

poi 경도 정보

name

String

N

건국대학병원

시설물 명칭입니다.

  • 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에서 확인 할 수 있습니다.