AvalehtEelmineSisukordPrindi

63. ADS-i X-tee teenused

ADS-i X-tee teenuste kohta saab täpsemalt lugeda ADS-i analüüsidokumendist. X-tee on riigi ametlik andmevahetuskiht. Seepärast on ka ADS-i poolt infosüsteemidele pakutavad teenused tehtud just X-tee teenustena. Teenused on nii avaliku kui ka erasektori tarbijale tasuta.

Teenuste XML formaadis kirjeldustega on võimaik tutvuda Maa-ameti Geoportaali lehel: aadressiandmete süsteemi X-tee teenused.

Toimivate ADS X-tee teenuste versioon 5 WSDL: http://www.maaamet.ee/schemas/xTeenused/adsv5.wsdl (versioon 4 teenused suletakse 2015. aastal).

Lisaks ADS-i X-tee teenustele leiab seal kirjeldused ka kõikidele teistele Maa-ameti infosüsteemidega seotud X-tee teenustele.

  • Aadressikomponentide kehtiva seisu väljastamise teenus (ADSkomponendid.v2) – väljastab aadressikomponentide kehtiva seisu, kuid kuna kogu klassifikaatori andmemaht on väga suur, siis algne seis on mõistlik laadida ühekordsena aadressiandmete süsteemi avalikus teenuses väljavõtete alt CSV-vormingus ja seejärel hakata andmemuudatusi teenustest küsima. Seega päring on sobiv pigem üksikute klassifikaatori väärtuste kontrollimiseks, mitte kogu klassifikaatori allalaadimiseks.
  • Aadressikomponentide klassifikaatori muudatuste päring (ADSkompklassif.v2) – klassifikaatori väärtuste esmalaadimise järel saab selle teenuse kaudu muudatusi. Enamik infosüsteeme teevad andmeuuenduspäringuid öösiti, muudatused ise toimuvad päeval.
  • Aadressiobjekti otsing (ADSobjotsing.v4) – võimaldab otsida aadressiobjekte aadressi ja objekti andmete alusel.
  • Aadresside otsing (ADSaadrotsing.v1)
  • Objekti muudatuste päring (ADSobjmuudatused.v4) - selle teenuse kaudu saab väline infosüsteem teada, milliseid muudatusi on tehtud aadressiobjektide andmetes. Ainult objekti aadressimuudatused saab pärida eraldi teenuse kaudu.
  • Aadressi muudatuste päring (ADSaadrmuudatused.v4) – teenuse kaudu saab väline infosüsteem teavet aadresside lisandumisest, muutmisest ja tühistamisest ADS süsteemis etteantud vahemikus. Logitavad sündmused lähtuvalt otseselt aadressidest.
  • Objekti aadresside muudatuste päring (ADSobjaadrmuudatused.v2) - teenus annab teada, milliseid muudatusi on objekti aadressides tehtud etteantud vahemikus. Eelkõige jälgitakse objekti ja aadressi seose teket, muutmist ja kadumist. Selliste objekti-aadressi seoste sündmuste lisaandmetena väljastatakse ka aobjekti enda sündmused, samuti objekti järgnevusinfo, aadressi komponendid ning teised sama aadressiga seoses olevate objektide andmed.
  • Aadressiteksti normaliseerimise teenus (ADSnormal.v2) - teenuse sisendiks on normaliseerimata aadress, väljudiks on maksimaalselt normaliseeritud aadress. Kõikidel juhtudel ei ole võimalik aadressi normaliseerida.
  • Tühistatud objekti järglaste päring (ADSobjjarglased.v1) - teenuse kaudu on võimalik pärida tühistatud aadressiobjekti loogiliseks järglaseks olevaid objekte. Asendavad objektid võivad tekkida ajaliselt hiljem kui päringu tegemise hetkel.
  • Tühistatud aadressi järglaste päring (ADSaadrjarglased.v1) - teenuse kaudu on võimalik pärida tühistatud aadresside loogiliseks järglaseks olevaid aadresse. Asendavad aadressid võivad tekkida ajaliselt hiljem kui päringu tegemise hetkel.
  • Ruumiaadressi päring (ADSruumiaadress.v1) - teenuse kaudu on võimalik küsida kujule vastavaid ruumiaadresse. Sisendiks kas gml-formaadis kuju või punkti koordinaadid.
  • Liidestujate aadresside tagasiside teenus (ADSadrTagasiside.v1) - liidestunud register saab selle teenuse kaudu anda tagasidest enda aadressidest, mis ADS-iga seotud või puuduvad ADS-ist.
  • ADS gazetteer otsing (ADSgazetteerotsing.v1) - selle teenuse vahendusel on võimalik kasutada In-ADS-i aadresside päringuid üle X-tee.

Lisainfot:

ADS-i arendamne ja tarbijate tagasiside on tekitanud vajadused uutemate teenuste versioonide järgi. Teenuste vanemad versioonid ja nimekirjast puuduvad teenused on plaanis 2015.a. lõpuks sulgeda. Vanemad teenused on nii tehniliselt kui moraalselt aegunud ja ei anna enam andmete kohta päris adekvaatset infot.

    SisukordPrindi