norway-roads

# Norway Roads

Query real-time road closures and conditions from Statens Vegvesen NVDB API.

## Quick Start

Check all current road closures:
```bash
./scripts/query_roads.py
```

Check route between two cities:
```bash
./scripts/query_roads.py --from Oslo --to Bergen
```

Check specific road/location:
```bash
./scripts/query_roads.py --road "Strynefjell"
```

Get JSON output:
```bash
./scripts/query_roads.py --json
```

## Usage Examples

### Check Route Conditions

When planning a trip between two Norwegian cities:

```bash
./scripts/query_roads.py --from Oslo --to Bergen
./scripts/query_roads.py --from Oslo --to Trondheim
./scripts/query_roads.py --from Bergen --to Stavanger
```

Supported cities: Oslo, Bergen, Stavanger, Trondheim, Tromsø, Kristiansand, Ålesund, Bodø

### Filter by Location Name

```bash
./scripts/query_roads.py --road "Strynefjell"
./scripts/query_roads.py --road "E6"
```

## What Data is Returned

The skill queries two types of road restrictions from NVDB:

1. **Vegstengning (Road Closures)** - Scheduled or permanent closures
   - Seasonal closures (winter mountain passes)
   - Landslide/avalanche closures
   - Maintenance closures
   - Causes: Snow (Snø), Ice (Is), Rock (Stein)

2. **Vegsperring (Physical Barriers)** - Physical blocking of roads
   - Gates, barriers, concrete blocks
   - Permanent restrictions

## API Response Format

Each closure includes:
- **location**: Street/road name
- **county**: Norwegian county (fylke)
- **municipality**: Kommune
- **from_date/to_date**: Closure period
- **cause**: Reason (Snø=snow, Is=ice, Stein=rock)
- **type**: closure or barrier

## Data Source

- **API**: NVDB v3 (Nasjonal VegDataBank)
- **URL**: https://nvdbapiles-v3.atlas.vegvesen.no
- **Object types**: 485 (Vegstengning), 607 (Vegsperring)
- **Update frequency**: Real-time from official database
- **No API key required**: Open public data

## Common Norwegian Terms

| Norwegian | English |
|-----------|---------|
| Vegstengning | Road closur...