OILPRICE 함수

【 함수 요약 】

OPINET에서 제공하는 API를 이용하여 지역별 유종별 평균유가를 조회합니다.

전국, 광역시도, 시군구 단위로 유종별 평균 가격을 조회합니다.

 

이 함수는 EGTools 추가기능에서 지원하는 함수입니다.

【 적용 버전 】

Windows용 : 모든버전

 

【 함수 구문 】

= OILPRICE (  [ Area ] , [ Oil ] , [ Date ]  )

 

【 함수 인수 】

인수명	옵션	기본값	설    명
Area	선택	"전국"	평균유가를 조회할 지역, 생략하면 "전국" 평균이 조회됨 지역은 광역시도 또는 광역시도와 그 직할 행정구역만 가능함 광역시도와 시군구는 반드시 공백(띄어쓰기)이 있어야 함 예) 서울시,  서울,  서울 중랑, 경기 수원
Oil	선택	0	검색할 유종, 생략하면 보통휘발유가 적용됨 0=보통휘발유, 1=고급휘발유, 2=자동차경유, 3=자동차부탄, 4=실내등유
Date	선택	없음	최근 7일을 기준으로 일주일 평균 유가를 조회함 7일이 경과한 일자는 조회 불가

 

【 함수 상세 설명 】

Area 및 Date의 지정에 따라 5가지 방식으로 조회를 함

• Area가 없고, Date지정이 없는 경우 : 지정한 유종의 전국 평균 가격
• Area가 없고, Date지정이 있는 경우 : 지정한 유종의 Date일자의 전국평균 가격
• Area가 광역시도이고 Date 지정이 없는 경우 : 지정한 유종의 광역시도 평균 가격
• Area가 시군구이고 Date 지정이 없는 경우 : 지정한 유종의 시군구 평균 가격
• Area가 광역시도 또는 시구구이고, Date 지정이 있는 경우 : 해당 지역의 지정일 기준 최근 7일간 평균 가격
          (모든 날짜는 어제를 기준으로 7일 이내만 지정이 가능)

시구구를 조회할 경우에는 광역시도를 반드시 같이 표기하되 띄어쓰기 해야 함
2단계 이상의 행정구역의 경우 무시됨,  예) "경기도 수원시 장안구" -> "경기도 수원시"로 조회함

만약 "제주시"만 입력하며 광역시도인 "제주도"로 조회를 하게 됨

최근 7일 이내의 날짜만 조회가 가능하므로 그 이전의 일자는 OPINET에서 Web 조회 필요

 

【 함수 오류 설명 】

오류가 있는 경우 "Error: 오류내용" 으로 표시함

조회한 자료가 없거나 지원하는 일자가 아닌 경우 "Error: 자료 없음" 으로 표시

 

【 함수 사용시 주의사항 】

여러 분들이 사용하게 되므로 API의 일일 한도를 넘어서게 되면 조회가 안 될 수도 있습니다.
사용후에는 시트 재계산시마다 API를 사용하게 되므로 반드시 값으로 변환하여 저장하시기 바랍니다. 

 

【 함수 사용 예제 】

【 비슷한 기능의 다른 함수 】

MyOilPrice : 지정하 주소 주변 주유소의 유가 목록을 출력