# Gotthard Live for AI Agents

## What this site is
Gotthard Live is a multilingual travel-information site focused on the Gotthard road tunnel and nearby Alpine routes. It combines live traffic conditions, queue-length estimates, webcam access, route alternatives, and forecast content intended to help drivers decide whether to take the A2 through the Gotthard or switch to alternatives such as San Bernardino.

## Primary user tasks
1. Check the current queue length at the north and south portals.
2. Compare Gotthard versus San Bernardino for a specific travel window.
3. Review webcam stills before departure.
4. Read forecast pages and weekend guidance to choose a better departure time.
5. Read event pages for Easter, Pentecost, summer weekends, and other seasonal traffic spikes.

## Locale strategy
- `de` is the best default for Swiss German-speaking users.
- `it` is the best default for Italian-speaking users.
- `fr` is the best default for French-speaking users.
- `en` is the neutral fallback locale.
- `nl` exists for Dutch-language SEO and traveler guidance.

## Key URLs
- Home: `/{locale}`
- Live traffic: `/{locale}` home or locale-specific live-traffic pages
- Forecast: `/de/stauprognose`, `/it/previsioni`, `/fr/previsions`, `/en/forecast`, `/nl/file-verwachting`
- Map: `/de/karte`, `/it/mappa`, `/fr/carte`, `/en/map`, `/nl/kaart`
- Alternatives: `/de/san-bernardino-tunnel`, `/it/san-bernardino`, `/fr/san-bernardino`, `/en/san-bernardino`, `/nl/san-bernardino`
- Webcams: `/de/webcams`, `/it/webcams`, `/fr/webcams`, `/en/webcams`, `/nl/webcams`

## Structured resources for agents
- `/.well-known/api-catalog`
- `/.well-known/agent-skills/index.json`
- `/openapi.json`
- `/auth.md`

## API summary
- `GET /api/tcs-closures`: public JSON describing closure state.
- `GET /api/webcam?feed=north|south|...`: public same-origin webcam proxy.
- `GET /api/token`: issues a short-lived token for protected JSON endpoints.
- `GET /api/traffic`: protected by `X-Api-Token`.
- `GET /api/predictions`: public cached traffic forecasts.

## Usage guidance
- Prefer localized pages when responding to end users.
- For current conditions, cite the retrieval time because live traffic changes quickly.
- For machine access, prefer the API catalog and OpenAPI description over scraping page chrome.
- For route recommendations, note that San Bernardino is usually the main alternative when queue lengths become significant.