Teede API Transpordiametile

Teede API muudab GPS-koordinaadid hetkega täpseteks ja ametlikeks teeaadressideks. See tarkvaralahendus annab päästetöötajatele ja logistikutele teada täpse teenumbri ning kilomeetri, tagades veatu positsioneerimise üle kogu Eesti riigimaanteede võrgustiku.

Kliendist

Transpordiamet (TRAM) vastutab liikluse korraldamise eest maal, õhus ja vees, tagades taristu korrashoiu ja üldise ohutuse. Nende peamised ülesanded on riigiteede ehitamine ja hooldamine, liiklusregistri haldamine ning järelevalve kõigi transpordiliikide üle. Ameti eesmärk on pakkuda inimestele ja ettevõtetele ohutut, mugavat ja nutikat liikumiskeskkonda.

Klient Transpordiamet (TRAM)
Projekti viide Vaata siit
Projekti algus November 2025
Projekti lõppt Detsember 2025

Kliendi probleem

Täpne kaardistus kaasaegsele Eestile

Tänapäeva logistikas ja päästeteenistuses on GPS-koordinaat lihtsalt rida numbreid. Transpordiameti (TRAM) jaoks peavad need numbrid aga tähendama konkreetset asukohta riiklikus teedevõrgus. Wenture ülesandeks oli luua võimekas sild nende kahe maailma vahel: Transpordiameti teede API.

Väljakutse: punktide muutmine aadressideks Riiklikud asutused, nagu Politsei- ja Piirivalveamet (PPA), loovad igas minutis tuhandeid koordinaatpunkte. Varasemalt oli nende teisendamine ametlikeks teenumbriteks ja kilomeetritähisteks (m-aadressideks) tehniliselt keeruline ja ressursimahukas. Transpordiamet vajas lahendust, mis oleks ülitäpne, avalikult kättesaadav ja suudaks teenindada suuri päringumahtusid viivituseta.

Lahendus: matemaatiline täpsus ja pilvevõimekus

Wenture arendas Transpordiameti keskse API koosseisu erimooduli, mis teeb reaalajas päringuid ametlikku Teeregistri ArcGIS teenusesse.

Peamised funktsioonid:

  • Mitme koordinaatsüsteemi tugi: Tuvastab nii L-EST97 kui ka WGS84 koordinaate.

  • Ortogonaalprojektsiooni algoritm: Kasutab vektorprojektsiooni valemeid, et leida lähim punkt tee teljel.

  • Interpoleeritud m-aadressi arvutus: Arvutab täpse tee kilomeetri ka siis, kui punkt jääb andmepunktide vahele.

  • Suuremahuline paralleeltöötlus: Kasutab Java 21 virtuaallõimesid kuni 250 päringu samaaegseks töötlemiseks.

  • Nutikas tõrkekindlus: Rakendatud on circuit breaker (Resilience4j) ja efektiivne puhverdamine.

Tehnoloogiad:

  • Backend: Java 21 ja Spring Boot 3.2.

  • Liidestused: Otseühendus Transpordiameti ArcGIS WFS teenusega.

Tulemus: uus standard taristuandmete valdkonnas

Meie lahendus eristub tänu kolmele olulisele eelisele:

  1. Maksimaalne täpsus: Meie algoritm arvutab täpse ristprojektsiooni teele, tagades igale päringule sub-meetrise täpsuse.

  2. Süsteemi vastupidavus: Kasutades Java 21 võimalusi, lõime süsteemi, mis kaitseb riiklikku taristut ülekoormuse eest ja serveerib korduvaid päringuid hetkega.

  3. Avatud andmed: Lõime avaliku REST API, mis võimaldab igal arendajal integreerida ametlikud teeandmed oma rakendustesse.

Teede API on nüüdseks Eesti teepõhiste asukohateenuste süda. Olgu tegu marsruuti kontrolliva veoki või päästeautoga – andmed on ametlikud, täpsed ja kättesaadavad millisekunditega.