POI 검색 예시

명칭(POI) 통합 검색

  • REQUEST (명칭(POI) 통합 검색)
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/pois?version=1&searchKeyword=telno&searchType=all&page=1&count=20&resCoordType=WGS84GEO&multiPoint=N&searchtypCd=A&reqCoordType=WGS84GEO&poiGroupYn=N' \
     --header 'Accept: application/json' \
     --header 'appKey: s25aa-1f5w8-4f6s8-jdus1'
  • RESPONSE (명칭(POI) 통합 검색)

Name

Date Type

Mandatory

Example

Description

searchPoiInfo

Node

Y

조회 결과입니다.

totalCount

Number

Y

200

조회 결과의 총 개수입니다.

count

Number

Y

20

페이지당 출력되는 개수입니다.

page

Number

Y

1

조회한 페이지 번호입니다.

pois

Node

Y

POI 목록입니다.

poi

Node

N

POI 정보입니다.

id

String

N

374469

POI ID입니다.

pkey

String

N

37446900

POI 식별자 입니다.

navSeq

String

N

0

입구점 일련번호 입니다.

collectionType

String

N

poi

문서의 컬렉션 출처입니다.

  • address
  • poi

name

String

N

가톨릭대학교부천성모병원 정문(THECATHOLICUNIVERSITYOFKOREA)

시설물 명칭입니다.

telNo

String

N

1577-0675

전화번호입니다.

frontLat

Number

N

37.486138853308304

시설물 입구 위도 좌표입니다.

frontLon

Number

N

126.79180642554107

시설물 입구 경도 좌표입니다.

noorLat

Number

N

37.4870276429392

중심점 위도 좌표입니다.

noorLon

Number

N

126.79238969773668

중심점 경도 좌표입니다.

upperAddrName

String

N

경기

표출 주소 대분류명입니다.

middleAddrName

String

N

부천시 원미구

표출 주소 중분류명입니다.

lowerAddrName

String

N

소사동

표출 주소 소분류명입니다.

detailAddrName

String

N

미주아파트 111동 22호

표출 주소 세분류명입니다.

mlClass

String

N

1

산/대지구분(구주소)

firstNo

String

N

141

본번입니다.

secondNo

String

N

23

부번입니다.

roadName

String

N

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

firstBuildNo

String

N

건물번호1(새주소)

secondBuildNo

String

N

건물번호2(새주소)

radius

String

N

거리 (요청 좌표에서 떨어진 거리) 단위 : km

bizName

String

N

의료편의

대표 업종명입니다.

upperBizName

String

N

의료편의

업종 대분류명입니다.

middleBizName

String

N

의료시설

업종 중분류명입니다.

lowerBizName

String

N

종합병원

업종 소분류명입니다.

detailBizName

String

N

기타

업종 상세분류명입니다.

rpFlag

String

N

G

RP_FLAG는 길안내 요청에 필요한 값입니다. - 길안내 목적지 설정 시, 여기서 받은 rpFlag 값을 설정해야 합니다.

parkFlag

Number

N

0

주차 가능유무입니다. - 0: 주차 불가능 - 1: 주차 가능 - null: 정보없음

detailInfoFlag

Number

N

0

POI 상세정보 유무입니다. 해당 필드가 1로 설정되어 있으면, POI 상세정보 API를 이용하여 상세 정보를 조회할 수 있습니다. - 0: 없음 - 1: 있음 - null: 정보없음

desc

String

N

소개정보입니다.

dataKind

String

N

데이터구분자 ("3": 주유소, "4": 충전소, "5": 맞춤형 목적지, "6":EV충전소)

zipCode

String

N

우편번호

evChargers

Node

N

충전기 리스트

evCharger

Node

N

충전기 정보

operatorId

String

N

ev충전소 제공 업체

stationId

String

N

충전소 id

chargerId

String

N

충전기 id

status

String

N

상태정보 (0,1,2,3,4,5,6,9)
0 - 알수없음
1 - 통신이상
2 - 충전대기
3 - 충전중
4 - 운영중지
5 - 점검중
6 - 예약중
9 - 상태 미확인

type

String

N

충전기타입 (01,02,03,04,05,06,07)
01 - DC차데모
02 - 승용차 AC완속
03 - DC차데모+AC3상
04 - DC콤보
05 - DC차데모+DC콤보
06 - DC차데모+AC3상+DC콤보
07 - AC급속3상

powerType

String

N

ev충전기 충전량
Ex)급속(200kW동시),급속(50kW)

operatorName

String

N

제공 업체명

chargingDateTime

String

N

마지막 충전 시각(YYYYMMDDHH24MISS)
Ex)20190919181030

updateDateTime

String

N

최종 변경 시각(YYYYMMDDHH24MISS)
Ex)20190919181030

isFast

String

N

급속 충전 여부

isAvailable

String

N

사용 가능 여부

newAddressList

Node

Y

새주소 목록입니다.

newAddress

Node

Y

새주소 정보입니다.

centerLat

Number

N

37.486138853308304

중심점 위도 좌표입니다.

centerLon

Number

N

126.79180642554107

중심점 경도 좌표입니다.

frontLat

Number

N

37.4870276429392

시설물 입구 위도 좌표입니다.

frontLon

Number

N

126.79238969773668

시설물 입구 경도 좌표입니다.

roadName

String

N

을지로

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

bldNo1

String

N

건물번호1(새주소)

bldNo2

String

N

건물번호2(새주소)

roadId

String

N

00255

도로명 코드(새주소)

fullAddressRoad

String

N

서울 중구 을지로 65

전체 도로명 주소 입니다.

groupSubLists

Node

N

그룹 하부 목록입니다.

groupSub

Node

N

그룹 하부 정보입니다.

subPkey

String

N

37446901

하부-POI 식별자 (POI와 입구점을 포함한 식별자) 입니다.

subSeq

String

N

1

하부-순번 (그룹인 경우 1 이상의 값이 존재) 입니다.

subName

String

N

정문

하부-명칭 입니다.

subCenterY

Number

N

37.48618242

하부-시설물중심Y좌표 입니다.

subCenterX

Number

N

126.79198473

하부-시설물중심X좌표 입니다

subNavY

Number

N

37.48618242

하부-시설물입구Y좌표 입니다.

subNavX

Number

N

126.79198473

하부-시설물입구X좌표 입니다.

subRpFlag

String

N

16

하부-RP FLAG 입니다.

subPoiId

String

N

374469

하부-POI ID 입니다.

subNavSeq

String

N

1

하부-입구점번호 입니다.

subParkYn

String

N

0

하부-주차여부 입니다.
주차가능일 경우 1, 아닐경우 0

subClassCd

String

N

04010199

하부-업종코드.

subClassNmA

String

N

의료편의

하부-업종 대분류명 입니다.

subClassNmB

String

N

의료시설

하부-업종 중분류명 입니다.

subClassNmC

String

N

종합병원

하부-업종 소분류명 입니다.

subClassNmD

String

N

기타

하부-업종 세분류명 입니다.

  • 명칭(POI) 통합 검색 RESPONSE ( Type : javascript)
function(
  {
    "searchPoiInfo": {
      "totalCount": "65",
      "count": "2",
      "page": "1",
      "pois": {
        "poi": [
          {
            "id": "4670161",
            "pkey": "37446900",
            "navSeq": "0",
            "collectionType": "poi",
            "name": "빈스빈스마포공덕점",
            "frontLat": "37.543956",
            "frontLon": "126.950107",
            "noorLat": "37.543872",
            "noorLon": "126.950052",
            "upperAddrName": "서울",
            "middleAddrName": "마포구",
            "lowerAddrName": "공덕동",
            "detailAddrname": "",
            "mlClass": "1",
            "lowerAddrName": "공덕동",
            "firstNo": "461",
            "secondNo": "",
            "roadName": "",
            "firstBuildNo": "",
            "secondBuildNo": "",
            "radius": "0",
            "upperBizName": "생활편의",
            "middleBizName": "술집",
            "lowerBizName": "바",
            "detailBizName": "기타",
            "rpFlag": "16",
            "parkFlag": "0",
            "detailInfoFlag": "0",
            "desc": "",
            "dataKind": "6",
            "zipCode": "04524",
            "evChargers":{
              "evCharger":[
                {
                  "operatorId": "KP",
                  "stationId": "KP000207",
                  "chargerId": "01",
                  "status": "2",
                  "type": "06",
                  "powerType": "",
                  "operatorName": "한국전력",
                  "chargingDateTime": "20210906111707",
                  "updateDateTime": "20210906115434",
                  "isFast": "Y",
                  "isAvailable": "Y"
                }
              ]
            },
            "groupSubLists":{
              "groupSub":[
                {
                  "subPkey": "113344401",
                  "subSeq": "1",
                  "subName": "1번출구",
                  "subCenterY": "37.55628772",
                  "subCenterX": "126.92272084",
                  "subNavY": "37.55628772",
                  "subNavX": "126.92272084",
                  "subRpFlag": "8",
                  "subPoiId": "1133444",
                  "subNavSeq": "1",
                  "subParkYn": "0",
                  "subClassCd": "01012804",
                  "subClassNmA": "교통편의",
                  "subClassNmB": "교통시설",
                  "subClassNmC": "지하철출구번호",
                  "subClassNmD": "2호선"
                }
              ]
            },      
            "newAddressList":{
              "newAddress":[
                {
                  "centerLat": "37.54387299",
                  "centerLon": "126.95007981",
                  "frontLat": "37.54395631",
                  "frontLon": "126.95013536",
                  "roadName": "백범로",
                  "bldNo1": "178",
                  "bldNo2": "",
                  "roadId": "00232",
                  "fullAddressRoad": "서울 마포구 백범로 178"
                }
              ]
            }
          },
          {
            "id": "4778454",
            "pkey": "191276601",
            "navSeq": "1",
            "collectionType": "poi",
            "name": "티롤",
            "frontLat": "37.544289",
            "frontLon": "126.949635",
            "noorLat": "37.544261",
            "noorLon": "126.949607",
            "upperAddrName": "서울",
            "middleAddrName": "마포구",
            "lowerAddrName": "공덕동",
            "detailAddrname": "",
            "mlClass": "1",
            "lowerAddrName": "공덕동",
            "firstNo": "461",
            "secondNo": "",
            "roadName": "",
            "firstBuildNo": "",
            "secondBuildNo": "",
            "radius": "0.06",
            "upperBizName": "생활편의",
            "middleBizName": "술집",
            "lowerBizName": "바",
            "detailBizName": "기타",
            "rpFlag": "16",
            "parkFlag": "0",
            "detailInfoFlag": "0",
            "desc": "",
            "dataKind": "6",
            "zipCode": "04524",
            "evChargers":{
              "evCharger":[
                {
                  "operatorId": "KP",
                  "stationId": "KP000207",
                  "chargerId": "01",
                  "status": "2",
                  "type": "06",
                  "powerType": "",
                  "operatorName": "한국전력",
                  "chargingDateTime": "20210906111707",
                  "updateDateTime": "20210906115434",
                  "isFast": "Y",
                  "isAvailable": "Y"
                }
              ]
            },
            "groupSubLists":{
              "groupSub":[
                {
                  "subPkey": "113344401",
                  "subSeq": "1",
                  "subName": "1번출구",
                  "subCenterY": "37.55628772",
                  "subCenterX": "126.92272084",
                  "subNavY": "37.55628772",
                  "subNavX": "126.92272084",
                  "subRpFlag": "8",
                  "subPoiId": "1133444",
                  "subNavSeq": "1",
                  "subParkYn": "0",
                  "subClassCd": "01012804",
                  "subClassNmA": "교통편의",
                  "subClassNmB": "교통시설",
                  "subClassNmC": "지하철출구번호",
                  "subClassNmD": "2호선"
                }
              ]
            },
            "newAddressList":{
              "newAddress":[
                {
                  "centerLat": "37.54387299",
                  "centerLon": "126.95007981",
                  "frontLat": "37.54395631",
                  "frontLon": "126.95013536",
                  "roadName": "백범로",
                  "bldNo1": "178",
                  "bldNo2": "",
                  "roadId": "00232",
                  "fullAddressRoad": "서울 마포구 백범로 178"
                }
              ]
            }
          }
        ]
      }
    }
  }
)
  • 명칭(POI) 통합 검색 RESPONSE ( Type : json )
{
  "searchPoiInfo: 조회 결과": {
    "totalCount: 조회 결과 건수": "65",
    "count: 페이지당 표시되는 조회 건수": "2",
    "page: 조회한 페이지": "1",
    "pois: POI 목록": {
      "poi: POI": [
        {
          "id: POI ID": "4670161",
          "pkey: POI 식별자": "37446900",
          "navSeq: 입구지점 일련번호": "0",
          "collectionType: 컬렉션 출처(poi, address)": "poi",
          "name: 시설물 명칭": "빈스빈스마포공덕점",
          "telNo: 전화번호": "",
          "frontLat: 시설물 입구 위도 좌표": "37.543956",
          "frontLon: 시설물 입구 경도 좌표": "126.950107",
          "noorLat: 중심점 위도 좌표": "37.543872",
          "noorLon: 중심점 경도 좌표": "126.950052",
          "upperAddrName: 주소 대분류": "서울",
          "middleAddrName: 주소 중분류": "마포구",
          "lowerAddrName: 주소 소분류": "공덕동",
          "detailAddrname: 상세 주소": "",
          "mlClass: 지번주소 산/대지구분": "1",
          "firstNo: 지번 본번": "461",
          "secondNo: 지번 부번": "",
          "roadName: 도로명": "",
          "firstBuildNo: 도로명주소 건물번호1": "",
          "secondBuildNo: 도로명주소 건물번호2": "",
          "radius: 요청좌표로부터의 거리": "0",
          "upperBizName: 업종 대분류": "생활편의",
          "middleBizName: 업종 중분류": "술집",
          "lowerBizName: 업종 소분류": "바",
          "detailBizName": "기타",
          "rpFlag": "16",
          "parkFlag": "0",
          "detailInfoFlag": "0",
          "desc": "",
          "dataKind": "6",
          "zipCode": "04524",
          "evChargers":{
            "evCharger":[
              {
                "operatorId": "KP",
                "stationId": "KP000207",
                "chargerId": "01",
                "status": "2",
                "type": "06",
                "powerType": "",
                "operatorName": "한국전력",
                "chargingDateTime": "20210906111707",
                "updateDateTime": "20210906115434",
                "isFast": "Y",
                "isAvailable": "Y"
              }
            ]
          },
          "groupSubLists":{
            "groupSub":[
              {
                "subPkey": "113344401",
                "subSeq": "1",
                "subName": "1번출구",
                "subCenterY": "37.55628772",
                "subCenterX": "126.92272084",
                "subNavY": "37.55628772",
                "subNavX": "126.92272084",
                "subRpFlag": "8",
                "subPoiId": "1133444",
                "subNavSeq": "1",
                "subParkYn": "0",
                "subClassCd": "01012804",
                "subClassNmA": "교통편의",
                "subClassNmB": "교통시설",
                "subClassNmC": "지하철출구번호",
                "subClassNmD": "2호선"
              }
            ]
          },
          "newAddressList":{
            "newAddress":[
              {
                "centerLat": "37.54387299",
                "centerLon": "126.95007981",
                "frontLat": "37.54395631",
                "frontLon": "126.95013536",
                "roadName": "백범로",
                "bldNo1": "178",
                "bldNo2": "",
                "roadId": "00232",
                "fullAddressRoad": "서울 마포구 백범로 178"
              }
            ]
          }
        },
        {
          "id": "4778454",
          "pkey": "191276601",
          "navSeq": "1",
          "collectionType": "poi",
          "name": "티롤",
          "frontLat": "37.544289",
          "frontLon": "126.949635",
          "noorLat": "37.544261",
          "noorLon": "126.949607",
          "upperAddrName": "서울",
          "middleAddrName": "마포구",
          "lowerAddrName": "공덕동",
          "detailAddrname": "",
          "mlClass": "1",
          "lowerAddrName": "공덕동",
          "firstNo": "461",
          "secondNo": "",
          "roadName": "",
          "firstBuildNo": "",
          "secondBuildNo": "",
          "radius": "0.06",
          "upperBizName": "생활편의",
          "middleBizName": "술집",
          "lowerBizName": "바",
          "detailBizName": "기타",
          "rpFlag": "16",
          "parkFlag": "0",
          "detailInfoFlag": "0",
          "desc": "",
          "dataKind": "6",
          "zipCode": "04524",
          "evChargers":{
            "evCharger":[
              {
                "operatorId": "KP",
                "stationId": "KP000207",
                "chargerId": "01",
                "status": "2",
                "type": "06",
                "powerType": "",
                "operatorName": "한국전력",
                "chargingDateTime": "20210906111707",
                "updateDateTime": "20210906115434",
                "isFast": "Y",
                "isAvailable": "Y"
              }
            ]
          },
          "groupSubLists":{
            "groupSub":[
              {
                "subPkey": "113344401",
                "subSeq": "1",
                "subName": "1번출구",
                "subCenterY": "37.55628772",
                "subCenterX": "126.92272084",
                "subNavY": "37.55628772",
                "subNavX": "126.92272084",
                "subRpFlag": "8",
                "subPoiId": "1133444",
                "subNavSeq": "1",
                "subParkYn": "0",
                "subClassCd": "01012804",
                "subClassNmA": "교통편의",
                "subClassNmB": "교통시설",
                "subClassNmC": "지하철출구번호",
                "subClassNmD": "2호선"
              }
            ]
          },
          "newAddressList":{
            "newAddress":[
              {
                "centerLat": "37.54387299",
                "centerLon": "126.95007981",
                "frontLat": "37.54395631",
                "frontLon": "126.95013536",
                "roadName": "백범로",
                "bldNo1": "178",
                "bldNo2": "",
                "roadId": "00232",
                "fullAddressRoad": "서울 마포구 백범로 178"
              }
            ]
          }
        }
      ]
    }
  }
}
  • 명칭(POI) 통합 검색 RESPONSE ( Type : xml)
<!--?xml version="1.0" encoding="UTF-8" ?-->
    <searchpoiinfo>
        <totalcount>65</totalcount>
        <count>2</count>
        <page>1</page>
        <pois>
            <poi>
                <id>4670161</id>
                <pkey>37446900</pkey>
                <navseq>0</navseq>
                <collectiontype>poi</collectiontype>
                <name>빈스빈스마포공덕점</name>
                <telno></telno>
                <frontlat>37.544289</frontlat>
                <frontlon>126.950107</frontlon>
                <noorlat>37.543872</noorlat>
                <noorlon>126.950052</noorlon>
                <upperaddrname>서울</upperaddrname>
                <middleaddrname>마포구</middleaddrname>
                <loweraddrname>공덕동</loweraddrname>
                <detailaddrname></detailaddrname>
                <mlcass></mlcass>
                <firstno>461</firstno>
                <secondno></secondno>
                <roadname></roadname>
                <firstbuildno></firstbuildno>
                <secondbuildno></secondbuildno>
                <radius>0</radius>
                <bizname></bizname>
                <upperbizname>생활편의</upperbizname>
                <middlebizname>술집</middlebizname>
                <lowerbizname>바</lowerbizname>
                <detailbizname>기타</detailbizname>
                <rpflag>16</rpflag>
                <parkflag></parkflag>
                <detailinfoflag></detailinfoflag>
                <desc></desc>
                <datakind>6</datakind>
                <zipcode>04524</zipcode>
                <evchargers>
                <evcharger>
                <operatorid>KP</operatorid>
                <stationid>KP000207</stationid>
                <chargerid>01</chargerid>
                <status>2</status>
                <type>06</type>
                <powertype></powertype>
                <operatorname>…</operatorname>
                <chargingdatetime>20210906111707</chargingdatetime>
                <updatedatetime>20210906115434</updatedatetime>
                <isfast>Y</isfast>
                <isavailable>Y</isavailable>
                </evcharger>
                </evchargers>
                <groupsublists>
                <groupsub>
                <subpkey>113344401</subpkey>
                <subseq>1</subseq>
                <subname>
                    <!--[CDATA[1번출구 ]]-->
                </subname>
                <subcentery>37.55628772</subcentery>
                <subcenterx>126.92272084</subcenterx>
                <subnavy>37.55628772</subnavy>
                <subnavx>126.92272084</subnavx>
                <subrpflag>8</subrpflag>
                <subpoiid>1133444</subpoiid>
                <subnavseq>1</subnavseq>
                <subparkyn>0</subparkyn>
                <subclasscd>01012804</subclasscd>
                <subclassnma>
                    <!--[CDATA[교통편의 ]]-->
                </subclassnma>
                <subclassnmb>
                    <!--[CDATA[교통시설 ]]-->
                </subclassnmb>
                <subclassnmc>
                    <!--[CDATA[지하철출구번호 ]]-->
                </subclassnmc>
                <subclassnmd>
                    <!--[CDATA[2호선 ]]-->
                </subclassnmd>
                </groupsub>
                </groupsublists>
                <newaddresslist>
                <newaddress>
                <centerlat>37.54387299</centerlat>
                <centerlon>126.95007981</centerlon>
                <frontlat>37.54395631</frontlat>
                <frontlon>126.95013536</frontlon>
                <roadname>백범로</roadname>
                <bldno1>178</bldno1>
                <bldno2></bldno2>
                <roadid>00232</roadid>
                <fulladdressroad>서울 마포구 백범로 178</fulladdressroad>
                </newaddress>
                </newaddresslist>
            </poi>
            <poi>
                <id>4778454</id>
                <pkey>191276601</pkey>
                <navseq>1</navseq>
                <collectiontype>poi</collectiontype>
                <name>티롤</name>
                <telno></telno>
                <frontlat>37.544289</frontlat>
                <frontlon>126.949635</frontlon>
                <noorlat>37.544261</noorlat>
                <noorlon>126.949607</noorlon>
                <upperaddrname>서울</upperaddrname>
                <middleaddrname>마포구</middleaddrname>
                <loweraddrname>공덕동</loweraddrname>
                <detailaddrname></detailaddrname>
                <mlcass></mlcass>
                <firstno>461</firstno>
                <secondno></secondno>
                <roadname></roadname>
                <firstbuildno></firstbuildno>
                <secondbuildno></secondbuildno>
                <radius>0</radius>
                <bizname></bizname>
                <upperbizname>생활편의</upperbizname>
                <middlebizname>술집</middlebizname>
                <lowerbizname>바</lowerbizname>
                <detailbizname>기타</detailbizname>
                <rpflag>16</rpflag>
                <parkflag></parkflag>
                <detailinfoflag></detailinfoflag>
                <desc></desc>
                <datakind>6</datakind>
                <zipcode>04524</zipcode>
                <evchargers>
                <evcharger>
                <operatorid>KP</operatorid>
                <stationid>KP000207</stationid>
                <chargerid>01</chargerid>
                <status>2</status>
                <type>06</type>
                <powertype></powertype>
                <operatorname>…</operatorname>
                <chargingdatetime>20210906111707</chargingdatetime>
                <updatedatetime>20210906115434</updatedatetime>
                <isfast>Y</isfast>
                <isavailable>Y</isavailable>
                </evcharger>
                </evchargers>
                <groupsublists>
                <groupsub>
                <subpkey>113344401</subpkey>
                <subseq>1</subseq>
                <subname>
                    <!--[CDATA[1번출구 ]]-->
                </subname>
                <subcentery>37.55628772</subcentery>
                <subcenterx>126.92272084</subcenterx>
                <subnavy>37.55628772</subnavy>
                <subnavx>126.92272084</subnavx>
                <subrpflag>8</subrpflag>
                <subpoiid>1133444</subpoiid>
                <subnavseq>1</subnavseq>
                <subparkyn>0</subparkyn>
                <subclasscd>01012804</subclasscd>
                <subclassnma>
                    <!--[CDATA[교통편의 ]]-->
                </subclassnma>
                <subclassnmb>
                    <!--[CDATA[교통시설 ]]-->
                </subclassnmb>
                <subclassnmc>
                    <!--[CDATA[지하철출구번호 ]]-->
                </subclassnmc>
                <subclassnmd>
                    <!--[CDATA[2호선 ]]-->
                </subclassnmd>
                </groupsub>
                </groupsublists>
                <newaddresslist>
                <newaddress>
                <centerlat>37.54387299</centerlat>
                <centerlon>126.95007981</centerlon>
                <frontlat>37.54395631</frontlat>
                <frontlon>126.95013536</frontlon>
                <roadname>백범로</roadname>
                <bldno1>178</bldno1>
                <bldno2></bldno2>
                <roadid>00232</roadid>
                <fulladdressroad>서울 마포구 백범로 178</fulladdressroad>
                </newaddress>
                </newaddresslist>
            </poi>
        </pois>
    </searchpoiinfo>

명칭(POI) 상세 검색

  • REQUEST ( 명칭(POI) 상세 검색 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/pois/poiInfo?version=1&resCoordType=WGS84GEO&appKey=ja58s-z15a78-la714-5s67a' \
     --header 'Accept: application/json'
  • RESPONSE ( 명칭(POI) 상세 검색 )

Name

Date Type

Mandatory

Example

Description

poiDetailInfo

Node

Y

POI 상세정보입니다.

viewId

String

업종 구분 코드
(3:주유소, 4:충전소, 6:EV충전소)

id

String

N

2034197

POI ID입니다.

dbKind

String

N

시설물DB 입니다.
"S" : POI, "J" : 지번주소, "R" : 도로주소

pkey

String

N

POI 식별자 (POI와 입구점을 포함한 식별자) 입니다.

navSeq

String

N

입구점 일련번호입니다.

name

String

N

건국대학병원

시설물 명칭입니다.

bizCatName

String

N

의료시설

업종명입니다.

address

String

N

서울 관악구 신림동

주소입니다.

firstNo

String

N

142

본번입니다.

secondNo

String

N

23

부번입니다

zipCode

Node

N

123-234

우편번호입니다. (미제공 중)

tel

Node

N

1544-3432

전화번호입니다.

mlClass

String

N

1

산/대지구분(구주소)

lcdName

String

N

서울

표출 주소 대분류명입니다.

mcdName

String

N

관악구

표출 주소 중분류명입니다.

scdName

String

N

신림동

표출 주소 소분류명입니다.

dcdName

String

N

표출 주소 상세분류명입니다.

bldAddr

String

N

서울 관악구 신림로

새주소입니다.

roadScdName

String

N

도로명 소분류명입니다.

roadName

String

N

신림로

도로명입니다.

bldNo1

String

N

90

건물번호1(새주소)입니다.

bldNo2

String

N

0

건물번호2(새주소)입니다.

frontlat

Number

N

37.470947057194365

시설물 입구 위도 좌표입니다.

frontlon

Number

N

126.939376564495

시설물 입구 경도 좌표입니다.

lat

Number

N

37.470947057194365

중심점 위도 좌표입니다.

lon

Number

N

126.939376564495

중심점 경도 좌표입니다.

menu1

String

N

메뉴 1입니다.

menu2

String

N

메뉴 2입니다.

menu3

String

N

메뉴 3입니다.

menu4

String

N

메뉴 4입니다.

menu5

String

N

메뉴 5입니다.

parkFlag

Number

N

0

주차 가능 여부입니다. - 0: 주차 불가능 - 1: 주차 가능 - null: 정보 없음

twFlag

Number

N

0

평일 24시간 영업 여부입니다. - 0: 24시간 영업 안함 - 1: 24시간 영업

yaFlag

Number

N

0

연중 무휴 여부입니다. - 0: 휴무 있음 - 1: 연중 무휴

homepageURL

String

N

홈페이지입니다.

routeInfo

String

N

찾아가는 길입니다.

facility

String

N

부대시설 정보입니다. - 부대 시설명입니다. 10개 정도(구분자: 콤마(,))를 입력할 수 있습니다.

upperLegalCode

String

N

11

법정 대분류입니다.

middleLegalCode

String

N

620

법정 중분류입니다.

lowerLegalCode

String

N

102

법정 소분류입니다.

detailLegalCode

String

N

00

법정 세분류입니다.

upperAdminCode

String

N

00

행정 대분류입니다.

middleAdminCode

String

N

11

행정 중분류입니다.

lowerAdminCode

String

N

659

행정 소분류입니다.

upperCode

String

N

11

제공 대분류입니다.

middleCode

String

N

620

제공 중분류입니다.

lowerCode

String

N

102

제공 소분류입니다.

point

Number

N

1

별점 평가 점수입니다. - 유효값: 1 ~ 5

merchantFlag

String

N

OKCB;(OKCashbag 가맹점),OKCB;GIFT;(OKCashbag/기프티콘 가맹점),OKCB;TMEM;GIFT;SSCD;(OKCashbag/T 멤버십/기프티콘/삼성카드 가맹점)

가맹점 여부 정보입니다. - 세미콜론(;)으로 구분합니다.

merchantDispType

String

N

가맹점 화면 타입입니다. - 세미콜론(;)으로 구분합니다. - 현재 OK 캐시백, T 멤버쉽, 기타 세 가지로 간주하고 작성합니다. 가맹점의 View Type이 없으면, X Type으로 간주합니다. - 가맹점 여부 정보가 OKCB;GIFT; 이면 ATYP;XTYP;로 표시 - OKCB;TMEM;GIFT;SSCD; 이면 ATYP;BTYP;XTYP;CTYP;로 표시

additionalInfo

String

N

[대표메뉴]스파게티,피자;[주차여부]주차가능

부가 정보입니다.(구분자: 세미콜론(;))

desc

String

N

업소 소개입니다.

  • 명칭(POI) 상세 검색 RESPONSE ( 전기차 충전소 추가 정보 )

Name

Date Type

Mandatory

Example

Description

mngName

String

N

운영기관

mngId

String

N

기관 관리ID

freeYn

String

N

주차비무료여부

reservYn

String

N

예약가능여부

useTime

String

N

이용가능시간

payYn

String

N

유료여부

fee

String

N

단가

updateDt

String

N

충전상태수집일시 (YYYYMMDD HH24:MI:SS)
(예 :20180416 17:24:46)

totalCnt

int

N

충전기 갯수

evChargers

node

N

충전기 리스트

bid

String

Y

기관코드
BG – 비긴스
JE – 제주전기자동차서비스
KP – 한국전력
HE – 한국전기차충전서비스
PI – 포스코ICT
SE – 서울시
PW – 파웤큐브
CT – 씨티카
ME – 환경부
JD – 제주특별자치도청
TM – 티맵
HM – 현대자동차네비게이션

sid

String

Y

충전소ID

cid

String

Y

충전기ID

type

String

Y

충전기타입 (01,02,03,04,05,06,07)
01 - DC차데모
02 - 승용차 AC완속
03 - DC차데모+AC3상
04 - DC콤보
05 - DC차데모+DC콤보
06 - DC차데모+AC3상+DC콤보
07 - AC급속3상

status

String

Y

상태정보 (0,1,2,3,4,5,6,9)
0 - 알수없음
1 - 통신이상
2 - 충전대기
3 - 충전중
4 - 운영중지
5 - 점검중
6 - 예약중
9 - 상태 미확인

evPowerType

String

N

ev충전기 충전량
Ex)급속(200kW동시),급속(50kW)

chargingDateTime

String

N

마지막 충전 시각(YYYYMMDDHH24MISS)
Ex)20190919181030

updateDateTime

String

N

최종 변경 시각(YYYYMMDDHH24MISS)
Ex)20190919181030

calculatedDateTime

String

N

충전상태별 소요시간(초단위)
status가 3(충전중)일 경우 충전 경과 시간
나머지 경우 마지막 충전 완료 후 경과 시간

  • 명칭(POI) 상세 검색 RESPONSE ( type : javascript )
function(
    {"poiDetailInfo": {
        "id": "ABCD1235",
        "viewId": "업종 구분 코드",
        "dbKind": "S",
        "pkey": "848028901",
        "navSeq": "1",
        "name": "시설물2",
        "bizCatName ": "주유소",
        "address": "서울 광진구 자양1동",
        "firstNo": 111,
        "secondNo": 11,
        "zipCode": "123-456",
        "tel": "02-1234-9876",
        "mlClass": "1",
        "lcdName": "서울",
        "mcdName": "관악구",
        "scdName": "신림동","lcdName": "서울",
        "mcdName": "관악구",
        "scdName": "신림동",
        "dcdName": "",
        "bldAddr": "서울 관악구 신림로",
        "roadScdName": "",
        "roadName": "신림로",
        "bldNo1": "90",
        "bldNo2": "0",
        "dcdName": "",
        "bldAddr": "서울 관악구 신림로",
        "roadScdName": "",
        "roadName": "신림로",
        "bldNo1": "90",
        "bldNo2": "0",
        "frontlat": "37.xxx0",
        "frontlon": "126.xxx0",
        "lat": "37.xxx0",
        "lon": "126.xxx0",
        "menu1": "menu1",
        "menu2": "menu2",
        "menu3": "menu3",
        "menu4": "menu4",
        "menu5": "menu5",
        "parkFlag": 0,
        "twFlag": 0,
        "yaFlag": 0,
        "homepageURL": "http://www.homepage.co.kr",
        "routeInfo": "사거리에서 우회전",
        "facility": "수동세차장",
        "upperLegalCode": "AA",
        "middleLegalCode": "A00",
        "lowerLegalCode": "AA0",
        "detailLegalCode": "00",
        "upperAdminCode": "BB",
        "middleAdminCode": "B00",
        "lowerAdminCode": "BB0",
        "upperCode": "CC",
        "middleCode": "C00",
        "lowerCode": "CC0",
        "point": 4,
        "merchantDispType": "ATYP:XTYP",
        "merchantFlag": "OKCB:TMEM",
        "additionalInfo": "부가정보입니다.",
        "desc": "소개 내용입니다."
        "mngName": "운영기관",
        "mngId": "기관 관리ID",
        "freeYn": "주차비무료여부",
        "reservYn": "예약가능여부",
        "useTime": "이용가능시간",
        "payYn": "유료여부",
        "fee": "단가",
        "updateDt": "충전상태수집일시",
        "totalCnt": "충전기 갯수",
        "evChargers": [
          {
            "bid": "기관코드",
            "sid": "충전소ID",
            "cid": "충전기ID",
            "type": "충전기타입",
            "status": "상태정보",
            "evPowerType": "",
            "chargingDateTime": "",
            "updateDateTime": "20210802114617",
            "calculatedDateTime": ""
          }
        ]
    }}
)
  • 명칭(POI) 상세 검색 RESPONSE ( type : json)
{
  "poiDetailInfo": {
    "id": "ABCD1235",
    "viewId": "업종 구분 코드",
    "dbKind": "S",
    "pkey": "848028901",
    "navSeq": "1",
    "name": "시설물2",
    "bizCatName ": "주유소",
    "address": "서울 광진구 자양1동",
    "firstNo": 111,
    "secondNo": 11,
    "zipCode": "123-456",
    "tel": "02-1234-9876",
    "mlClass": "1",
    "lcdName": "서울",
    "mcdName": "관악구",
    "scdName": "신림동",
    "dcdName": "",
    "bldAddr": "서울 관악구 신림로",
    "roadScdName": "",
    "roadName": "신림로",
    "bldNo1": "90",
    "bldNo2": "0",
    "frontlat": "37.xxx0",
    "frontlon": "126.xxx0",
    "lat": "37.xxx0",
    "lon": "126.xxx0",
    "menu1": "menu1",
    "menu2": "menu2",
    "menu3": "menu3",
    "menu4": "menu4",
    "menu5": "menu5",
    "parkFlag": 0,
    "twFlag": 0,
    "yaFlag": 0,
    "homepageURL": "http://www.homepage.co.kr",
    "routeInfo": "사거리에서 우회전",
    "facility": "수동세차장",
    "upperLegalCode": "AA",
    "middleLegalCode": "A00",
    "lowerLegalCode": "AA0",
    "detailLegalCode": "00",
    "upperAdminCode": "BB",
    "middleAdminCode": "B00",
    "lowerAdminCode": "BB0",
    "upperCode": "CC",
    "middleCode": "C00",
    "lowerCode": "CC0",
    "point": 4,
    "merchantDispType": "ATYP:XTYP",
    "merchantFlag": "OKCB:TMEM",
    "additionalInfo": "부가정보입니다.",
    "desc": "소개 내용입니다."
    "mngName": "운영기관",
    "mngId": "기관 관리ID",
    "freeYn": "주차비무료여부",
    "reservYn": "예약가능여부",
    "useTime": "이용가능시간",
    "payYn": "유료여부",
    "fee": "단가",
    "updateDt": "충전상태수집일시",
    "totalCnt": "충전기 갯수",
    "evChargers": [
      {
        "bid": "기관코드",
        "sid": "충전소ID",
        "cid": "충전기ID",
        "type": "충전기타입",
        "status": "상태정보",
        "evPowerType": "",
        "chargingDateTime": "",
        "updateDateTime": "20210802114617",
        "calculatedDateTime": ""
      }
    ]
    }
}
  • 명칭(POI) 상세 검색 Error code index

    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

주변 POI 카테고리 검색

  • REQUEST ( 주변 POI 카테고리 검색 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/pois/search/around?version=1&page=1&count=20&centerLon=15.21648&centerLat=22.1856448&radius=0&reqCoordType=WGS84GEO&resCoordType=WGS84GEO&multiPoint=N&appKey=s5a9q-hndjs-jks78-k8si1' \
     --header 'Accept: application/json'
  • RESPONSE ( 주변 POI 카테고리 검색 )

Name

Date Type

Mandatory

Example

Description

searchPoiInfo

Node

Y

POI 조회 정보입니다.

totalCount

Number

Y

86

조회 결과의 총 개수입니다. - 조회 결과가 없을 경우 0

count

Number

Y

20

페이지당 출력되는 개수입니다.

page

Number

Y

1

조회한 페이지 번호입니다.

pois

Node

N

POI 목록입니다.

poi

Node

N

POI 정보입니다.

id

String

N

POI ID입니다.

name

String

N

시설물 명칭입니다.

telNo

String

N

전화번호입니다.

frontLat

Number

N

시설물 입구 위도 좌표입니다.

frontLon

Number

N

시설물 입구 경도 좌표입니다.

noorLat

Number

N

중심점 위도 좌표입니다.

noorLon

Number

N

중심점 경도 좌표입니다.

upperAddrName

String

N

표출 주소 대분류명입니다.

middleAddrName

String

N

표출 주소 중분류명입니다.

lowerAddrName

String

N

표출 주소 소분류명입니다.

detailAddrName

String

N

표출 주소 세분류명입니다.

mlClass

String

N

1

산/대지구분(구주소)

firstNo

String

N

본번입니다.

roadName

String

N

도로명입니다.

buildingNo1

String

N

건물번호 1입니다.

buildingNo2

String

N

건물번호 2입니다.

rpFlag

String

N

길 안내 요청에 필요한 값으로 길 안내 목적지 설정 시, 여기서 받은 rpFlag 값을 설정해야 합니다.

radius

String

N

0.66

거리 (km)

dataKind

String

N

3

주유소 구분 - 3 : 주유소 - 4 : 충전소 - 6 : EV충전소

stId

String

N

SK

주유소브랜드 정보

highHhSale

Number

N

1

고급휘발유 판매여부 - 1 : 판매 - 2 : 판매안함 (확인 불가시 null)

minOilYn

String

N

Y

고급휘발유 판매점 여부 - Y : 최저가 점포 - N : 최저가 점포 아님 (확인 불가시 null)

oilBaseSdt

String

N

20240220

기준일(YYYYMMDD) Ex) “20240220”일 경우 2024년2월 20일

secondNo

String

N

부번입니다.

parkFlag

String

N

주차 가능 유무입니다. - 0: 주차 불가능 - 1: 주차 가능 - null: 정보 없음

merchantFlag

Node

N

OKCB;TMEM;GIFT;SSCD

가맹점의 정보를 ‘;’을 구분자로 나열 합니다. - OKCB : OKCashbag 가맹점 - GIFT : 기프티콘 - TMEM : T멤버십, TMC - SSCD : 삼성카드 - OKMY : OK마이샵

pkey

String

N

37446900

POI 식별자 입니다.

evChargers

Node

N

충전기 리스트

evCharger

Node

N

충전기 정보

operatorId

String

N

ev충전소 제공 업체

stationId

String

N

충전소 id

chargerId

String

N

충전기 id

status

String

N

상태정보 (0,1,2,3,4,5,6,9)
0 - 알수없음
1 - 통신이상
2 - 충전대기
3 - 충전중
4 - 운영중지
5 - 점검중
6 - 예약중
9 - 상태 미확인

type

String

N

충전기타입 (01,02,03,04,05,06,07)
01 - DC차데모
02 - 승용차 AC완속
03 - DC차데모+AC3상
04 - DC콤보
05 - DC차데모+DC콤보
06 - DC차데모+AC3상+DC콤보
07 - AC급속3상

powerType

String

N

ev충전기 충전량
Ex)급속(200kW동시),급속(50kW)

operatorName

String

N

제공 업체명

chargingDateTime

String

N

마지막 충전 시각(YYYYMMDDHH24MISS)
Ex)20190919181030

updateDateTime

String

N

최종 변경 시각(YYYYMMDDHH24MISS)
Ex)20190919181030

isFast

String

N

급속 충전 여부

isAvailable

String

N

사용 가능 여부

  • 주변 POI 카테고리 검색 RESPONSE( type : javascript )
function (
  {
    "searchPoiInfo": {
      "totalCount": "5",
      "count": "2",
      "page": "1",
      "pois": {
        "poi": [
          {
            "id": "2779176",
            "name": "GS25 화곡대원점",
            "telNo": "0805552525",
            "frontLat": "37.5447042",
            "frontLon": "126.8358957",
            "noorLat": "37.5446486",
            "noorLon": "126.8358680",
            "upperAddrName": "서울",
            "middleAddrName": "강서구",
            "lowerAddrName": "화곡동",
            "detailAddrName": "",
            "mlClass": "1",
            "firstNo": "1021",
            "roadName": "화곡로21길",
            "buildingNo1": "87",
            "buildingNo2": "0",
            "rpFlag": "16",
            "radius": "0.05",
            "dataKind": "3",
            "stId": "SK",
            "highHhSale": "1",
            "minOilYn": "Y",
            "oilBaseSdt": "20140220",
            "pkey": "788491401",
            "evChargers":{
              "evCharger":[
                {
                  "operatorId": "EV",
                  "stationId": "EV003458",
                  "chargerId": "01",
                  "status": "2",
                  "type": "02",
                  "powerType": "",
                  "operatorName": "",
                  "chargingDateTime": "20210910003307",
                  "updateDateTime": "20210910003646",
                  "isFast": "N",
                  "isAvailable": "Y"
                }
              ]
            }
          },
          {
            "id": "3837674",
            "name": "CU 화곡프라임점",
            "telNo": "0226079391",
            "frontLat": "37.5450097",
            "frontLon": "126.8362568",
            "noorLat": "37.5452041",
            "noorLon": "126.8363401",
            "upperAddrName": "서울",
            "middleAddrName": "강서구",
            "lowerAddrName": "화곡동",
            "detailAddrName": "",
            "mlClass": "1",
            "firstNo": "1024",
            "secondNo": "23",
            "roadName": "강서로33가길",
            "buildingNo1": "86",
            "buildingNo2": "0",
            "rpFlag": "16",
            "merchantFlag": "OKCB;GIFT;",
            "radius": "0.11",
            "dataKind": "3",
            "stId": "SK",
            "highHhSale": "1",
            "minOilYn": "Y",
            "oilBaseSdt": "20140220",
            "pkey": "37446900",
            "evChargers":{
              "evCharger":[
                {
                  "operatorId": "EV",
                  "stationId": "EV003458",
                  "chargerId": "01",
                  "status": "2",
                  "type": "02",
                  "powerType": "",
                  "operatorName": "",
                  "chargingDateTime": "20210910003307",
                  "updateDateTime": "20210910003646",
                  "isFast": "N",
                  "isAvailable": "Y"
                }
              ]
            }
          }
        ]
      }
    }
  }
)
  • 주변 POI 카테고리 검색 RESPONSE( type : json)
{
  "searchPoiInfo": {
    "totalCount": "5",
    "count": "2",
    "page": "1",
    "pois": {
      "poi": [
        {
          "id": "2779176",
          "name": "GS25 화곡대원점",
          "telNo": "0805552525",
          "frontLat": "37.5447042",
          "frontLon": "126.8358957",
          "noorLat": "37.5446486",
          "noorLon": "126.8358680",
          "upperAddrName": "서울",
          "middleAddrName": "강서구",
          "lowerAddrName": "화곡동",
          "detailAddrName": "",
          "mlClass": "1",
          "firstNo": "1021",
          "roadName": "화곡로21길",
          "buildingNo1": "87",
          "buildingNo2": "0",
          "rpFlag": "16",
          "radius": "0.05",
          "dataKind": "3",
          "stId": "SK",
          "highHhSale": "1",
          "minOilYn": "Y",
          "oilBaseSdt": "20140220",
          "pkey": "788491401",
          "evChargers":{
            "evCharger":[
              {
                "operatorId": "EV",
                "stationId": "EV003458",
                "chargerId": "01",
                "status": "2",
                "type": "02",
                "powerType": "",
                "operatorName": "",
                "chargingDateTime": "20210910003307",
                "updateDateTime": "20210910003646",
                "isFast": "N",
                "isAvailable": "Y"
              }
            ]
          }
        },
        {
          "id": "3837674",
          "name": "CU 화곡프라임점",
          "telNo": "0226079391",
          "frontLat": "37.5450097",
          "frontLon": "126.8362568",
          "noorLat": "37.5452041",
          "noorLon": "126.8363401",
          "upperAddrName": "서울",
          "middleAddrName": "강서구",
          "lowerAddrName": "화곡동",
          "detailAddrName": "",
          "mlClass": "1",
          "firstNo": "1024",
          "secondNo": "23",
          "roadName": "강서로33가길",
          "buildingNo1": "86",
          "buildingNo2": "0",
          "rpFlag": "16",
          "parkFlag": "0",
          "merchantFlag": "OKCB;GIFT;",
          "radius": "0.11",
          "dataKind": "3",
          "stId": "SK",
          "highHhSale": "1",
          "minOilYn": "Y",
          "oilBaseSdt": "20140220",
          "pkey": "37446900",
          "evChargers":{
            "evCharger":[
              {
                "operatorId": "EV",
                "stationId": "EV003458",
                "chargerId": "01",
                "status": "2",
                "type": "02",
                "powerType": "",
                "operatorName": "",
                "chargingDateTime": "20210910003307",
                "updateDateTime": "20210910003646",
                "isFast": "N",
                "isAvailable": "Y"
              }
            ]
          }
        }
      ]
    }
  }
}
  • 주변 POI 카테고리 검색 RESPONSE( type : xml)
<!--?xml version="1.0" encoding="UTF-8" ?-->
<searchpoiinfo>
    <totalcount>5</totalcount>
    <count>2</count>
    <page>1</page>
    <pois>
        <poi>
            <id>2779176</id>
            <name>GS25 화곡대원점</name>
            <telno>0805552525</telno>
            <frontlat>37.5447042</frontlat>
            <frontlon>126.8358957</frontlon>
            <noorlat>37.5446486</noorlat>
            <noorlon>126.8358680</noorlon>
            <upperaddrname>서울</upperaddrname>
            <middleaddrname>강서구</middleaddrname>
            <loweraddrname>화곡동</loweraddrname>
            <detailaddrname></detailaddrname>
            <mlclass></mlclass>
            <firstno>1021</firstno>
            <roadname>화곡로21길</roadname>
            <buildingno1>87</buildingno1>
            <buildingno2>0</buildingno2>
            <rpflag>16</rpflag>
            <radius>0.05</radius>
            <datakind>3</datakind>
            <stid>SK</stid>
            <highhhsale>1</highhhsale>
            <minoilyn>Y</minoilyn>
            <oilbasesdt>20140220</oilbasesdt>
            <pkey>788491401</pkey>
            <evchargers>
            <evcharger>
            <operatorid>EV</operatorid>
            <stationid>EV003458</stationid>
            <chargerid>01</chargerid>
            <status>2</status>
            <type>02</type>
            <powertype></powertype>
            <operatorname></operatorname>
            <chargingdatetime>20210910003307</chargingdatetime>
            <updatedatetime>20210910003646</updatedatetime>
            <isfast>N</isfast>
            <isavailable>Y</isavailable>
            </evcharger>
            </evchargers>
        </poi>
        <poi>
            <id>3837674</id>
            <name>CU 화곡프라임점</name>
            <telno>0226079391</telno>
            <frontlat>37.5450097</frontlat>
            <frontlon>126.8362568</frontlon>
            <noorlat>37.5452041</noorlat>
            <noorlon>126.8363401</noorlon>
            <upperaddrname>서울</upperaddrname>
            <middleaddrname>강서구</middleaddrname>
            <loweraddrname>화곡동</loweraddrname>
            <detailaddrname></detailaddrname>
            <mlclass></mlclass>
            <firstno>1024</firstno>
            <secondno>23</secondno>
            <roadname>강서로33가길</roadname>
            <buildingno1>86</buildingno1>
            <buildingno2>0</buildingno2>
            <rpflag>16</rpflag>
            <parkflag>0</parkflag>
            <merchantflag>OKCB;GIFT;</merchantflag>
            <radius>0.11</radius>
            <datakind>3</datakind>
            <stid>SK</stid>
            <highhhsale>1</highhhsale>
            <minoilyn>Y</minoilyn>
            <oilbasesdt>20140220</oilbasesdt>
            <pkey>37446900</pkey>
            <evchargers>
            <evcharger>
            <operatorid>EV</operatorid>
            <stationid>EV003458</stationid>
            <chargerid>01</chargerid>
            <status>2</status>
            <type>02</type>
            <powertype></powertype>
            <operatorname></operatorname>
            <chargingdatetime>20210910003307</chargingdatetime>
            <updatedatetime>20210910003646</updatedatetime>
            <isfast>N</isfast>
            <isavailable>Y</isavailable>
            </evcharger>
            </evchargers>
        </poi>
    </pois>
</searchpoiinfo>
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.

읍면동/도로명 조회

  • REQUEST ( 읍면동/도로명 조회 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/poi/findPoiAreaDataByName?version=1&count=15&page=12&area_dong=area_dong&addressType=all&appKey=a1824-189d5-ws48a-s527g' \
     --header 'Accept: application/json'
  • RESPONSE ( 읍면동/도로명 조회 )

Name

Date Type

Mandatory

Example

Description

findPoiAreaDataByNameInfo

Node

N

totalCnt

Number

N

총 개수입니다.

listCnt

Number

N

목록 개수입니다.

contFlag

String

N

계속 구분 여부 입니다.

  • 1 : 다음페이지 존재
  • 0 : 다음 페이지 없음

dongInfo

Node

N

주소 리스트 입니다.

address

String

N

주소입니다.

resLon

String

N

경도 좌표 (X좌표)입니다.

resLat

String

N

위도 좌표 (Y좌표)입니다.

  • 읍면동/도로명 조회 RESPONSE ( type : javascript )
function (
{
    "findPoiAreaDataByNameInfo":{
        "totalCnt": "2",
        "listCnt": "2",
        "contFlag": "0",
        "dongInfo": [
            {
                 "address": "경기 평택시 합정동",
                "resLon": "127.099637",
                "resLat": "36.989967"
            },
            {
                 "address": "서울 마포구 합정동",
                "resLon": "126.90575",
                "resLat": "37.549649"
            }
        ]
    }
}
)
  • 읍면동/도로명 조회 RESPONSE ( type : json )
{
    "findPoiAreaDataByNameInfo":{
        "totalCnt": "2",
        "listCnt": "2",
        "contFlag": "0",
        "dongInfo": [
            {
                 "address": "경기 평택시 합정동",
                "resLon": "127.099637",
                "resLat": "36.989967"
            },
            {
                 "address": "서울 마포구 합정동",
                "resLon": "126.90575",
                "resLat": "37.549649"
            }
        ]
    }
}
  • 읍면동/도로명 조회 RESPONSE ( type : xml)
<findpoiareadatabynameinfo>
    <totalcnt>2</totalcnt>
    <listcnt>2</listcnt>
    <contflag>0</contflag>
    <donginfo>
        <address><!--[CDATA[경기 평택시 합정동]]--></address>
        <reslon>127.099637</reslon>
        <reslat>36.989967</reslat>
    </donginfo>
    <donginfo>
        <address><!--[CDATA[서울 마포구 합정동]]--></address>
        <reslon>126.90575</reslon>
        <reslat>37.549649</reslat>
    </donginfo>
</findpoiareadatabynameinfo>
  • Error code index

지역분류코드검색

  • REQUEST ( 지역분류코드검색 )
curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/poi/areascode?version=1&count=12&page=14&areaTypCd=01&largeCdFlag=Y&middleCdFlag=N&smallCdFlag=N&appKey=a4s8e-hjs8w-ks912-hdji2' \
     --header 'Accept: application/json'
  • RESPONSE ( 지역분류코드검색 type: json )

Name

Date Type

Mandatory

Example

Description

areaCodeInfo

Node

N

지역코드 정보

totalCnt

String

N

17

총 개수

listCnt

String

N

10

조회된 목록개수

contFlag

String

N

1

계속 구분 - 0 : 다음페이지 없음 - 1 : 다음페이지 존재

poiAreaCodes

Node

N

지역코드 리스트

areaDepth

String

N

L

지역 레벨 - L : 대분류 - M : 중분류 - S : 소분류

largeCd

String

N

11

지역 대분류 코드

middleCd

String

N

000

지역 중분류 코드

smallCd

String

N

000

지역 소분류 코드

districtName

String

N

서울

지역명칭 (areaDepth가 L 이면 대분류명, M 이면 중분류명, S이면 소분류명)

  • RESPONSE ( 지역분류코드검색 type: json )

Name

Date Type

Mandatory

Example

Description

areaCodeInfo

Node

N

지역코드 정보

totalCnt

String

N

17

총 개수

listCnt

String

N

10

조회된 목록개수

contFlag

String

N

1

계속 구분 - 0 : 다음페이지 없음 - 1 : 다음페이지 존재

poiAreaCodes

Node

N

지역코드 리스트

poiAreaCode

Node

N

지역코드

areaDepth

String

N

L

지역 레벨 - L : 대분류 - M : 중분류 - S : 소분류

largeCd

String

N

11

지역 대분류 코드

middleCd

String

N

000

지역 중분류 코드

smallCd

String

N

000

지역 소분류 코드

districtName

Node

N

서울

지역명칭 (areaDepth가 L 이면 대분류명, M 이면 중분류명, S이면 소분류명)

  • 지역분류코드검색 RESPONSE ( type: javascript )
functon({
    "areaCodeInfo": {
        "totalCnt": "17",
        "listCnt": "10",
        "contFlag": "1",
        "poiAreaCodes": [{
            "areaDepth": "L",
            "largeCd": "11",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "서울"
        }, {
            "areaDepth": "L",
            "largeCd": "26",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "부산"
        }, {
            "areaDepth": "L",
            "largeCd": "27",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "대구"
        }, {
            "areaDepth": "L",
            "largeCd": "28",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "인천"
        }, {
            "areaDepth": "L",
            "largeCd": "29",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "광주"
        }, {
            "areaDepth": "L",
            "largeCd": "30",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "대전"
        }, {
            "areaDepth": "L",
            "largeCd": "31",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "울산"
        }, {
            "areaDepth": "L",
            "largeCd": "36",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "세종"
        }, {
            "areaDepth": "L",
            "largeCd": "41",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "경기"
        }, {
            "areaDepth": "L",
            "largeCd": "42",
            "middleCd": "000",
            "smallCd": "000",
            "districtName": "강원"
        }]
    }
})
  • 지역분류코드검색 RESPONSE ( type: json)
{
  "areaCodeInfo": {
    "totalCnt": "17",
    "listCnt": "10",
    "contFlag": "1",
    "poiAreaCodes": [
      {
        "areaDepth": "L",
        "largeCd": "11",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "서울"
      },
      {
        "areaDepth": "L",
        "largeCd": "26",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "부산"
      },
      {
        "areaDepth": "L",
        "largeCd": "27",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "대구"
      },
      {
        "areaDepth": "L",
        "largeCd": "28",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "인천"
      },
      {
        "areaDepth": "L",
        "largeCd": "29",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "광주"
      },
      {
        "areaDepth": "L",
        "largeCd": "30",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "대전"
      },
      {
        "areaDepth": "L",
        "largeCd": "31",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "울산"
      },
      {
        "areaDepth": "L",
        "largeCd": "36",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "세종"
      },
      {
        "areaDepth": "L",
        "largeCd": "41",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "경기"
      },
      {
        "areaDepth": "L",
        "largeCd": "42",
        "middleCd": "000",
        "smallCd": "000",
        "districtName": "강원"
      }
    ]
  }
}
  • 지역분류코드검색 RESPONSE ( type: xml)
<?xml version="1.0" encoding="UTF-8"?>
<areacodeinfo>
    <totalcnt>17</totalcnt>
    <listcnt>10</listcnt>
    <contflag>1</contflag>
    <poiareacodes>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>11</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[서울]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>26</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[부산]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>27</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[대구]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>28</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[인천]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>29</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[광주]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>30</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[대전]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>31</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[울산]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>36</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[세종]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>41</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[경기]]-->
            </districtname>
        </poiareacode>
        <poiareacode>
            <areadepth>L</areadepth>
            <largecd>42</largecd>
            <middlecd>000</middlecd>
            <smallcd>000</smallcd>
            <districtname>
                <!--[CDATA[강원]]-->
            </districtname>
        </poiareacode>
    </poiareacodes>
</areacodeinfo>
  • Error code index
    | 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.