Avaandmete allalaadija kasutusjuhend
Avaandmete allalaadija (ehk API-de kasutajaliides) on loodud neile, kes soovivad kasutada ilma- ja keskkonna valdkonna väärtuslike avaandmeid, kuid ei soovi seda teha üle API-de. Allalaadija abil saab avaandmete tabeleid otsida, filtreerida ja alla tõmmata piiranguteta CSV formaadis ning ka genereerida API päringute URL-e. Keskkonna ja ilma valdkonna andmeteenuste keskkonnast, sh kasutusnäidetest ja piirangutes, saab lähemalt lugeda siit.
Allalaadija on loodud avaandmete direktiiv mass-allalaadimise (bulk download) nõude täitmiseks ja sisaldab erinevate andmekogude ja infosüsteemide avaandmeid (EELIS, KOTKAS, KESE, CLIDATA, WISKI).
Kasutusjuhend:
- Mine avaandmete allalaadija lehele https://keskkonnaportaalprelive.envir.ee/et/avaandmed/avaandmete-allalaadimine. Andmestike ja levituste kirjeldused ning otselingid leiad ka andmekataloogist.
- Vali allalaadija lehelt levitus mille andmeid soovid saada. Levituste tabeli all osas asuv otsing võimaldab otsida levitus nime järgi.
- Valitud levituse detailvaates saad valida andmetulpi mida soovid päringusse. Tulpade valimiseks või eemaldamiseks vali tulba eesolev märkeruut.
-
Päringu mahu vähendamiseks on soovitatav lisada filtreid allalaadimise päringule. Filtreerimiseks vali [+ Lisa filter] ning seejärel avanevas lahtris vali filtri tüüp.
Kasutada saab järgmisi filtritüüpe:
= annab täpse vaste otsingusõnale (väljatüübid: tekst, number, kuupäev, ei/jah)
≈ annab umbkaudse vaste otsingusõnale (väljatüüp: tekst)
≠ välistab otsingusõna (väljatüübid: tekst, number, kuupäev, ei/jah)
< suurem kui arvulise otsingu puhul (väljatüübid: number, kuupäev)
≤ suurem kui või võrdne arvulise otsingu puhul (väljatüübid: number, kuupäev)
> väiksem kui arvulise otsingu puhul (väljatüübid: number, kuupäev)
≥ väiksem kui või võrdne arvulise otsingu puhul (väljatüübid: number, kuupäev)
Mitme täpse otsingusõna jaoks tuleb lisada mitu filtrit, nt kui on soov filtreerida ID tulpa väärtustega 10301 ja 10333 siis tuleb lisada 2 filtritingimust:
= 10301
= 10333
Seejärel tekib päring, kus filtreeritakse ainult read, mille ID väärtuseks on 10301 või 10333
Kui on soov neid ID-sid sisaldavad read välistada andmetest siis tuleks siis tuleb lisada 2 filtritingimust:
≠ 10301
≠ 10333
Seejärel tekib päring, kus filtreeritakse välja read, mille ID väärtuseks on 10301 või 10333
- Vajuta nuppu [Laadi alla]. Seejärel avaneb faili salvestamise asukoha valimise dialoog. Vali asukoht ja vajadusel saad muuta allalaetava faili nime. Soovitavalt tuleks valida c: kettal asuv asukoht, sest asutuse turvapoliitika võib välistada muid asukohti nagu töölaud, dokumendid jne.
- Vali salvesta ja avaandmete allalaadija tööriist kuvab ekraanil allaaadimise % ning allalaetud rida arvu/ kogurida arvu. Oota kuni andmed on alla tõmmatud ja kuvatakse kiri „Võid salvestatud faili avada“
- Ava fail salvestatud asukohas ning alusta andmete kasutamist.
- Kui on soov saada ka päringu URL masin-masin liideses kasutamiseks siis tuleb vajutada peale levituse valimist nupul [Loo rakendusliidese aadress]. Seejärel kopeeritakse link automaatselt lõikemällu ja avaneb uus aken vastava päringuga Keskkonna ja ilma valdkonna andmeteenuste API-de keskkonnas. Tuleb arvestada, et selle lingi kaudu saab päringu millel on piirang 20 000 rida.
KKK
- Toetatud veebibrauserid
-
Allalaadijat saab kasutada veebibrauserites, mis toetavad File System Access API-d (vt nimekirja: caniuse.com/filesystem). Kahjuks ei tööta see praegu Firefoxi brauseris.
- Tehnilised nõuded kasutaja arvutile
-
Allalaadimise käigus kasutatakse kasutaja arvuti ressursse (näiteks mälu ja kettaruumi). Suuremahuliste päringute puhul on soovitatav veenduda, et arvutis on piisavalt vaba ruumi ja mälu.
- Veateade „Seda faili ei saa avada“
-
Mõnel juhul võib pärast faili salvestamist ilmuda veateade „Seda faili ei saa avada“. See võib juhtuda, kui näiteks riigiasutuse turvaseaded ei luba faile salvestada töölauale või dokumentide kausta. Sellisel juhul proovi salvestada fail C: kettale või mõnda teise kausta, mis pole piirangutega hõlmatud.
- Kopeerisin URL-i aga selle kaudu ei saa kõiki andmeridu
-
Allalaadija saab andmed keskkonnaportaalist (https://keskkonnaandmed.envir.ee/), kus ühe päringu piirang on 20 000 rida. Seetõttu esitab allalaadija mitu päringut järjest – iga kord kuni 20 000 rida – ja salvestab iga saadud päringu andmed faili. Nii saab alla laadida piiranguteta andmestikke mis on väärtuslike avandmete massallaaadimise (bulk download) nõue vastavalt avaandmete direktiivile. Soovitame siiski kasutada võimalusel filtreid (nt kuupäev, piirkond vms), et vähendada koormust ja kiirendada allalaadimist.
API-de kasutamiseks URL-ide põhiselt peab kasutaja looma päringusüsteemi, kus küsitakse 20 000 rea kaupa andmed.
- Alalaadimisel on jääb 0% ega kuva ridade arvu (arvu asemele on ?)
-
Mahukate päringute või suure kasutuskoormuse korral võib allalaadimise alustamine võtta aega. Kui allalaadimine ei käivitu ka mõne minuti jooksul, võib tegemist olla häirega keskkonna andmeteenuses. Sel juhul proovi hiljem uuesti. Kui probleem kordub, palun anna sellest teada KKP klienditoele.
Tagasiside:
- Kuupäevade vahemiku valimise näide lahti kirjutada (+ videojuhend) põhjalikult erinevate valikutüüpide puhul (kliima, hüdroseire, keskkonnaseire)
- Kliima andmetes ei ole EST elementide nimesid ja andmekirjelduse juures puuduvad ingliskeelsed vasted ning vaja löisada emb-kumb
- Meteo andmetes on timestamp väga eksitav filtrite puhul ja tuleks teha näiteid selle kohta
- Filtri placeholder on natukene eristamatu seoses gamma ja kontrastusega (KKP fondi värv on ka tumedam hall), vb juurde lisada "nt, DCAT..." vms