ITI0011:Säuts draft
Põhiosa
Lisaosa: Kohanimede puhverdamine faili (2p)
Kuna linnade/asukohtade koordinaadid ei ole ajas muutuvad, siis ei ole mõtet igal korral, kui kasutaja otsib "Tallinna" kohta säutse, uut koordinaatide päringut teha. Tulemus on väga suure tõenäosusega täpselt sama, mis eelmisel korral. Seoses sellega oleks mõistlik salvestada tulemused kuskilt puhvrisse (faili) ning neid hiljem sealt lugeda.
Selle lisaosa funktsionaalsus on:
- asukoha koordinaatide päringu tulemused salvestatakse faili, et järgmisel korral ei peaks neid uuesti küsima (kohalik cache)
- nimetatud faili saab lisada ise uusi asukohti (näiteks "kodu", "TTÜ" jne)
Puhverdamiseks kasuta vaikimisi faili "kohad.csv", mis peab olema sinu programmile kättesaadav (soovitavalt paikneb samas kataloogis käivitatava klassiga) ja peab koosnema CSV kujul ridadest:
ametlik_nimi,latitude,longitude,raadius_km,alternatiivnenimi_1,..,alternatiivnenimi_N
või ridadest, kus koordinaadid ja raadius on puudu:
ametlik_nimi,,,,alternatiivnenimi_1,...,alternatiivnenimi_N
kus
- ametlik_nimi on kohanimi, mida otsitakse API-st (näiteks
tallinn) - alternatiivnimi_1, ..., alternatiivnimi_N on nimed, mida kasutaja saab sisestada. Näiteks saab kasutaja siin määrata "kodu". Kui vastav päring tehakse, otsitakse tegelikult ametlik_nimi asukohta (või kasutatakse juba olemasoelvaid koordinaate ja raadiust, kui need on olemas) (näiteks
kodu,elupaik) - latitude, longitude ja raadius_km on standardse tähendusega. Need võivad puududa. (näiteks:
59.4,24.5,10)
Sinu programm kasutab puhvrifaili järgmiselt:
- Enne asukoha API poole pöördumist vaatab programm, kas vastav kohanimi on selles failis olemas
- Kui jah, ja koordinaadid-raadius on antud, kasutab ta koordinaate ja raadiust Twitteri päringu tegemiseks. Asukoha päringut ei tehta
- Kui jah, aga koordinaadid on puudu, siis
- teeb uue asukoha API päringu ametliku kohanime järgi, leiab koordinaadid ja arvutab raadiuse
- kirjutab saadud koordinaadid ja raadiuse vastava rea juurde. Järgmisel korral sama päringu puhul pole vaja asukoha API-t enam kasutada.
- Kui ei, siis tehakse uus päring ning puhverdatakse tulemused faili (kirjutatakse uus rida, kus on ametlik_nimi, koordinaadid ja raadius:
pärnu,58.3800572,24.5200466,5).
Näited:
1) kohad.csv:
tallinn,59.4,24.5,10,kodu,ttü
Kui tehakse otsing "tallinn", siis kasutatakse koordinaate 59.4 ja 24.5, raadius = 10km. Sama juhtub, kui teha päring "ttü", "kodu". kohad.csv fail ei muutu.
2) kohad.csv:
pärnu,,,,vanaema,suvila
Kui tehakse otsing "pärnu" või "vanaema" või "suvila", siis otsitakse asukoha API-ga üles "pärnu", loetakse välja koordinaadid ja arvutatakse välja raadius. Tulemuseks on sama rida failis:
pärnu,58.3,24.5,5,vanaema,suvila
3) kohad.csv:
tallinn,59.4,24.5,10,kodu,ttü
Kui tehakse otsing "pärnu", siis tehakse asukoha otsing "pärnu" ja salvestatakse koordinaadid ja raadius faili. Tulemuseks on fail:
tallinn,59.4,24.5,10,kodu,ttü
pärnu,58.3,24.5,5
4) kohad.csv
tallinn,59.4,24.5,10,kodu,pärnu
pärnu,58.3,24.5,5
Kui tehakse otsing "pärnu", siis kasutatakse infot teiselt realt. Ehk siis ametlik nimi on prioriteetsem kui alternatiivsed nimed. Kui sellist ametlikku nime ei leidu, otsitakse alternatiivsete nimede seast.
Faili sisu ei tohi olla tõstutundlik, ehk siis otsingud jm toimub case-insensitive printsiibil, kus suur- ja väiketäht on võrdsed ("Pärnu", "pärnu" ja "PÄRNU" on kõik samad).
Teie programmis mingeid muid operatsioone ei pea failiga tegema (näiteks kustuta rida või muuda vms). Faili muutmine toimub käsitsi. Samuti ei pea te otseselt tegelema valesti formaaditud failiga. Samas, kui tekib viga andmete lugemisel, ei tohiks see programmi kinni panna. Pigem kui cache'i ei suudega lugeda, siis arvestada olukorraga nagu cache puudub (kõik päringud tehakse veebist).
See lisaosa täielikult realiseerituna annab 2 punkti.