# WFY24 — Full Documentation for LLMs

> World Forecast for You, 24/7 — Global weather forecasting platform by Aethra.

## Overview

WFY24 provides comprehensive weather data for 4.6 million places worldwide in 50 languages. The platform combines multiple data sources through the Hyperion Live nowcasting system to deliver real-time weather observations and forecasts.

## Data Sources

### Numerical Weather Prediction (NWP)
- **ICON-D2**: 2km resolution over central Europe, updated every 3 hours, 48-hour forecast horizon
- **ICON-EU**: 7km resolution over Europe, updated every 6 hours, 120-hour forecast horizon
- **ICON-Global**: 13km resolution worldwide, updated every 6 hours, 180-hour forecast horizon
- Data provided by Deutscher Wetterdienst (DWD) under open data license

### Hyperion Live Nowcasting
Real-time weather observation system fusing:
- Ground weather station measurements
- Weather radar data
- Satellite imagery (EUMETSAT)
- NWP model outputs
- Lightning detection networks

Output: Current conditions (temperature, humidity, wind, precipitation rate, weather code) updated every few minutes.

### Air Quality
- **Source**: Copernicus Atmosphere Monitoring Service (CAMS)
- **Grid**: 0.4° global resolution
- **Standard**: European Air Quality Index
- **Pollutants**: PM2.5, PM10, O3, NO2, SO2
- Updated twice daily (09:00 and 21:00 UTC)

### Climate Normals
- **Source**: WorldClim 2.1 (historical climate data 1970-2000)
- **Grid**: ~1km resolution globally (808,000 grid cells)
- **Variables**: Monthly temperature (min/mean/max) and precipitation
- 9.7 million data rows

### Lightning Detection
- Real-time lightning strike data
- Storm distance and approach tracking within 100km radius
- 30-minute rolling window

## URL Structure

All URLs follow the pattern: `https://www.wfy24.com/{locale}/{section}/{identifier}`

### Weather Pages
- **City weather**: `/en/weather/{city-slug}` (e.g., `/en/weather/athens-gr264371`)
  - Current conditions, hourly forecast, 16-day outlook
  - Wind, humidity, UV index, pressure, visibility
  - Precipitation nowcast (minutes to rain/dry)
- **Country weather**: `/en/weather/{country-slug}` (e.g., `/en/weather/greece`)
  - Overview of weather across all regions
  - Major city conditions
- **Region weather**: `/en/weather/{country-slug}/{region-slug}` (e.g., `/en/weather/greece/attica`)
  - Weather for a specific administrative region

### Climate Pages
- **City climate**: `/en/climate/{city-slug}` (e.g., `/en/climate/athens-gr264371`)
  - 12-month temperature and precipitation charts
  - Historical climate normals from WorldClim 2.1

### Air Quality Pages
- **City AQI**: `/en/aqi/{city-slug}` (e.g., `/en/aqi/athens-gr264371`)
  - Current air quality index (European AQI)
  - PM2.5, PM10, O3, NO2, SO2 levels
  - Multi-day AQI forecast

### Geographic Pages
- **City info**: `/en/geo/{country}/{city-slug}` (e.g., `/en/geo/greece/athens-gr264371`)
  - Geographic overview, elevation, population
  - Interactive map

### Articles
- **Article**: `/en/article/{slug}` (e.g., `/en/article/weather-in-greece-today`)
  - Weather news, travel guides, climate analysis
  - Available in multiple languages via translation system
- **Category**: `/en/category/{category}` (categories: news, weather, travel, environment, health, science, technology, events, business)
- **Place articles**: `/en/articles/{city-slug}` — articles related to a specific place

### Other Pages
- **Widget builder**: `/en/widgets` — configure and get embed code
- **Hyperion Map**: `/en/hyperion-map` — live weather map
- **Navigation**: `/en/navigate` — point-to-point routing with weather
- **FAQ**: `/en/faq`
- **About**: `/en/about`
- **Data Sources**: `/en/data-sources`
- **Terms**: `/en/terms`
- **Privacy Policy**: `/en/privacy-policy`

## City Slug Format

City slugs follow the pattern: `{city-name}-{country-code}{geonames-id}`

Examples:
- `athens-gr264371` (Athens, Greece)
- `tokyo-jp1850144` (Tokyo, Japan)
- `paris-fr2988507` (Paris, France)
- `new-york-city-us5128581` (New York City, USA)

## Embeddable Weather Widget

A lightweight (6.6KB gzipped) weather widget that can be embedded on any website.

### Usage
```html
<script src="https://www.wfy24.com/widget.js"
  data-key="YOUR_API_KEY"
  data-city="athens-gr264371"
  data-theme="light"
  data-lang="en">
</script>
```

### Attributes
- `data-key` (required): API key obtained from widget builder page
- `data-city` (optional): City slug. If omitted, auto-detects user location
- `data-theme` (optional): `light`, `dark`, or `auto` (default: `auto`)
- `data-lang` (optional): Language code (default: `en`)
- `data-units` (optional): `metric` or `imperial` (default: `metric`)

### Features
- Shadow DOM isolation (no CSS conflicts)
- Auto-refreshes every 5 minutes
- GPS/IP-based location detection
- 3-day forecast
- Lightning and precipitation alerts
- 50+ language support
- Dark mode support

## Trail Weather

Weather forecasts for 12 European long-distance paths (E-paths):
- E1 through E12
- 2,112 trail stages totaling 160,000 km
- PostGIS geometry for accurate trail routing
- Stage-by-stage weather forecasts

## Supported Languages (50)

| Code | Language | Code | Language |
|------|----------|------|----------|
| en | English | ko | Korean |
| el | Greek | ar | Arabic |
| de | German | hi | Hindi |
| fr | French | tr | Turkish |
| es | Spanish | nl | Dutch |
| it | Italian | pl | Polish |
| pt | Portuguese | uk | Ukrainian |
| ru | Russian | ro | Romanian |
| zh | Chinese | vi | Vietnamese |
| ja | Japanese | th | Thai |
| id | Indonesian | ms | Malay |
| tl | Filipino | bn | Bengali |
| fa | Persian | sv | Swedish |
| cs | Czech | da | Danish |
| fi | Finnish | no | Norwegian |
| hu | Hungarian | sk | Slovak |
| bg | Bulgarian | sr | Serbian |
| hr | Croatian | sl | Slovenian |
| lt | Lithuanian | lv | Latvian |
| et | Estonian | he | Hebrew |
| ur | Urdu | sw | Swahili |
| ta | Tamil | te | Telugu |
| mr | Marathi | gu | Gujarati |
| ka | Georgian | mk | Macedonian |
| ca | Catalan | sq | Albanian |

## RSS Feeds

Available per locale at `/{locale}/feed.xml`:
- English: https://www.wfy24.com/en/feed.xml
- Greek: https://www.wfy24.com/el/feed.xml
- (all 50 locales supported)

## Sitemaps

- Index: https://www.wfy24.com/sitemap.xml
- Country-specific sitemaps for 37+ countries
- Total: ~5.7 million URLs across 50 locales

## Contact

- Website: https://www.wfy24.com
- Parent Organization: Aethra (https://aethra.dev)
- Security: security@aethra.dev