GrecHouse / oil_price

Gas station oil price sensor #HA 주유소 유가 정보 센서

⛽ 통합구성요소 버전으로 이사합니다.

이 센서는 더 이상 관리하지 않습니다. 아래 링크의 센서를 이용해주세요.

https://github.com/GrecHouse/gas_station_korea

주유소 유가 정보 센서

즐겨찾는 주유소의 유가 정보를 보여줍니다. 전국평균 유가 정보 센서도 자동으로 추가됩니다.
이 센서는 오피넷의 전국유가정보와 카카오 플레이스의 상점 정보에서 데이터를 가져옵니다.

Screenshot

Version history

Version	Date
v1.0	2020.04.14	최초 버전
v1.0.2	2022.04.04	device_state_attributes -> extra_state_attributes
v1.0.3	2022.05.09	HA 2023.5 버전 카카오 플레이스 SSL 문제 회피 처리
v1.0.3	2023.10.24	Deprecated

Installation

직접 설치

• HA 설치 경로 아래 custom_component 에 파일을 넣어줍니다.
  <config directory>/custom_components/oil_price/sensor.py
<config directory>/custom_components/oil_price/__init__.py
<config directory>/custom_components/oil_price/manifest.json
• configuration.yaml 파일에 설정을 추가합니다.
• Home Assistant 를 재시작합니다.

HACS로 설치

• HACS > Integrations 메뉴 선택
• 우측 상단 메뉴 버튼 클릭 후 Custom repositories 선택
• Add Custom Repository URL 에 https://github.com/GrecHouse/oil_price 입력,
  Category에 Integration 선택 후 ADD
• HACS > Integrations 메뉴에서 우측 하단 + 버튼 누르고 [KR] Oil Price Sensor 검색하여 설치

Usage

주유소 키 값 얻기

• 카카오맵에서 추가하려는 주유소를 찾습니다.

• 주유소 이름을 눌러 상세 정보 페이지로 이동합니다.
  
  \

• 주소창의 URL 에서 마지막에 숫자로 된 부분을 이용하면 됩니다.
  place.map.kakao.com/11111111
  
  

configuration

• 아래와 같이 HA에 설정을 추가합니다.

configuration.yaml 기본설정 :

sensor:
  - platform: oil_price

configuration.yaml 상세설정 :

sensor:
  - platform: oil_price
    type: '02'  
    station_id:
      - '11111111'
      - '22222222'

Configuration variables:

옵션	값
platform	(필수) oil_price
type	(옵션) 기름 종류. 미설정시 기본값은 '02'(휘발유)
station_id	(옵션) 주유소 키 리스트. 미설정시 전국평균가격만 센서로 추가됨

type variable:

값	종류
01	고급휘발유
02	휘발유
03	경유
04	LPG
05	등유

• 05/등유 는 카카오 플레이스 정보에서 제공되지 않습니다.

설명

• 전국평균유가 sensor.oil_price_avg 는 기본적으로 생성됩니다.
• 전국평균 속성 중 price diff 는 전일대비 가격 변동 내역입니다.
• 추가한 주유소들은 sensor.oil_price_[station_id] 로 생성됩니다.

센서 카드 샘플

mini-graph 카드 샘플

버그 또는 문의사항

네이버 카페 HomeAssistant 그렉하우스
네이버 카페 모두의스마트홈 그렉하우스