Integrate Bizkaibus Service for Enhanced Home Scheduling

S.C.O.R.E. → Convenience → DeviceControl

Overview

This capability allows homeowners to integrate the Bizkaibus public transport service into their home capability system, enabling seamless scheduling and notifications for bus arrivals and departures. By connecting to this service, residents can better plan their travel, reducing waiting times and enhancing overall convenience.

Benefits

• Real-time bus schedule updates to optimize travel plans
• Reduced waiting times through timely notifications
• Enhanced home capability by integrating public transport with daily routines

Intent

The purpose of this capability is to provide homeowners with an efficient way to access and manage local bus schedules directly from their home capability system. This results in improved travel planning and better time management for residents.

Preconditions

• Home Assistant installed and configured.
• Access to the Bizkaibus API or service documentation.
• Internet connection for real-time updates.
• Integration available and authenticated: ESPHome.
• Device installed and reachable: RainMachine Version 2 (API 4.6.1).

Actors

• Homeowner checking bus schedules
• Family members planning outings
• Guests needing transportation information

Trigger

The capability is triggered by a scheduled time or a request made by the homeowner to check upcoming bus arrivals.

Workflow Diagram

flowchart TD
    A[Scheduled Time or Request] -->|check| B{Bus Schedules Available?}
    B -->|Yes| C[Fetch Bus Timings]
    C --> D[Notify Homeowner]
    B -->|No| E[Exit]

Workflow Description

1. Initiate Request

The homeowner requests the current bus schedule via a voice command or a scheduled capability.

2. Check Availability

The system checks the availability of the Bizkaibus schedules through the API.

3. Fetch Timings

If the schedules are available, the system retrieves the latest bus timings.

4. Notify Homeowner

The homeowner receives a notification with the upcoming bus arrival times.

5. Update Schedule

The system updates the homeowner’s calendar or scheduling app with the bus times.

Postconditions

The homeowner is informed of the next bus arrival times, allowing for better travel planning and coordination with their daily schedule.

Optional Enhancements

• Integrate with Google Calendar for automatic event updates
• Add location-based notifications for bus arrivals
• Enable voice commands for checking bus schedules

Recommended Components

Source Examples

• 2026.1: Home is where the dashboard is ?? – Home Assistant (homeassistant)