BiblioStatus

Real-time opening status of Finnish public libraries on an interactive map.

BiblioStatus app screenshot showing Finnish libraries on a map

Features

πŸ—ΊοΈ

Interactive Map

With color-coded markers showing library status at a glance.

πŸ“±

Mobile Optimized

Responsive design that works great on phones, tablets, and desktop.

πŸ“

Find Nearest Library

Uses GPS to locate 3-5 closest open libraries with distances in kilometers.

πŸ—ΊοΈ

Get Directions

One-click Google Maps navigation to any library with turn-by-turn directions.

πŸ“ž

Contact Information

Phone and email links for each library - click to call or email directly.

πŸ“…

Complete Daily Schedule

View all opening periods for the day with different statuses highlighted.

πŸ”

City Filter

Filter libraries by city or municipality to find what you need quickly.

ℹ️

Rich Popups

Click markers to see library details, hours, and direct links.

πŸ”„

Daily Updates

Data refreshed nightly via GitHub Actions for accurate status info.

Built With

R
Language
Shiny
Framework
Leaflet
Maps
Turso
Cloud Database
SQLite
Fallback DB
Docker
Container
Cloud Run
Deployment
GitHub Actions
Automation

How It Works

1

Fetch

GitHub Actions runs daily (schedules) and weekly (library metadata) to fetch fresh data from the Kirkanta API.

2

Store

Data is written to Turso (cloud SQLite) with historical preservation, plus a local SQLite backup for failover.

3

Load

The Shiny app queries Turso for real-time data, with automatic fallback to SQLite if needed.

4

Display

Libraries are plotted on the map with real-time status colors.

Data Source

BiblioStatus uses the official Finnish Libraries API (Kirkanta) to fetch library information and opening hours.

# Kirkanta API v4 # https://api.kirjastot.fi/ # Fetch library data GET "https://api.kirjastot.fi/v4/library" # Fetch schedules GET "https://api.kirjastot.fi/v4/schedules"