search

e-gov / FaktoidAPI

[Archived] Spetsifikatsioon, näidis-implementatsioon ja abivahendid lühikeste kohapõhiste faktide jagamiseks maailmaga
MIT License
4 stars 1 forks source link

API ligipääs andmebaasile: Raamatukogude Info- ja Kataloogisüsteem #5

Open timotoots opened 8 years ago

timotoots commented 8 years ago

Soovitud andmed:

meelisl commented 8 years ago

Esimene päring testimiseks Raamatukogude Info- ja Kataloogisüsteem RIKS. Päring väljastab JSON formaadis viimati laenutatud teaviku pealkirja, autori, raamatukogu nimetuse ja kuupäeva (Unix Timestamp).

http://live.webriks.ee/egov/?query=1

timotoots commented 8 years ago

Väga vinge! Me sooviks seda nimekirja EHAK koodi (asula kood) järgi ka näidata. Kas seotud raamatukogude nimekirja ka annaks sealt välja võtta, kus olemas aadress, GPS koordinaat või EHAK kood. Või on nimekiri kuskil mujal leitav?

meelisl commented 8 years ago

EHAK koodiga mul kogud seotud ei ole. Kui seda tõesti vaja, siis see pikem töö, et oma klientide baasis need nii siduda.

Lisasin lihtsa väljundi raamatukogudest+maakond, kas nii sobib?

http://live.webriks.ee/egov/?query=2

timotoots commented 8 years ago

Kui saaks lisaks maakonnale ka asula lisaks, olekski juba väga hea. Selle järgi saab EHAK koodi ka leida. Aitäh!

meelisl commented 8 years ago

OK, lisasin raamatukogudele maakonna EHAK koodi. Asula tasemel, siis läheb aega, sest pean kõik 480 raamatukogu ükshaaval üle käima ja otsima, see juba pikem töö. :)

timotoots commented 8 years ago

Asula nimest ka piisaks. Koodi saaks otsinguga kätte.

meelisl commented 8 years ago

Teeb suht sama välja. Mul on küll aadress enamusel, aga korrektset asula nimetust ei pruugi selles sisalduda. :(

meelisl commented 8 years ago

ega ei oska öelda, kas Stat. ameti lehelt saab kogu Eesti haldusstruktuuri koos ehak koodiga, näiteks XML'is, siis saaks kiiremini nikerdada.

timotoots commented 8 years ago

Sellega saaks vist korrastada aadressiandmed: http://xgis.maaamet.ee/adsavalik/ads Või siis siit tabelist nimekirja kätte: https://github.com/e-gov/FaktoidAPI/blob/master/EHAK2015v1.txt

meelisl commented 8 years ago

OK. Mõlemale päringule lisatud ehak, aga esialgu osaliselt, kuna aadressi järgi saan ainult mõnedele täpse koodi määrata. Kas nii muidu sobiks? Kõikidele koodi määramine võtab aega, sest pean seda 1 haaval tegema :)

meelisl commented 8 years ago

Lisasin väljundisse ka koordinaadid.

timotoots commented 8 years ago

Oh, see veel kõige parem. Sealt peaks saama ka EHAK teisenduse teha, kui vaja. GPS veel abstraktsem!

meelisl commented 8 years ago

Homme saan EHAK koodid kah paika. 100 raamatukogu veel jäänud :D

meelisl commented 8 years ago

1) EHAK peaks nüüd kõikidele meie kogudel paigas olema päringutes 1 ja 2. 2) Lisasin ka TOP 100 päringu http://live.webriks.ee/egov/?query=3 Ilma lisaparameetriteta väljastatakse TOP 100 teavikut laenutuste arvu alusel kõikide kogude pealt.

Võimalikud lisaparameetrid;

Laenutuse kuupäevade vahemik from=2016-01-01&to=2016-08-23 Formaadis aaaa-kk-pp, kui kuupäeva formaat on vale, siis väljastatakse puhas TOP 100.

Näide: http://live.webriks.ee/egov/?query=3&from=2016-01-01&to=2016-08-23

EHAK kood http://live.webriks.ee/egov/?query=3&from=2016-01-01&to=2016-08-23&ehak=86

Komaga eraldatult võib ette anda mitu koodi ja suvalisel tasemel(maakond, vald jne),

Antud päringus grupeeritakse laenutuste arv ainult pealkirja, autori ja ISBN alusel. Kui võtta grupeeringusse lisaks ka ehak või raamatukogu nimetus, muutub TOP nimekiri hoopis teiseks :)

Esialgu siis nii. Kui on mõtteid või ettepanekuid, siis andke teada!

meelisl commented 8 years ago

Kõikidele päringutele lisatud EHAK filter. Võib kasutada mitut koodi komaga eraldatult. Näiteks: Raamatukogud, mis kasutavad RIKS tarkvara Põlva Maakonnas. http://live.webriks.ee/egov/?query=2&ehak=65

timotoots commented 8 years ago

Paremat ei oskaks tahtagi. Sellega saab juba palju teha. Aitäh!

meelisl commented 8 years ago

Kas kusagil näeb juba mingit tulemust ka nende andmetega, mida siin kõik kogutakse/päritakse? Alates spordiga ja lõpetades raamatukogudega? :)

timotoots commented 8 years ago

Hetkel veel mitte. Andmeid kasutav installatsioon avatakse detsembris uues ERMis. Virtuaalset demoversiooni jagame andmete valdajatega, siis kui see mõistlikus vormis töötab. Ma usun, et see juhtub septembris.

meelisl commented 8 years ago

Selge, ootan põnevusega!

meelisl commented 8 years ago

Väike täiendus veel. Päringule võib lisada parameetri/flltri "libtype", ehk siis raamatukogu tüüp. Komaga eraldatult saab lisada mitu tüüpi. Võimalikud väärtused on: 1 Rahvaraamatukogu 2 Kooliraamatukogu 3 Erialaraamatukogu 5 Kõrgkooliraamatukogu 6 Lasteaed

Näiteks: http://live.webriks.ee/egov/?query=1&libtype=6

andreskytt commented 8 years ago

Puhas rõõm. Timo, kas sellega tuleb midagi veel teha?

meelisl commented 8 years ago

Kui huvi on, võin lisada ka filtri lugeja soo ja vanusega. :)

meelisl commented 8 years ago

Ja lisatud veel kaks "filtrit"

gender - päringud 1 ja 3. Võimalikud väärtused m ja f

age - päringud 1 ja 3. Võimalikud väärtused n või n1-n2, ehk siis üksik vanus või vanusevahemik. http://live.webriks.ee/egov/?query=3&gender=m&age=33-40&libtype=1

Rohkem ei oska midagi enam lisada :)

timotoots commented 8 years ago

Sellest piisab täiesti! Aitäh!