Regio ruumiandmete API on teenus, mis võimaldab
klientidel kasutada järgmisi veebipõhiseid API liideseid:
- Aadressid (geokodeerimine; pöördgeokodeerimine; kohanimeloend)
- Teekonnad (teekonnaarvutused; teekondade optimeerimine; kaugusmaatriksid)
- Huvipunktid (huviväärsuste ja turismiobjektide asukohainfo)
- Rasterkaardid (TMS teenus; WMS teenus)
- Vektorkaardid (MVT teenus)
Teenuse maksumuse leiate Riigipilve teenuste hinnakirjast.
Regio ruumiandmete API konsultatsiooni- ja tugiteenused Riigipilves leiad siit
Regio ruumiandmete API on kaugühenduse rakendusliides, mille abil päritakse ja edastatakse Regio andmebaasis olevaid andmeid üle interneti.
Liidese kaudu on võimalik tarbida alljärgnevaid teenuseid:
Aadressid
- Geokodeerimine –võimaldab tekstilise sisendi järgi otsida ja valideerida koha-aadresse (maaüksused, hooned), leida aadresside geograafilisi koordinaate, sihtnumbreid ja muid aadresskirjega seotud atribuute (inglise keeles Geocoding).
- Pöördgeokodeerimine –võimaldab otsida aadresse kasutades sisendina geograafilisi koordinaate (inglise keeles Reverse geocoding).
- Kohanimeloend –struktureeritud aadresside kataloog (inglise keeles Gazetteer)
Teekonnad
- Teekonnaarvutused –võimaldab luua teekondi kahe ja enama geograafilise punkti vahel tagastades nii teekonna geomeetria kui tekstilised instruktsioonid (inglise keeles Routing and directions).
- Teekondade optimeerimine –võimaldab leida kiireima või lühima teekonna mitmete asukohapunktide vahel (inglise keeles Traveling Salesman Problem).
- Kaugusmaatriksid –erinevate lähte-ning sihtpunktide vaheliste kauguste tabel, milles kaugused on mõõdetud mööda teid (inglise keeles Distance matrix)
Huvipunktid
- Huviväärsuste ja turismiobjektide asukohainfo, kokku 184 kategooriat ca 70 000 andmereaga. Kliendil on võimalik valida endale huvipakkuv(ad) kategooria(d), mida kaardil kuvada.
- TMS teenus –Eesti rasterkaart ruudustikuna (inglise keeles Tile Map Service).Teenusepakkuja poolt eelgenereeritud kaarditükid (tile’id). Kaarditükkidel on fikseeritud suumiastmed, stiilid, projektsioon, kihid, mida kasutaja muuta ei saa. Algandmeteks kasutatakse mõnda teist kaarditeenust, näiteks WMS.
- WMS teenus –Eesti rasterkaart (inglise keeles Web Map Service).Terviklik rasterkaart genereeritakse iga kasutaja päringu korral. Kaarditailid genereeritakse kasutaja poolt etteantud parameetrite (nähtav kaardiala ehk bounding box, nurgakoordinaadid, pildi mõõtmed, soovitud kihid) järgi vektorandmetest. WMS teenusega on kliendil võimalik valida, milliseid andmekihte kuvada. WMS puhul kasutatakse algandmetena näiteks .shp faile, PostGIS andmebaasi vms.
- MVT teenus –Eesti vektorkaart teenus vastavalt Mapbox spetsifikatsioonile (inglise keeles Mapbox Vector Tile).
Kasutaja poolt ette antud parameetrite (nähtav kaardiala ehk bounding box, soovitud kihid jm. alusel kuvatakse ekraanil vektorandmetest kaart, mille puhul andmed päritakse iga kaardiala nihutamise ja sisse-välja suumimise järel serverist uuesti.