유가정보 샘플 예제

주변 명칭(POI) 상세 검색

  • REQUSET (CURL / GET)

curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/oilinfo/aroundOil?page=1&count=20&radius=0&reqCoordType=WGS84GEO&resCoordType=WGS84GEO&multiPoint=N' \
     --header 'Accept: application/json'
  • RESPONSE (200 | application/javascript)

function (
{
"searchPoiInfo":{
    "totalCount": 5,
    "count": 2,
    "page": 1,
    "pois":{
        "poi":[{
            "id": "466860",
            "name": "SK 서광셀프주유소",
            "telNo": "025624855",
            "frontLat": "37.49443581",
            "frontLon": "127.03501791",
            "noorLat": "37.49435248",
            "noorLon": "127.03504569",
            "upperAddrName": "서울",
            "middleAddrName": "강남구",
            "lowerAddrName": "역삼동",
            "detailAddrName": "",
            "mlClass": "1",
            "firstNo": "834",
            "secondNo": "47",
            "roadName": "역삼로",
            "buildingNo1": "142",
            "buildingNo2": "",
            "rpFlag": "8",
            "parkFlag": "Y",
            "merchantFlag": "",
            "radius": "0.76",
            "dataKind": "3",
            "stId": "SK",
            "highHhSale": "1",
            "minOilYn": "N",
            "oilBaseSdt": "20181130",
            "hhPrice": "1555",
            "ggPrice": "1415",
            "llPrice": "0",
            "highHhPrice": "1715",
            "highGgPrice": "0",
            "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": "383023",
            "name": "GS 삼방주유소",
            "telNo": "0234821094",
            "frontLat": "37.50393449",
            "frontLon": "127.02296319",
            "noorLat": "37.50376784",
            "noorLon": "127.02321317",
            "upperAddrName": "서울",
            "middleAddrName": "서초구",
            "lowerAddrName": "서초동",
            "detailAddrName": "",
            "mlClass": "1",
            "firstNo": "1303",
            "secondNo": "",
            "roadName": "사평대로",
            "buildingNo1": "364",
            "buildingNo2": "",
            "rpFlag": "16",
            "parkFlag": "0",
            "merchantFlag": "",
            "radius": "0.79",
            "dataKind": "3",
            "stId": "GS",
            "highHhSale": "1",
            "minOilYn": "N",
            "oilBaseSdt": "20181130",
            "hhPrice": "1547",
            "ggPrice": "1437",
            "llPrice": "0",
            "highHhPrice": "1757",
            "highGgPrice": "0",
            "pkey": "788491401",
            "evChargers":{
              "evCharger":[
                {
                  "operatorId": "EV",
                  "stationId": "EV003458",
                  "chargerId": "01",
                  "status": "2",
                  "type": "02",
                  "powerType": "",
                  "operatorName": "",
                  "chargingDateTime": "20210910003307",
                  "updateDateTime": "20210910003646",
                  "isFast": "N",
                  "isAvailable": "Y"
                }
              ]
            }
          }]
        }
    }
}
)
  • RESPONSE (200 | application/json)

{
"searchPoiInfo":{
    "totalCount": 5,
    "count": 2,
    "page": 1,
    "pois":{
        "poi":[{
            "id": "466860",
            "name": "SK 서광셀프주유소",
            "telNo": "025624855",
            "frontLat": "37.49443581",
            "frontLon": "127.03501791",
            "noorLat": "37.49435248",
            "noorLon": "127.03504569",
            "upperAddrName": "서울",
            "middleAddrName": "강남구",
            "lowerAddrName": "역삼동",
            "detailAddrName": "",
            "mlClass": "1",
            "firstNo": "834",
            "secondNo": "47",
            "roadName": "역삼로",
            "buildingNo1": "142",
            "buildingNo2": "",
            "rpFlag": "8",
            "parkFlag": "Y",
            "merchantFlag": "",
            "radius": "0.76",
            "dataKind": "3",
            "stId": "SK",
            "highHhSale": "1",
            "minOilYn": "N",
            "oilBaseSdt": "20181130",
            "hhPrice": "1555",
            "ggPrice": "1415",
            "llPrice": "0",
            "highHhPrice": "1715",
            "highGgPrice": "0",
            "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": "383023",
            "name": "GS 삼방주유소",
            "telNo": "0234821094",
            "frontLat": "37.50393449",
            "frontLon": "127.02296319",
            "noorLat": "37.50376784",
            "noorLon": "127.02321317",
            "upperAddrName": "서울",
            "middleAddrName": "서초구",
            "lowerAddrName": "서초동",
            "detailAddrName": "",
            "mlClass": "1",
            "firstNo": "1303",
            "secondNo": "",
            "roadName": "사평대로",
            "buildingNo1": "364",
            "buildingNo2": "",
            "rpFlag": "16",
            "parkFlag": "0",
            "merchantFlag": "",
            "radius": "0.79",
            "dataKind": "3",
            "stId": "GS",
            "highHhSale": "1",
            "minOilYn": "N",
            "oilBaseSdt": "20181130",
            "hhPrice": "1547",
            "ggPrice": "1437",
            "llPrice": "0",
            "highHhPrice": "1757",
            "highGgPrice": "0",
            "pkey": "788491401",
            "evChargers":{
              "evCharger":[
                {
                  "operatorId": "EV",
                  "stationId": "EV003458",
                  "chargerId": "01",
                  "status": "2",
                  "type": "02",
                  "powerType": "",
                  "operatorName": "",
                  "chargingDateTime": "20210910003307",
                  "updateDateTime": "20210910003646",
                  "isFast": "N",
                  "isAvailable": "Y"
                }
              ]
            }
        }]
      }
    }
}
  • RESPONSE (200 | application/xml)

<!--?xml version="1.0" encoding="UTF-8" ?-->
<searchpoiinfo>
    <totalcount>5</totalcount>
    <count>2</count>
    <page>1</page>
    <pois>
    <poi>
    <id>466860</id>
    <name>
        <!--[CDATA[SK 서광셀프주유소]]-->
    </name>
    <telno>025624855</telno>
    <frontlat>37.49443581</frontlat>
    <frontlon>127.03501791</frontlon>
    <noorlat>37.49435248</noorlat>
    <noorlon>127.03504569</noorlon>
    <upperaddrname>
        <!--[CDATA[서울]]-->
    </upperaddrname>
    <middleaddrname>
        <!--[CDATA[강남구]]-->
    </middleaddrname>
    <loweraddrname>
        <!--[CDATA[역삼동]]-->
    </loweraddrname>
    <detailaddrname></detailaddrname>
    <mlclass>1</mlclass>
    <firstno>834</firstno>
    <secondno>47</secondno>
    <roadname>
        <!--[CDATA[역삼로]]-->
    </roadname>
    <buildingno1>142</buildingno1>
    <buildingno2></buildingno2>
    <rpflag>8</rpflag>
    <parkflag>Y</parkflag>
    <merchantflag></merchantflag>
    <radius>0.76</radius>
    <datakind>3</datakind>
    <stid>SK</stid>
    <highhhsale>1</highhhsale>
    <minoilyn>N</minoilyn>
    <oilbasesdt>20181130</oilbasesdt>
    <hhprice>1555</hhprice>
    <ggprice>1415</ggprice>
    <llprice>0</llprice>
    <highhhprice>1715</highhhprice>
    <highggprice>0</highggprice>
    <pkey>788491401</pkey>
    <evchargers>
    <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>
    </evchargers>
    </poi>
    <poi>
    <id>383023</id>
    <name>
        <!--[CDATA[GS 삼방주유소]]-->
    </name>
    <telno>0234821094</telno>
    <frontlat>37.50393449</frontlat>
    <frontlon>127.02296319</frontlon>
    <noorlat>37.50376784</noorlat>
    <noorlon>127.02321317</noorlon>
    <upperaddrname>
        <!--[CDATA[서울]]-->
    </upperaddrname>
    <middleaddrname>
        <!--[CDATA[서초구]]-->
    </middleaddrname>
    <loweraddrname>
        <!--[CDATA[서초동]]-->
    </loweraddrname>
    <detailaddrname></detailaddrname>
    <mlclass>1</mlclass>
    <firstno>1303</firstno>
    <secondno></secondno>
    <roadname>
        <!--[CDATA[사평대로]]-->
    </roadname>
    <buildingno1>364</buildingno1>
    <buildingno2></buildingno2>
    <rpflag>16</rpflag>
    <parkflag>0</parkflag>
    <merchantflag></merchantflag>
    <radius>0.79</radius>
    <datakind>3</datakind>
    <stid>GS</stid>
    <highhhsale>1</highhhsale>
    <minoilyn>N</minoilyn>
    <oilbasesdt>20181130</oilbasesdt>
    <hhprice>1547</hhprice>
    <ggprice>1437</ggprice>
    <llprice>0</llprice>
    <highhhprice>1757</highhhprice>
    <highggprice>0</highggprice>
    <pkey>788491401</pkey>
    <evchargers>
    <evcharger>
    <operatorid>KP</operatorid>
    <stationid>KP000207</stationid>
    <chargerid>01</chargerid>
    <status>2</status>
    <type>06</type>
    <powertype></powertype>
    <operatorname>한국전력</operatorname>
    <chargingdatetime>20210910115303</chargingdatetime>
    <updatedatetime>20210910115634</updatedatetime>
    <isfast>Y</isfast>
    <isavailable>Y</isavailable>
    </evcharger>
    </evchargers>
    </poi>
    </pois>
</searchpoiinfo>
  • RESPONSE (PARAMETERS)

Name

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일

hhPrice

String

N

1632

휘발유 가격 (단위: 원)

ggPrice

String

N

1398

경유 가격 (단위 : 원)

llPrice

String

N

1082

LPG 가격 (단위 : 원)

highHhPrice

String

N

1800

고급휘발유 가격 (단위 :원)

secondNo

String

N

부번입니다.

parkFlag

String

N

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

merchantFlag

Node

N

OKCB;TMEM;GIFT;SSC

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

highGgPrice

String

N

1500

고급경유 가격 (단위 : 원)

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) 상세 검색

  • REQUSET (CURL / GET)

curl --request GET \
     --url 'https://apis.openapi.sk.com/tmap/oilinfo/poiDetailOil?resCoordType=WGS84GEO' \
     --header 'Accept: application/json'
  • RESPONSE (200 | application/javascript)

function(
    {"poiDetailInfo":{
        "id": "2034197",
        "viewId": "업종 구분 코드",
        "name": "BAR",
        "bizCatName": "",
        "address": "서울 관악구 신림동",
        "firstNo": "131",
        "secondNo": "21",
        "zipCode": "",
        "tel": "",
        "mlClass": "1",
        "lat": "37.47093682",
        "lon": "126.93936062",
        "menu1": "",
        "menu2": "",
        "menu3": "",
        "menu4": "",
        "menu5": "",
        "parkFlag": "",
        "twFlag": "",
        "yaFlag": "",
        "homepageURL": "",
        "routeInfo": "",
        "facility": "",
        "upperLegalCode": "11",
        "middleLegalCode": "620",
        "lowerLegalCode": "102",
        "detailLegalCode": "00",
        "upperAdminCode": "11",
        "middleAdminCode": "620",
        "lowerAdminCode": "665",
        "upperCode": "",
        "middleCode": "",
        "lowerCode": "",
        "participant": "",
        "point": "",
        "merchantFlag": "",
        "merchantDispType": "",
        "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": ""
          }
        ],
        "hhPrice": "0",
        "ggPrice": "0",
        "llPrice": "0",
        "highHhPrice": "0",
        "highGgPrice": "0"
    }}
  • RESPONSE (200 | application/json)

{"poiDetailInfo":{
    "id": "2034197",
    "viewId": "업종 구분 코드",
    "name": "BAR",
    "bizCatName": "",
    "address": "서울 관악구 신림동",
    "firstNo": "131",
    "secondNo": "21",
    "zipCode": "",
    "tel": "",
    "mlClass": "1",
    "lat": "37.47093682",
    "lon": "126.93936062",
    "menu1": "",
    "menu2": "",
    "menu3": "",
    "menu4": "",
    "menu5": "",
    "parkFlag": "",
    "twFlag": "",
    "yaFlag": "",
    "homepageURL": "",
    "routeInfo": "",
    "facility": "",
    "upperLegalCode": "11",
    "middleLegalCode": "620",
    "lowerLegalCode": "102",
    "detailLegalCode": "00",
    "upperAdminCode": "11",
    "middleAdminCode": "620",
    "lowerAdminCode": "665",
    "upperCode": "",
    "middleCode": "",
    "lowerCode": "",
    "participant": "",
    "point": "",
    "merchantFlag": "",
    "merchantDispType": "",
    "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": ""
      }
    ],
    "hhPrice": "0",
    "ggPrice": "0",
    "llPrice": "0",
    "highHhPrice": "0",
    "highGgPrice": "0"
}}
  • RESPONSE (200 | application/json)

<?xml version="1.0" encoding="UTF-8"?>
<poidetailinfo>
    <id>2034197</id>
    <viewid>업종 구분 코드</viewid>
    <name>
        <!--[CDATA[BAR]]-->
    </name>
    <bizcatname></bizcatname>
    <address>
        <!--[CDATA[서울 관악구 신림동]]-->
    </address>
    <firstno>131</firstno>
    <secondno>21</secondno>
    <zipcode></zipcode>
    <tel></tel>
    <mlclass>1</mlclass>
    <lat>37.47093682</lat>
    <lon>126.93936062</lon>
    <menu1></menu1>
    <menu2></menu2>
    <menu3></menu3>
    <menu4></menu4>
    <menu5></menu5>
    <parkflag></parkflag>
    <twflag></twflag>
    <yaflag></yaflag>
    <homepageurl></homepageurl>
    <routeinfo></routeinfo>
    <facility></facility>
    <upperlegalcode>11</upperlegalcode>
    <middlelegalcode>620</middlelegalcode>
    <lowerlegalcode>102</lowerlegalcode>
    <detaillegalcode>00</detaillegalcode>
    <upperadmincode>11</upperadmincode>
    <middleadmincode>620</middleadmincode>
    <loweradmincode>665</loweradmincode>
    <uppercode></uppercode>
    <middlecode></middlecode>
    <lowercode></lowercode>
    <participant></participant>
    <point></point>
    <merchantflag></merchantflag>
    <merchantdisptype></merchantdisptype>
    <additionalinfo></additionalinfo>
    <desc></desc>
    <mngname>운영기관</mngname>
    <mngid>기관 관리ID</mngid>
    <freeyn>주차비무료여부</freeyn>
    <reservyn>예약가능여부</reservyn>
    <usetime>이용가능시간</usetime>
    <payyn>유료여부</payyn>
    <fee>단가</fee>
    <updatedt>충전상태수집일시</updatedt>
    <totalcnt>충전기 갯수</totalcnt>
    <evchargers>
        <bid>기관코드</bid>
        <sid>충전소ID</sid>
        <cid>충전기ID</cid>
        <type>충전기타입</type>
        <status>상태정보</status>
        <evpowertype></evpowertype>
        <chargingdatetime></chargingdatetime>
        <updatedatetime>20210802114617</updatedatetime>
        <calculateddatetime></calculateddatetime>
    </evchargers>
    <hhprice>0</hhprice>
    <ggprice>0</ggprice>
    <llprice>0</llprice>
    <highhhprice>0</highhhprice>
    <highggprice>0</highggprice>
</poidetailinfo>
  • RESPONSE (PARAMETERS)

Name

Type

Mandatory

Example

Description

poiDetailInfo

Node

Y

POI 상세정보입니다.

viewId

String

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

id

String

N

2034197

POI ID입니다.

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

산/대지구분(구주소)

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

제공 소분류입니다.

participant

Number

N

0

별점 참여자 수 입니다.

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

업소 소개입니다.

hhPrice

String

N

1632

휘발유 가격 (단위: 원)

ggPrice

String

N

1398

경유 가격 (단위 : 원)

llPrice

String

N

1082

LPG 가격 (단위 : 원)

highHhPrice

String

N

1800

고급휘발유 가격 (단위 :원)

highGgPrice

String

N

1500

고급경유 가격 (단위 : 원)

  • 전기차 충전소 추가 정보

Name

Type

Mandatory

Example

Description

mngName

String

N

운영기관

mngId

String

N

기관 관리ID

freeYn

String

N

주차비무료여부

reservYn

String

N

예약가능여부

useTime

String

N

이용가능시간

payYn

String

N

유료여부

fee

String

N

단가

updateDt

String

N

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

totalCnt

int

N

충전기 갯수

evChargers

node

N

충전기 리스트

bid

String

Y

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

sid

String

Y

충전소ID

cid

String

Y

충전기ID

type

String

Y

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

status

String

Y

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

evPowerType

String

N

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

chargingDateTime

String

N

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

updateDateTime

String

N

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

calculatedDateTime

String

N

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