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) 통합 검색)
NameDate TypeMandatoryExampleDescription
searchPoiInfoNodeY조회 결과입니다.
totalCountNumberY200조회 결과의 총 개수입니다.
countNumberY20페이지당 출력되는 개수입니다.
pageNumberY1조회한 페이지 번호입니다.
poisNodeYPOI 목록입니다.
poiNodeNPOI 정보입니다.
idStringN374469POI ID입니다.
pkeyStringN37446900POI 식별자 입니다.
navSeqStringN0입구점 일련번호 입니다.
collectionTypeStringNpoi문서의 컬렉션 출처입니다.
- address
- poi
nameStringN가톨릭대학교부천성모병원 정문(THECATHOLICUNIVERSITYOFKOREA)시설물 명칭입니다.
telNoStringN1577-0675전화번호입니다.
frontLatNumberN37.486138853308304시설물 입구 위도 좌표입니다.
frontLonNumberN126.79180642554107시설물 입구 경도 좌표입니다.
noorLatNumberN37.4870276429392중심점 위도 좌표입니다.
noorLonNumberN126.79238969773668중심점 경도 좌표입니다.
upperAddrNameStringN경기표출 주소 대분류명입니다.
middleAddrNameStringN부천시 원미구표출 주소 중분류명입니다.
lowerAddrNameStringN소사동표출 주소 소분류명입니다.
detailAddrNameStringN미주아파트 111동 22호표출 주소 세분류명입니다.
mlClassStringN1산/대지구분(구주소)
firstNoStringN141본번입니다.
secondNoStringN23부번입니다.
roadNameStringN도로명에 해당하는 명칭입니다.
firstBuildNoStringN건물번호1(새주소)
secondBuildNoStringN건물번호2(새주소)
radiusStringN거리 (요청 좌표에서 떨어진 거리) 단위 : km
bizNameStringN의료편의대표 업종명입니다.
upperBizNameStringN의료편의업종 대분류명입니다.
middleBizNameStringN의료시설업종 중분류명입니다.
lowerBizNameStringN종합병원업종 소분류명입니다.
detailBizNameStringN기타업종 상세분류명입니다.
rpFlagStringNGRP_FLAG는 길안내 요청에 필요한 값입니다. - 길안내 목적지 설정 시, 여기서 받은 rpFlag 값을 설정해야 합니다.
parkFlagNumberN0주차 가능유무입니다. - 0: 주차 불가능 - 1: 주차 가능 - null: 정보없음
detailInfoFlagNumberN0POI 상세정보 유무입니다. 해당 필드가 1로 설정되어 있으면, POI 상세정보 API를 이용하여 상세 정보를 조회할 수 있습니다. - 0: 없음 - 1: 있음 - null: 정보없음
descStringN소개정보입니다.
dataKindStringN데이터구분자 ("3": 주유소, "4": 충전소, "5": 맞춤형 목적지, "6":EV충전소)
zipCodeStringN우편번호
evChargersNodeN충전기 리스트
evChargerNodeN충전기 정보
operatorIdStringNev충전소 제공 업체
stationIdStringN충전소 id
chargerIdStringN충전기 id
statusStringN상태정보 (0,1,2,3,4,5,6,9)
0 - 알수없음
1 - 통신이상
2 - 충전대기
3 - 충전중
4 - 운영중지
5 - 점검중
6 - 예약중
9 - 상태 미확인
typeStringN충전기타입 (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상
powerTypeStringNev충전기 충전량
Ex)급속(200kW동시),급속(50kW)
operatorNameStringN제공 업체명
chargingDateTimeStringN마지막 충전 시각(YYYYMMDDHH24MISS)
Ex)20190919181030
updateDateTimeStringN최종 변경 시각(YYYYMMDDHH24MISS)
Ex)20190919181030
isFastStringN급속 충전 여부
isAvailableStringN사용 가능 여부
newAddressListNodeY새주소 목록입니다.
newAddressNodeY새주소 정보입니다.
centerLatNumberN37.486138853308304중심점 위도 좌표입니다.
centerLonNumberN126.79180642554107중심점 경도 좌표입니다.
frontLatNumberN37.4870276429392시설물 입구 위도 좌표입니다.
frontLonNumberN126.79238969773668시설물 입구 경도 좌표입니다.
roadNameStringN을지로도로명에 해당하는 명칭입니다.
bldNo1StringN건물번호1(새주소)
bldNo2StringN건물번호2(새주소)
roadIdStringN00255도로명 코드(새주소)
fullAddressRoadStringN서울 중구 을지로 65전체 도로명 주소 입니다.
groupSubListsNodeN그룹 하부 목록입니다.
groupSubNodeN그룹 하부 정보입니다.
subPkeyStringN37446901하부-POI 식별자 (POI와 입구점을 포함한 식별자) 입니다.
subSeqStringN1하부-순번 (그룹인 경우 1 이상의 값이 존재) 입니다.
subNameStringN정문하부-명칭 입니다.
subCenterYNumberN37.48618242하부-시설물중심Y좌표 입니다.
subCenterXNumberN126.79198473하부-시설물중심X좌표 입니다
subNavYNumberN37.48618242하부-시설물입구Y좌표 입니다.
subNavXNumberN126.79198473하부-시설물입구X좌표 입니다.
subRpFlagStringN16하부-RP FLAG 입니다.
subPoiIdStringN374469하부-POI ID 입니다.
subNavSeqStringN1하부-입구점번호 입니다.
subParkYnStringN0하부-주차여부 입니다.
주차가능일 경우 1, 아닐경우 0
subClassCdStringN04010199하부-업종코드.
subClassNmAStringN의료편의하부-업종 대분류명 입니다.
subClassNmBStringN의료시설하부-업종 중분류명 입니다.
subClassNmCStringN종합병원하부-업종 소분류명 입니다.
subClassNmDStringN기타하부-업종 세분류명 입니다.
  • 명칭(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) 상세 검색 )
NameDate TypeMandatoryExampleDescription
poiDetailInfoNodeYPOI 상세정보입니다.
viewIdString업종 구분 코드
(3:주유소, 4:충전소, 6:EV충전소)
idStringN2034197POI ID입니다.
dbKindStringN시설물DB 입니다.
"S" : POI, "J" : 지번주소, "R" : 도로주소
pkeyStringNPOI 식별자 (POI와 입구점을 포함한 식별자) 입니다.
navSeqStringN입구점 일련번호입니다.
nameStringN건국대학병원시설물 명칭입니다.
bizCatNameStringN의료시설업종명입니다.
addressStringN서울 관악구 신림동주소입니다.
firstNoStringN142본번입니다.
secondNoStringN23부번입니다
zipCodeNodeN123-234우편번호입니다. (미제공 중)
telNodeN1544-3432전화번호입니다.
mlClassStringN1산/대지구분(구주소)
lcdNameStringN서울표출 주소 대분류명입니다.
mcdNameStringN관악구표출 주소 중분류명입니다.
scdNameStringN신림동표출 주소 소분류명입니다.
dcdNameStringN표출 주소 상세분류명입니다.
bldAddrStringN서울 관악구 신림로새주소입니다.
roadScdNameStringN도로명 소분류명입니다.
roadNameStringN신림로도로명입니다.
bldNo1StringN90건물번호1(새주소)입니다.
bldNo2StringN0건물번호2(새주소)입니다.
frontlatNumberN37.470947057194365시설물 입구 위도 좌표입니다.
frontlonNumberN126.939376564495시설물 입구 경도 좌표입니다.
latNumberN37.470947057194365중심점 위도 좌표입니다.
lonNumberN126.939376564495중심점 경도 좌표입니다.
menu1StringN메뉴 1입니다.
menu2StringN메뉴 2입니다.
menu3StringN메뉴 3입니다.
menu4StringN메뉴 4입니다.
menu5StringN메뉴 5입니다.
parkFlagNumberN0주차 가능 여부입니다. - 0: 주차 불가능 - 1: 주차 가능 - null: 정보 없음
twFlagNumberN0평일 24시간 영업 여부입니다. - 0: 24시간 영업 안함 - 1: 24시간 영업
yaFlagNumberN0연중 무휴 여부입니다. - 0: 휴무 있음 - 1: 연중 무휴
homepageURLStringN홈페이지입니다.
routeInfoStringN찾아가는 길입니다.
facilityStringN부대시설 정보입니다. - 부대 시설명입니다. 10개 정도(구분자: 콤마(,))를 입력할 수 있습니다.
upperLegalCodeStringN11법정 대분류입니다.
middleLegalCodeStringN620법정 중분류입니다.
lowerLegalCodeStringN102법정 소분류입니다.
detailLegalCodeStringN00법정 세분류입니다.
upperAdminCodeStringN00행정 대분류입니다.
middleAdminCodeStringN11행정 중분류입니다.
lowerAdminCodeStringN659행정 소분류입니다.
upperCodeStringN11제공 대분류입니다.
middleCodeStringN620제공 중분류입니다.
lowerCodeStringN102제공 소분류입니다.
pointNumberN1별점 평가 점수입니다. - 유효값: 1 ~ 5
merchantFlagStringNOKCB;(OKCashbag 가맹점),OKCB;GIFT;(OKCashbag/기프티콘 가맹점),OKCB;TMEM;GIFT;SSCD;(OKCashbag/T 멤버십/기프티콘/삼성카드 가맹점)가맹점 여부 정보입니다. - 세미콜론(;)으로 구분합니다.
merchantDispTypeStringN가맹점 화면 타입입니다. - 세미콜론(;)으로 구분합니다. - 현재 OK 캐시백, T 멤버쉽, 기타 세 가지로 간주하고 작성합니다. 가맹점의 View Type이 없으면, X Type으로 간주합니다. - 가맹점 여부 정보가 OKCB;GIFT; 이면 ATYP;XTYP;로 표시 - OKCB;TMEM;GIFT;SSCD; 이면 ATYP;BTYP;XTYP;CTYP;로 표시
additionalInfoStringN[대표메뉴]스파게티,피자;[주차여부]주차가능부가 정보입니다.(구분자: 세미콜론(;))
descStringN업소 소개입니다.
  • 명칭(POI) 상세 검색 RESPONSE ( 전기차 충전소 추가 정보 )
NameDate TypeMandatoryExampleDescription
mngNameStringN운영기관
mngIdStringN기관 관리ID
freeYnStringN주차비무료여부
reservYnStringN예약가능여부
useTimeStringN이용가능시간
payYnStringN유료여부
feeStringN단가
updateDtStringN충전상태수집일시 (YYYYMMDD HH24:MI:SS)
(예 :20180416 17:24:46)
totalCntintN충전기 갯수
evChargersnodeN충전기 리스트
bidStringY기관코드
BG – 비긴스
JE – 제주전기자동차서비스
KP – 한국전력
HE – 한국전기차충전서비스
PI – 포스코ICT
SE – 서울시
PW – 파웤큐브
CT – 씨티카
ME – 환경부
JD – 제주특별자치도청
TM – 티맵
HM – 현대자동차네비게이션
sidStringY충전소ID
cidStringY충전기ID
typeStringY충전기타입 (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상
statusStringY상태정보 (0,1,2,3,4,5,6,9)
0 - 알수없음
1 - 통신이상
2 - 충전대기
3 - 충전중
4 - 운영중지
5 - 점검중
6 - 예약중
9 - 상태 미확인
evPowerTypeStringNev충전기 충전량
Ex)급속(200kW동시),급속(50kW)
chargingDateTimeStringN마지막 충전 시각(YYYYMMDDHH24MISS)
Ex)20190919181030
updateDateTimeStringN최종 변경 시각(YYYYMMDDHH24MISS)
Ex)20190919181030
calculatedDateTimeStringN충전상태별 소요시간(초단위)
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 카테고리 검색 )
NameDate TypeMandatoryExampleDescription
searchPoiInfoNodeYPOI 조회 정보입니다.
totalCountNumberY86조회 결과의 총 개수입니다. - 조회 결과가 없을 경우 0
countNumberY20페이지당 출력되는 개수입니다.
pageNumberY1조회한 페이지 번호입니다.
poisNodeNPOI 목록입니다.
poiNodeNPOI 정보입니다.
idStringNPOI ID입니다.
nameStringN시설물 명칭입니다.
telNoStringN전화번호입니다.
frontLatNumberN시설물 입구 위도 좌표입니다.
frontLonNumberN시설물 입구 경도 좌표입니다.
noorLatNumberN중심점 위도 좌표입니다.
noorLonNumberN중심점 경도 좌표입니다.
upperAddrNameStringN표출 주소 대분류명입니다.
middleAddrNameStringN표출 주소 중분류명입니다.
lowerAddrNameStringN표출 주소 소분류명입니다.
detailAddrNameStringN표출 주소 세분류명입니다.
mlClassStringN1산/대지구분(구주소)
firstNoStringN본번입니다.
roadNameStringN도로명입니다.
buildingNo1StringN건물번호 1입니다.
buildingNo2StringN건물번호 2입니다.
rpFlagStringN길 안내 요청에 필요한 값으로 길 안내 목적지 설정 시, 여기서 받은 rpFlag 값을 설정해야 합니다.
radiusStringN0.66거리 (km)
dataKindStringN3주유소 구분 - 3 : 주유소 - 4 : 충전소 - 6 : EV충전소
stIdStringNSK주유소브랜드 정보
highHhSaleNumberN1고급휘발유 판매여부 - 1 : 판매 - 2 : 판매안함 (확인 불가시 null)
minOilYnStringNY고급휘발유 판매점 여부 - Y : 최저가 점포 - N : 최저가 점포 아님 (확인 불가시 null)
oilBaseSdtStringN20240220기준일(YYYYMMDD) Ex) “20240220”일 경우 2024년2월 20일
secondNoStringN부번입니다.
parkFlagStringN주차 가능 유무입니다. - 0: 주차 불가능 - 1: 주차 가능 - null: 정보 없음
merchantFlagNodeNOKCB;TMEM;GIFT;SSCD가맹점의 정보를 ‘;’을 구분자로 나열 합니다. - OKCB : OKCashbag 가맹점 - GIFT : 기프티콘 - TMEM : T멤버십, TMC - SSCD : 삼성카드 - OKMY : OK마이샵
pkeyStringN37446900POI 식별자 입니다.
evChargersNodeN충전기 리스트
evChargerNodeN충전기 정보
operatorIdStringNev충전소 제공 업체
stationIdStringN충전소 id
chargerIdStringN충전기 id
statusStringN상태정보 (0,1,2,3,4,5,6,9)
0 - 알수없음
1 - 통신이상
2 - 충전대기
3 - 충전중
4 - 운영중지
5 - 점검중
6 - 예약중
9 - 상태 미확인
typeStringN충전기타입 (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상
powerTypeStringNev충전기 충전량
Ex)급속(200kW동시),급속(50kW)
operatorNameStringN제공 업체명
chargingDateTimeStringN마지막 충전 시각(YYYYMMDDHH24MISS)
Ex)20190919181030
updateDateTimeStringN최종 변경 시각(YYYYMMDDHH24MISS)
Ex)20190919181030
isFastStringN급속 충전 여부
isAvailableStringN사용 가능 여부
  • 주변 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 ( 읍면동/도로명 조회 )
NameDate TypeMandatoryExampleDescription
findPoiAreaDataByNameInfoNodeN
totalCntNumberN총 개수입니다.
listCntNumberN목록 개수입니다.
contFlagStringN계속 구분 여부 입니다.
- 1 : 다음페이지 존재
- 0 : 다음 페이지 없음
dongInfoNodeN주소 리스트 입니다.
addressStringN주소입니다.
resLonStringN경도 좌표 (X좌표)입니다.
resLatStringN위도 좌표 (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 )
NameDate TypeMandatoryExampleDescription
areaCodeInfoNodeN지역코드 정보
totalCntStringN17총 개수
listCntStringN10조회된 목록개수
contFlagStringN1계속 구분 - 0 : 다음페이지 없음 - 1 : 다음페이지 존재
poiAreaCodesNodeN지역코드 리스트
areaDepthStringNL지역 레벨 - L : 대분류 - M : 중분류 - S : 소분류
largeCdStringN11지역 대분류 코드
middleCdStringN000지역 중분류 코드
smallCdStringN000지역 소분류 코드
districtNameStringN서울지역명칭 (areaDepth가 L 이면 대분류명, M 이면 중분류명, S이면 소분류명)
  • RESPONSE ( 지역분류코드검색 type: json )
NameDate TypeMandatoryExampleDescription
areaCodeInfoNodeN지역코드 정보
totalCntStringN17총 개수
listCntStringN10조회된 목록개수
contFlagStringN1계속 구분 - 0 : 다음페이지 없음 - 1 : 다음페이지 존재
poiAreaCodesNodeN지역코드 리스트
poiAreaCodeNodeN지역코드
areaDepthStringNL지역 레벨 - L : 대분류 - M : 중분류 - S : 소분류
largeCdStringN11지역 대분류 코드
middleCdStringN000지역 중분류 코드
smallCdStringN000지역 소분류 코드
districtNameNodeN서울지역명칭 (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에서 확인 할 수 있습니다.