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

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

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

API Console로 이동하기

지역분류코드검색

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

API Console로 이동하기