# Andmeallikad

Kõik andmed on **avalikud ja tasuta** — see on metoodika oluline eelis (kaudne hindamine ilma kallite loendusteta).

## 1. ADS — Aadressiandmete Süsteem (Maa- ja Ruumiamet)

- **Allikas:** `https://aks.geoportaal.ee/aks-ogc` (WFS 2.0.0), kiht `aks:ads_hoone_a` (hoone pind-polügoonid, EPSG:3301)
- **Roll:** riiklik aadressiregister. **Kõik ADS-i hooned on ametlikult aadressiga.** Seaduse alusel kohustuslik KOV-idele.
- **Atribuudid:** `ads_oid` (unikaalne), `adob_liik` (ME=hoone, EE=ehitis), `ehr_kood` (Ehitisregistri kood), `taisaadress`, `lahiaadress`, `sihtnumbrid`, `olek`
- **Skript:** `pipeline/ads_buildings.py` → `{prefix}_ads_buildings.gpkg`
- **Uuendatavus:** iga käivitamine annab kehtiva seisu (teenus pärib otse registrist)
- **Piirang:** sisaldab KÕIKI hooneid (sh kõrvalhooned, suvilad) → rahvastiku hinnangus ülehinnatud; kasutatakse võrdluseks popupis, mitte peamisena
- **Tulevikuplaan:** EHR-i sihtotstarve (eluhoone vs mitte) `ehr_kood`-i kaudu

**Võrdlus Valga vallas (2026-08):**
| Allikas | Hooneid | Aadressiga | Märkus |
|---------|---------|-----------|--------|
| OSM | 14 728 | 7 653 | aadressikate puudulik |
| ADS | 17 452 | 17 452 | kõik aadressiga, kuid ka suvilad/kõrvalhooned |

## 2. OpenStreetMap (OSM)

- **Allikas:** `https://www.openstreetmap.org` (OSMnx kaudu)
- **Kasutus:** teedevõrgustik, valla piirid
- **Võrgustiku filter:** `CUSTOM_FILTER` — sõidukiteed + kohalikud teed + service + track:
  ```
  ["highway"]["area"!~"yes"]["highway"!~"cycleway|footway|path|pedestrian|steps|corridor|..."]
  ["motor_vehicle"!~"no"]
  ```
- **Kraam:** `osmnx.graph_from_polygon(boundary, custom_filter)`
- **CRS:** EPSG:3301 (Eesti riiklik koordinaatsüsteem)
- **Cache:** `liiklussagedus/cache/` — OSMnx vahemälu (vältida korduvat allalaadimist)

### Teede klassifikatsioon

| Klass | highway-tagid |
|-------|---------------|
| Riigiteed (major) | `trunk`, `trunk_link`, `primary`, `secondary`, `tertiary` (+ _link) |
| Kohalikud teed (local) | `residential`, `unclassified`, `service`, `track`, `living_street` |

### Väljapääsupunktid

`exit_nodes = local_nodes ∩ major_nodes` — kohaliku võrgustiku sõlmed, mis on ühtlasi riigiteede sõlmed. Need on piirid, kus kohalik liiklus "voolab" riigimaanteele.

## 2. OpenStreetMap hooned (rahvastik — PEAMINE)

**Kasutus:** rahvastiku hinnang tee sõlmedele (alates 2026-08).

- Laetakse kõik `building` tunnusega hooned valla piiris (`osmnx.features_from_polygon`)
- **Aadressiga hooned** (`addr:housenumber`) = tegelikud eluruumid (hõreasustuses on palju suvilaid/abihooneid ilma aadressita)
- Iga hoone omistatakse **lähimale tee sõlmele** (max 300 m)
- Elanikud = hoonete arv × 2.2 (Eesti keskmine leibkond); korterelamu = 12
- Eelis WorldPop-i ees: kajastab TEGELIKKE maju, ei "ime" linna rahvastikku kaugematele põlluteede sõlmedele
- Skript: `pipeline/building_population.py` → `{prefix}_pop_node_population.csv`

**Võrdlus tegeliku rahvaarvuga (2026-08):**
| Vald | Hinnang (aadressiga hooned) | Tegelik |
|------|---------------------------|---------|
| Valga | 17 348 | ~16 000 |
| Otepää | 6 607 | ~6 700 |
| Võru | 9 622 | ~10 000 |

## 3. WorldPop (rahvastik — varuversioon, EI OLE enam peamine)

- **Allikas:** `https://data.worldpop.org/GIS/Population/Global_2000_2020/2020/EST/est_ppp_2020.tif`
- **Formaat:** 100 m ruumiline raster, rahvaarv ruudustiku kohta
- **Cache:** `liiklussagedus/data/est_ppp_2020.tif` (~47 MB)
- **Puudus:** omistab rahvastiku lähimale sõlmele kuni 5 km kaugusel — linnaservas olevad põlluteed "imevad" linna rahvastikku (näide: Otepää sõlm 281707587 sai 40.5 elanikku, kuigi küljes on põllutee). **Asendatud hoonepõhise hinnanguga.**

## 4. Transpordiamet / riiklikud registrid (tulevik)

- Riigimaanteede liiklusloendused — avalikud (maanteede registri liiklusandmed)
- Maanteeandmed, teekatte klassid — teeregister
- **Seos:** kohalike teede hinnang tuleb siduda riigiteede loendustega validatsiooniks

## 4. Maa-amet (tulevik)

- Katastriüksused, aadressandmed, hooned — juurdepääsetavuse analüüsi jaoks
- (Kasutatud olemasolevas Valga juurdepääsetavuse artiklis)

## Andmete kvaliteedimärkused

- OSM-i hõlmatus on maapiirkondades Eestis hea, kuid hoonete/teede attribuudid võivad erineda
- WorldPop on modelleeritud rahvastik — mitte täpne loendus; see on metoodika üks peamisi täpsuspiiranguid
- Valla piirid OSM-ist vajavad kontrolli (halduspiirid vs OSM-i admin boundary)
