# 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

## 5. Teeregister — teekasutuslepingud (2026-08)

- **Allikas:** `https://teeregister.mnt.ee/290424/wfs`, kiht `ms:n_alusdokumendid_ja_lepingud`
- **Roll:** teekasutuslepingud — **kasutusrežiim** täiendab omandisuhteid:
  - `avalik` — avalikult kasutatav tee (KOV haldusakt / riigitee)
  - `metsatee` — RMK kasutusmetsatee (**võib olla ka eramaal!**)
  - `mitteavalik` — piiratud juurdepääsuga tee (eramaa)
- **Atribuudid:** `kasutus` (kasutus_kasutus_val), `oigusakt` (KOV haldusakt / RMK taotlus / eraisiku taotlus), `leping_nr`, `leping_kp`
- **Tähelepanek:** `tee_number` on teeregistri **sisemine OID** (ei ühti riigitee numbriga) → sidumine **geomeetria kaudu** (spatial join), nagu omand
- **Skript:** `pipeline/teeregister_leping.py` → `{prefix}_teeregister_leping.gpkg`; `export_qgis.py` lisab teedele `kasutus`
- **Fallback omandi järgi (kui lepingukiht ei katanud lõiku):**
  - Munitsipaalomand → avalik (KOV teed on avaliku kasutusega)
  - **Riigiomand → avalik** (riigimaa tee on avalik — ka kohalikud teed/trackid)
  - **Eraomand → mitteavalik** (eratee; kui registrisse ilmub hiljem "avalik", muudab andmevärskendus)
  - Omanditeta → määramata
  - Omandiks `omand_kat` (kataster), fallback `omand` (teeregister)
  - Märkus: lepingukihi `metsatee` on prioriteet — kui leping olemas, jääb metsateeks
- **Väärtus:** metsatee eramaal (RMK) — selgitab, miks mõni "eratee" on RMK kasutusmetsatee; mitteavalik täiendab eramaa piiratud juurdepääsu

## 6. Kasutaja käsitsi uuringu loogika (2026-08, üle võetud)

Kasutaja QGIS-i + pgRouting-i uuringust (hetzneri postgres `valga_vald`) võeti üle järgmised **loogilised** ideed (andmed meie allikatest):
- **`is_deadend`** (tupikteed) — lõigu otspunkti aste = 1 (`export_qgis.py`, OSM-võrgust)
- **`is_exit`** (väljapääsu lõik) — otspunkt riigitee sõlm
- **Reisitee** (`trip_length_m`) — lõigu BFS-puu ahela pikkus väljapääsuni (meetrites)
- **Reisi kasutuskoond** (`trip_kasutus`) — loetelu teekasutuslepingu režiimidest (avalik/metsatee/mitteavalik) reisi teel väljapääsuni. Näide: "metsatee,mitteavalik" = reis kulgeb läbi metsatee- ja piiratud kasutusega lõikude
- **ADS aadress-kinnistu link** (`ads_ky`) — aadressi KÜ tunnus sõlme kohta (`building_population.py`)
- **Kasutusväärtus:** reisikoond näitab, milline kohalik tee on "ainus lepingulõik" (piiratud juurdepääsuga) väljapääsuni
- **Mõisted (popup):** "Väljapääs (ID)" = lähim väljapääsupunkt (kohaliku tee ja riigitee ristmik); "Reisi pikkus väljapääsuni" = teepikkus mööda kohalikku teed selleni. `is_agreement` oli ülearune (identne `trip_kasutus` olemasoluga) — eemaldatud popupist 2026-08.

## 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)
