A custom component for Home Assistant that provides real-time tidal, current, and environmental data from NOAA's Center for Operational Oceanographic Products and Services (CO-OPS) API and the National Data Buoy Center (NDBC) API. This component enhances and extends the functionality of the legacy NOAA Tides core component, offering UI configurability, automatic sensor detection, and enhanced data handling.
Warning
Sensor names and attributes subject to change before v 1.0.0 release. Feedback and suggestions are greatly appreciated.
- Dual Data Sources:
- NOAA CO-OPS stations for coastal and environmental data
- NDBC buoys for offshore marine and weather observations
- Automatic Sensor Discovery: Available sensors are automatically detected based on your station/buoy selection
- Real-time Data: Regular updates from NOAA/NDBC APIs
- Configurable Units: Support for both metric and imperial measurements
- Multiple Time Zone Options: GMT, Local Standard Time, or Local Standard/Daylight Time
- Customizable Update Intervals: Adjust data refresh frequency to your needs
- Water Level
- Tide Predictions (with tide state, timing, factor, and percentage)
- Current Speed and Direction
- Current Predictions (expiremental)
- Water Temperature
- Air Temperature
- Wind Speed and Direction
- Air Pressure
- Humidity
- Conductivity
- Meteorological Data
- Wind Speed, Direction, and Gusts
- Wave Height, Period, and Direction
- Air Temperature
- Water Temperature
- Barometric Pressure
- Spectral Wave Data
- Ocean Current Data
- Download the latest release from the releases page
- Extract the
noaa_tidesfolder to your Home Assistantcustom_componentsdirectory - Restart Home Assistant
- Go to Settings > Devices & Services
- Click "Add Integration" and search for "NOAA Tides"
- Select your preferred data source:
- NOAA Station: For coastal stations with tidal data
- NDBC Buoy: For offshore marine observations
- Enter your station/buoy ID
- Configure additional options:
- Name: Custom name for the station
- Time Zone: Select preferred time zone display
- Unit System: Choose metric or imperial units
- Update Interval: Set data refresh frequency
- For NDBC buoys: Select desired data sections
- Choose available sensors from the discovered list
Visit the NOAA Tides and Currents Map to find your station. NOAA operates nearly 500 stations with real-time data in the U.S., Caribbean, and Pacific territories. Alongside these physical stations, NOAA provides thousands of virtual stations that offer localized tide and current predictions, providing comprehensive coverage of coastal areas. Different stations support various data types:
- Tide Predictions
- Current Predictions (experimental)
- Meteorological Observations
- Real Time Currents
- Conductivity
Use the NDBC Station Map and Buoy Finder to locate your buoy. The NDBC and it's partners operate nearly 1000 active buoys and coastal stations worldwide, with particularly extensive coverage in U.S. coastal waters, the Great Lakes, and Alaska.
- Tide State: Indicates if tide is rising or falling and the time
- Tide Factor: Sinusoidal representation of tide level (0-100%) that follows the natural curve of tidal change, with slower changes near high/low tides and faster changes at mid-tide levels.
- Tide Percentage: Linear representation of tide progress (0-100%) that moves at a constant rate between tides, making it perfect for tide clocks and calculating exact timing of tidal events.
- Current State: Shows ebb, flood, or slack water
- Direction: Compass bearing of water movement
- Speed: Current velocity
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.
For bugs and feature requests, please open an issue on GitHub.