서울 버스(Seoul Bus) for Home Assistant

Home Assistant에서 공공데이터포털 API를 이용하여 서울 버스 정보를 표시하는 센서입니다.

• 서울버스 도착정보를 알려줍니다.
• 지정한 정류장에 도착예정인 버스를 확인할 수 있습니다.
• Murianwind님이 리뉴얼 해주셨습니다. 감사합니다.

API KEY 발급

공공데이터포털에서 서울특별시_정류소정보조회 서비스 오픈API를 활신청하여 인증키를 발급받습니다.

1. 공공데이터포털에 회원가입을 진행합니다.
2. 오픈API 서울특별시_정류소정보조회 서비스를 조회합니다.
3. 조회된 목록을 클릭하여, 오픈API 상세 페이지에서 활용신청을 합니다.

Version history

Version	Date	내용
v1.0.0	2020.01.15	First version
v2.0.0	2026.03.19	Renewal version. (Thx. Murianwind)

Installation

HACS

• HACS > SETTINGS 메뉴 선택
• ADD CUSTOM REPOSITORY에 'https://github.com/miumida/seoul_bus' 입력하고 Category에 'integration' 선택 후, 저장
• HACS > INTEGRATIONS 메뉴 선택 후, 검색하여 설치
  
  

Manual

• HA 설치 경로 아래 custom_components 에 파일을 넣어줍니다.
  <config directory>/custom_components/seoul_bus/전체파일
  
• Home-Assistant 를 재시작합니다
  

Usage

Custom Integration

• 구성 > 통합구성요소 > 통합구성요소 추가하기 > 서울 버스(Seoul Bus) 선택 > 설정값 입력 후, 확인.
• HA 설정에 서울 버스(Seoul Bus)를 추가합니다.
  

Configuration(yaml) : Custom Integration으로 등록해주세요!

• HA설정에 서울 버스(Seoul Bus)를 추가합니다
  
• v2.0.0 이상부터는 통합구성요소만 지원합니다.
  
  
  

기본 설정값

옵션	값
api_key	(필수) 공공데이터포털 API KEY
station_id	(필수) 정류장ID
station_name	(옵션) 정류장 이름
start_time	(옵션) 특정구간의 버스정보를 갱신하기 위한 시작시간
end_time	(옵션) 특정구간의 버스정보를 갱신하기 위한 종료시간
include_buses	(옵션) 대상 버스 목록

정류장ID(station_id) 값 확인

station_id는 정류장ID 입니다.

1. 서울 버스도착정보 - 버스노선 사이트에 접속합니다.
2. 정류장을 선택하고, 정류장 이름을 입력하여 조회합니다.
3. 원하는 정류장의 괄호안의 숫자를 확인합니다. (03198)서울역11번출구

Thx.

• Murianwind님 대대적으로 리뉴얼 해주셔서 감사합니다:D

참고사이트

[1]서울 버스도착정보 - 버스노선 사이트(http://bus.go.kr/searchResult6.jsp)
[2]서울특별시 버스노선 기본정보 항목정보(http://data.seoul.go.kr/dataList/OA-15262/F/1/datasetView.do)