API Reference

유가정보 샘플 예제

주변 명칭(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)
NameTypeMandatoryExampleDescription
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일
hhPriceStringN1632휘발유 가격 (단위: 원)
ggPriceStringN1398경유 가격 (단위 : 원)
llPriceStringN1082LPG 가격 (단위 : 원)
highHhPriceStringN1800고급휘발유 가격 (단위 :원)
secondNoStringN부번입니다.
parkFlagStringN주차 가능 유무입니다. - 0: 주차 불가능 - 1: 주차 가능 - null: 정보 없음
merchantFlagNodeNOKCB;TMEM;GIFT;SSC가맹점의 정보를 ‘;’을 구분자로 나열 합니다. - OKCB : OKCashbag 가맹점 - GIFT : 기프티콘 - TMEM : T멤버십, TMC - SSCD : 삼성카드 - OKMY : OK마이샵
highGgPriceStringN1500고급경유 가격 (단위 : 원)
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) 상세 검색

  • 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)
NameTypeMandatoryExampleDescription
poiDetailInfoNodeYPOI 상세정보입니다.
viewIdString업종 구분 코드
(3:주유소, 4:충전소, 6:EV충전소)
idStringN2034197POI ID입니다.
nameStringN건국대학병원시설물 명칭입니다.
bizCatNameStringN의료시설업종명입니다.
addressStringN서울 관악구 신림동주소입니다.
firstNoStringN142본번입니다.
secondNoStringN23부번입니다.
zipCodeNodeN123-234우편번호입니다.
telNodeN1544-3432전화번호입니다.
mlClassStringN1산/대지구분(구주소)
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제공 소분류입니다.
participantNumberN0별점 참여자 수 입니다.
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업소 소개입니다.
hhPriceStringN1632휘발유 가격 (단위: 원)
ggPriceStringN1398경유 가격 (단위 : 원)
llPriceStringN1082LPG 가격 (단위 : 원)
highHhPriceStringN1800고급휘발유 가격 (단위 :원)
highGgPriceStringN1500고급경유 가격 (단위 : 원)
  • 전기차 충전소 추가 정보
NameTypeMandatoryExampleDescription
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)
0 - 알수없음
1 - 통신이상
2 - 충전대기
3 - 충전중
4 - 운영중지
5 - 점검중
6 - 예약중
evPowerTypeStringNev충전기 충전량
Ex)급속(200kW동시),급속(50kW)
chargingDateTimeStringN마지막 충전 시각(YYYYMMDDHH24MISS)
Ex)20190919181030
updateDateTimeStringN최종 변경 시각(YYYYMMDDHH24MISS)
Ex)20190919181030
calculatedDateTimeStringN충전상태별 소요시간(초단위)
status가 3(충전중)일 경우 충전 경과 시간
나머지 경우 마지막 충전 완료 후 경과 시간