Unofficial. For warnings follow the DMC and the Met Department ยท Updatingโ€ฆ

Data Sources & Refresh Frequencies

Comprehensive overview of all data sources powering FloodWatch LK

46+
Total Data Sources
40+
API Endpoints
85-90%
Cache Hit Rate
5 min
Fastest Refresh

๐ŸŒค๏ธWeather & Climate Data

SourceCache/RefreshDescription
Backend API - All Weather30 minutesWeather data for all districts
Backend API - Forecasts30 minutes7-day forecast for all districts
OpenWeatherMap One Call API 3.030 minutesEarly warning system with hourly/daily forecasts
Frontend Refresh Intervals:
  • โ€ข Dashboard: No auto-refresh (backend cache: 60 min)
  • โ€ข Early Warning Page: 30 minutes
  • โ€ข Flood Info Page: 30 minutes
  • โ€ข Rivers Page: 5 minutes

๐ŸŒŠRiver & Flood Monitoring

SourceCache/RefreshDescription
SL Irrigation Department15 minutesRiver gauges (~40 stations, 7-day history) and river basin outlines
Rivers: HOT/OSM via HDX (ODbL)Static fileRiver network lines (Waterways of Sri Lanka, OpenStreetMap contributors)
RiverNet.lkManual linkLive river levels portal - External link
ArcGIS DashboardManual linkInteractive river monitoring dashboard - External link
Backend Irrigation API5 minutesProcessed river data with flood thresholds and alerts
Backend Flood Threat API5 minutesNational flood threat assessment and district analysis

๐Ÿ“ฐNews Sources

All news sources cached for 30 minutes with rate limiting (max 1 request per 30 min per source)

Local Sources

  • ๐Ÿ‡ฑ๐Ÿ‡ฐSL Met Department
  • ๐Ÿ‡ฑ๐Ÿ‡ฐNewsFirst.lk
  • ๐Ÿ‡ฑ๐Ÿ‡ฐNewswire.lk

International Weather

  • ๐Ÿ‡ฎ๐Ÿ‡ณIndia Meteorological Dept (IMD)
  • ๐ŸŒBBC Weather
  • ๐ŸŒGDACS (Global Disaster Alert)
  • ๐ŸŒReliefWeb

Disaster & Emergency News

  • ๐ŸฅWHO (World Health Organization)
  • ๐Ÿ‡บ๐Ÿ‡ณUN News
  • ๐ŸŒAl Jazeera
  • ๐Ÿ‡บ๐Ÿ‡ธU.S. Embassy Sri Lanka
11
Total News Sources

๐ŸŒฌ๏ธWind Data

SourceUpdate FrequencyDescription
ICON (DWD Germany)Every 6 hoursWeather model - Forecast up to 78 hours
GFS (NOAA USA)Every 6 hoursWeather model - Forecast up to 384 hours (16 days)
ERA5 (ECMWF)DailyReanalysis model - Historical data (~5 day lag)
OpenWeatherReal-timeCurrent wind conditions only

๐ŸšจIntelligence & Alerts

SourceCache DurationDescription
Emergency Facilities (OpenStreetMap)24 hoursHospitals, police, fire stations, shelters - Daily refresh โœ…
Weather Alerts (WeatherAPI.com)15 minutesOfficial weather warnings and alerts - Auto-refresh โœ…
Marine Conditions (Open-Meteo)30 minutesWave heights, sea temperatures, marine forecasts - Auto-refresh โœ…
Traffic Incidents (TomTom)5 minutesRoad closures, accidents, flooding incidents - Auto-refresh โœ…
Traffic Flow (HERE & TomTom)5 minutesReal-time traffic congestion and flow data - Auto-refresh โœ…

๐Ÿ“Emergency Services

๐Ÿฅ
1,500+
Hospitals
๐Ÿ‘ฎ
400+
Police Stations
๐Ÿš’
100+
Fire Stations
๐Ÿ 
200+
Shelters
Source: OpenStreetMap โ€ข Cache: 24 hours

โšกData Refresh Frequencies Summary

โšก 5 minutes
  • โ€ข River levels
  • โ€ข Traffic incidents
  • โ€ข Irrigation data
๐Ÿ”„ 15 minutes
  • โ€ข Weather alerts
โฑ๏ธ 30 minutes
  • โ€ข Weather data
  • โ€ข News feeds
  • โ€ข Marine conditions
  • โ€ข Early warnings
๐Ÿ• 6 hours
  • โ€ข ICON wind model
  • โ€ข GFS wind model
๐Ÿ“… 24 hours
  • โ€ข Emergency facilities
  • โ€ข Intel page (static snapshot, not refreshed)
๐Ÿ—“๏ธ Daily/Weekly
  • โ€ข ERA5 wind data
  • โ€ข Environmental data

๐Ÿ”‘API Keys Required

โœ… OpenWeatherMap One Call API 3.0
โœ… WeatherAPI.com
โœ… TomTom Traffic API
โœ… HERE Traffic API
โœ… ECMWF ERA5 (CDS_API_KEY)
โœ… Open-Meteo (no key required)