# Maa- ja Ruumiameti kaardiandmed kaardiserver.ee jaoks Kontrollitud 20.11.2026. Uuring piirdub Maa- ja Ruumiameti ning Mapboxi ametlike allikatega. URL-id on ametlikel teenuselehtedel loetletud; enne tootmiskasutust tuleb kontrollida iga teenuse GetCapabilities vastust, kihtide nimesid, koordinaatsüsteemi ja tegelikku CORS/proxy käitumist. ## Lühijäreldus - X-GIS/Geoportaal pakub kaardirakendusi ning OGC WMS/WMTS vaatamiseks ja WFS/WCS andmete kasutamiseks/allalaadimiseks. Andmed päritakse teenusest otse, ajakohane seis sõltub registrist. - 3D kaardirakendus on üle-eestiline; mudelid põhinevad aerolaserskaneerimise kõrguspunktidel, tiheasustuses detailsemad. Allalaaditavad 3D hooned on LOD1/LOD2; eraldi saab liiklusrajatisi ja tiheasustuse üksikpuid. Failivormingud on GDB, CityGML ja OBJ; kogu hoonete kogum on sadades MB, seega ära impordi seda kliendi alglaadimisel. - Lisaks failide allalaadimisele on kontrollitud päris MaRu I3S SceneServer teenused (vt `maa-apps-research.md`). Mapbox ei paku dokumenteeritud natiivset I3S source’i; Ruumiradari olemasolev katse kasutab eraldi Mapbox custom layer laadijat. I3S ja 3D Tiles on erinevad vormingud. Ära alusta kogu linna failide teisendamisest enne olemasoleva I3S tee võrdlust. Teenuse avalik metadata ei tõenda üksi õigust iga teenuse sisu kommertsrakenduses ümber jagada. ## Kasulikud MaRu teenused | Teenus | URL | Sobiv kasutus | |---|---|---| | Aluskaardi WMS | `https://kaart.maaamet.ee/wms/alus?` | halduspiirid, teed, ortofotod, põhikaardid; veebis pildina | | Kaardi/ETAK WMS | `https://kaart.maaamet.ee/wms/kaart?` | ETAK objektide ja teede visuaalne kiht | | Fotokaardi WMS | `https://kaart.maaamet.ee/wms/fotokaart?` | ortofotod, reljeefivarjutus, DSM/CHM, hübriidkaart | | Ajaloolise kaardi WMS | `https://kaart.maaamet.ee/wms/ajalooline?` | ajaloolised ortofotod ja aluskaardid | | ETAK WMS | `https://gsavalik.envir.ee/geoserver/etak/wms?` | topograafia andmekogu tuumkihtide vaatamine | | ETAK WFS 2.0 | `https://gsavalik.envir.ee/geoserver/etak/wfs?` | topograafia vektorobjektid; vaikimisi kuni 5000 objekti/päring, kasuta pagingut | | Ajaloolised haldusüksused WMS | `https://teenus-ogc-ms.geoportaal.ee/ows/ajalooline-haldusjaotus?` | haldusjaotuse ajalugu alates 1917 | | Ajaloolised haldusüksused WFS | sama URL, WFS 2.0 GetCapabilities | vektorandmete allalaadimine/analüüs | | Geodeetiliste punktide WMS/WFS | `https://teenus-ogc-ms.geoportaal.ee/ows/gpa?` | riiklik/kohalik geodeetiline ja kõrgusvõrk | | Aadressi- ja kohanimede WFS | `https://aks.geoportaal.ee/aks-ogc?` | aadressid, hooned, kohanimed; WFS 2.0 GetCapabilities | Kasutage tootmises esmalt ametliku ruumiandmete kataloogi teenusekirjet ja GetCapabilities’i, mitte ärge eeldage, et vanad URL-id või kihinimed püsivad. WFS-i suure kogumi päringut tuleb lehtedeks jagada. ## 3D andmete liidestamine 1. MVP-s serveeri dünaamilised 2D kihid WMS/WMTS-ina ning küsi WFS-i kitsalt vaateala/objektipäringutena läbi serveripoolse proxy, kui brauseri CORS seda nõuab. WMS raster sobib lihtsaks alus-/teemakihiks; WFS sobib valitud vektorobjektideks. 2. 3D hoonete jaoks vali allalaadimislehelt piiratud omavalitsus või asustusüksus ja sobiv LOD. Proovi esmalt CityGML-i; teisenda/tili see serveris 3D Tiles’iks ainult siis, kui vajaliku kasutajakogemuse jaoks on tähtis vaatepõhine detaili laadimine. Avalik allalaadimisleht ei tõenda, et MaRu ise pakub 3D Tiles teenust. 3. Kui Mapbox on kohustuslik: lihtsustatud hoonete jalajäljed + kõrgusomadus võib minna Mapbox `fill-extrusion` kihina, aga see on üldistatud prisma, mitte LOD2 mudel. Täpse geomeetria jaoks kasuta kas Mapboxi custom layer liidest Three.js-i ning oma 3D Tiles loaderiga või CesiumJS-i eraldi 3D vaates. Kontrolli EPSG:3301 (L-EST97) geomeetria teisendust Mapboxi WGS84/Web Mercatori koordinaatidesse ning kõrguse nullpinda; valideeri prooviga. ## Litsents ja viitamine MaRu KKK ütleb, et MaRu ruumiandmed on üldiselt tasuta kasutatavad, kuid kaarditeenuste tingimused nõuavad avalikul esitlemisel/integreerimisel andmete nimetuse, väljavõtte aja või vanuse ja Maa- ja Ruumiameti nimega viitamist. 3D allalaadimisleht ütleb, et andmed on vabaks kasutamiseks ning palub märkida päritolu ja väljavõtte aeg (näiteks “Hoonete ruumiandmed: Maa- ja Ruumiamet 2026”); allalaadimine tähendab avaandmete tingimustega nõustumist. Pane allika omistus kasutajale nähtavale kaardil ning hoia allika/kuupäeva metaandmed iga imporditud 3D partii juures. Teenuse kättesaadavust ei garanteerita. ## Ametlikud allikad - [WMS/WFS/WCS teenuste kataloog ja teenuse URL-id](https://geoportaal.maaruum.ee/est/Teenused/WMS-teenused-p65.html) - [Teenuste kasutamise KKK: WMS/WMTS vs WFS/WCS](https://geoportaal.maaruum.ee/est/abi-ja-juhised/teenused) - [Kaarditeenuste kasutustingimused](https://geoportaal.maaruum.ee/est/est/teenused/wms-wfs-wcs-teenused/maa-ja-ruumiameti-kaarditeenuste-kasutustingimused-p24.html) - [3D KKK](https://geoportaal.maaruum.ee/est/abi-ja-juhised/3d) - [Laadi 3D andmed alla](https://geoportaal.maaruum.ee/est/ruumiandmed/geo3d/laadi-3d-andmed-alla-p833.html) - [Mapbox GL JS kihid, sources, DEM ja fill-extrusion](https://docs.mapbox.com/mapbox-gl-js/guides/styles/work-with-layers/) - [Mapbox GL JS ülevaade: oma andmed, custom 3D/Three.js](https://docs.mapbox.com/mapbox-gl-js/)