주말에 마트 가도 될까요?(대형마트 휴무일) Sensor for Home Assistant
E마트/롯데마트/Homeplus/Costco/GS슈퍼마켓의 휴무일을 나타내주는 Home Assistant Sensor 입니다.
롯데마트의 경우, 지점 담당자가 휴무일을 제대로 입력하지 않거나 갱신하지 않아 제대로 조회되지 않는 경우도 있습니다.
| Version | Date | |
|---|---|---|
| v1.0.0 | 2019.11.29 | First version |
| v1.0.1 | 2019.12.03 | 롯데마트 00월 00일로 등록된 휴무일 처리추가 |
| v1.0.2 | 2019.12.09 | 코스트코 휴무일 센서 추가. 롯데마트 휴무일 센서 수정. |
| v1.0.3 | 2019.12.11 | 이마트/롯데마트/코스트코 휴무일 센서 오류 수정. |
| v1.0.4 | 2019.12.27 | 롯데마트/이마트 가까운 휴무일 체크로직 수정. |
| v1.0.5 | 2020.01.05 | 코스트코 휴무일 센서 오류 수정. |
| v1.0.6 | 2020.01.16 | 롯데마트 '00월00일' 휴무일 처리 추가. |
| v1.0.7 | 2020.03.09 | GS슈퍼마켓 휴무일 센서 추가(source by 별명짓기귀찮음[kws9271]). 롯데마트 휴무일 오류 수정. |
| v1.0.8 | 2021.03.09 | manifest.json 파일 version 속성 추가. |
| v1.0.9 | 2021.05.21 | 롯데마트 00/00 일자 처리 수정. |
| v1.1.0 | 2021.05.25 | 통합구성요소 적용. |
| v1.1.1 | 2021.08.14 | 이마트 휴무일로직 임시수정 |
| v1.1.2 | 2021.08.25 | 이마트 휴무일로직 오류 수정. |
| v1.1.3 | 2021.08.25 | 이마트 휴무일 가져오기 로직 개선(휴무일 아이콘기준으로 찾기). |
| v1.1.4 | 2021.12.15 | Fix bug |
| v1.1.5 | 2022.06.27 | Fix bug |
| v1.1.6 | 2022.07.08 | bs4 requirement version 변경 |
| v1.1.10 | 2022.07.12 | 롯데마트 홈페이지 개편에 따른 휴무일로직 변경 |
| v1.1.11 | 2022.08.26 | 코스트코 김해점 |
| v1.1.12 | 2022.12.02 | 이마트 휴일처리 수정 |
| v1.1.13 | 2022.12.29 | 코스트코 고척점 코드추가 |
| v1.1.14 | 2023.07.29 | README 수정 |
| v1.2.0 | 2023.10.26 | 수정 |
| v1.2.1 | 2024.12.27 | 수정 |
- HA 설치 경로 아래 custom_components 에 파일을 넣어줍니다.
<config directory>/custom_components/mart_holiday/__init__.py
<config directory>/custom_components/mart_holiday/manifest.json
<config directory>/custom_components/mart_holiday/sensor.py - configuration.yaml 파일에 설정을 추가합니다.
- Home-Assistant 를 재시작합니다
- HACS > SETTINGS 메뉴 선택
- ADD CUSTOM REPOSITORY에 'https://github.com/miumida/mart_holiday' 입력하고 Category에 'integration' 선택 후, 저장
- HACS > INTEGRATIONS 메뉴 선택 후, 검색하여 설치
- 구성 > 통합구성요소 > 통합구성요소 추가하기 > 대형마트휴무일 선택 > 설정값 입력 후, 확인.
- HA설정에 대형마트 휴무일 센서를 추가합니다
- v1.1.7 이상부터는 통합구성요소만 지원합니다.
| 옵션 | 값 |
|---|---|
| mart_kind | (필수) 마트 종류 |
| name | (옵션) 마트 이름(지점). 지정하지 않으면 'mart'로 저장됨 (필수) GS슈퍼마켓은 마트이름으로 검색하여 정확한 이름 입력필요 |
| mart_code | (필수) 마트 지점코드 or 마트 지점ID |
| 종류 | 설명 |
|---|---|
| e | E마트 |
| l | 롯데마트 |
| h | Homeplus |
| c | Costco |
| g | GS슈퍼마켓 |
마트에 따라 마트코드를 확인하는 방법은 아래와 같다.
- 모바일에서 점포찾기(https://eapp.emart.com/branch/main.do) 페이지에 접속 후, 원하는 지점 검색.
- 지점 상세페이지로 클릭하여 들어가서 주소창에 id={지점코드}를 코드로 입력.
- 롯데마트 지점찾기 페이지로 접속하여 원하는 롯데마트 지점을 검색한다.
지점찾기 페이지 : http://company.lottemart.com/shop/shop_search_type.asp?#schWord
- 조회된 목록에서 원하는 지점의 지점명과 동일하게 마트코드로 사용한다.
<
- 홈플러스 매장명 찾기를 통해 원하는 홈플러스 매장을 검색한다
매장명 검색 페이지 : http://corporate.homeplus.co.kr/STORE/HyperMarket.aspx
- 조회된 목록에서 하는 매장의 '입점 정보'를 클릭한다.
- 매장정보가 나타나면 주소창에 있는 sn=0017 부분에서 = 뒤에 있는
0017을 마트코드로 사용한다.
| 코드 | 마트명 | 코드 | 마트명 | 코드 | 마트명 |
|---|---|---|---|---|---|
| 01 | 대전점 | 09 | 양재점 | 17 | 김해점 |
| 02 | 대구점 | 10 | 광명점 | 18 | 고척점 |
| 03 | 세종점 | 11 | 하남점 | ||
| 04 | 대구 혁신도시점 | 12 | 송도점 | ||
| 05 | 천안점 | 13 | 양평점 | ||
| 06 | 부산점 | 14 | 상봉점 | ||
| 07 | 울산점 | 15 | 일산점 | ||
| 08 | 공세점 | 16 | 의정부점 |
- 코스트코는 매장이 현재 18개로 홈페이지에서 정보를 가져와서 휴무일을 표시하지 않는다.
- 코스트코 홈페이지에 나와있는 18개의 매장을 기준으로 2자리 숫자로 단순히 코드로 사용한다.
해당 지점에 대해서는 코드표를 확인하여, mart_code에 사용한다.
- GS슈퍼마켓 매장명 찾기를 통해 원하는 GS슈퍼마켓 매장을 검색한다
매장명 검색 페이지: http://gsthefresh.gsretail.com/thefresh/ko/market-info/find
- 조회된 목록에서 원하는 매장의 이름을 아래 주소에서 넣어 마트코드(shopCode)를 확인한다.
http://gsthefresh.gsretail.com/thefresh/ko/market-info/find-storelist?searchShopName=[마트이름]
- 별명짓기귀찮음님 GS슈퍼마켓 소스제공 감사합니다:D
- 저장장치님 이마트 휴무일 찾는 부분 아이디어 제공해주셔서 감사합니다:D