UMap

Sissejuhatus

uMap on veebikeskkond, mis võimaldab huvipunktide kogumist tiimis sarnaselt Facilmap keskkonnaga. Tegemist on hea vahendiga, mida kasutada näiteks ees ootava matka planeerimisel. Ühe peamine eelisena Facilmap keskkonna ees võib välja tuua, et igat huvipunktide või rajajoonte kategooriat saab lihtsa klikiga ükshaaval sisse-välja lülitada. Erinevalt Facilmap'ist ei ole uMap korral seega vaja administraatoril eelnevalt filtreid defineerida ning hilisemal kasutamisel on oluliselt lihtsam saada ekraanile just endale hetkel meelepärased objektid ja rajad.

2018. aastal kasutame uMap keskkonda Tipikate Rattamatka jaoks eelinfo kogumiseks!

Kaardi vaatamine

Sissejuhatus

Kaardi avamiseks on vaja teada tema linki. Tipikate Rattamatka eelinfo kogumiseks jagame linki korraldajate listis (korraldajad [ät] rattamatkaklubi.ee). Näide kaardist:

Kuvatavate kategooriate valimine

Vajuta vasakus servas oleval "torni kujutisega" nupul:

Avaneb menüü, kus on näha kaardiobjektide kategooriad. Lihtsamas versioonis on juba sellest menüüst võimalik kaardiobjekte kategooriate kaupa sisse-välja lülitada, kasutades selleks "silma" kujutisega ikoone (joonis 1). Parema ülevaate andmetest saab, kui vajutada "Browse data" (joonis 2):

"Browse data" avab ekraani paremas servas uue vaate, kus on näha kõik kategooriad, rajad ja huvipunktid. Ka sealt on "silma" kujutisega ikooni vahendusel võimalik kategooriaid kuvamiseks sisse-välja lülitada. Üleval ääres oleva "About" nupu abil saab valida, kas kasutaja soovib nimekirjana näha kõiki kaardiobjekte või ainult kategooriate nimetusi:

Huvipunktide lisamine

NB! Kui teemaks on Tipikate Rattamatka tarbeks info kogumine, siis teatavate kategooriate puhul (nt ööbimispaigad) on oluline, et kõik kaardile lisatud ööbimiskohad saaksid lisatud ka Google Spreadsheet tabelisse! Samas kui muudest huvipunktidest rääkida, siis iga kivi ja muistise jaoks (vähemalt esialgu) samasugust distsipliini hoida pole vaja.

uMap kaart avaneb vaikimisi read-only režiimis. Kui on soov kaardile objekte lisada, tuleb esmalt redigeerimise režiim lubada. Selleks on üleval paremas servas nupp:

Peale nimetatud nupu vajutamist tekib paremale serva juurde redigeerimise menüü. Tavakasutaja jaoks võiks sealt vajalik olla ainult kõige ülemine nupp ("Draw a marker"). Tasub ka mainida, et kõige alumist nuppu ei tasu puutuda - vastasel juhul hangub kaart minutiks-paariks (tagamaadest võib soovi korral lugeda siit).

Suurenda-liiguta kaart sellisesse asendisse, et sinu poolt soovitud asukoht oleks hästi näha. Seejärel vajuta nuppu "Draw a marker" ning kliki kaardil soovitud asukohas. Pane tähele, et uue objekti ikoon (ehk kategooria) ei pruugi esialgu õige olla! Objekti kaardile klikkimisel avaneb parempoolne menüü, kust tuleks seejärel:

• Valida objektile õige kategooria ("Ööbimiskohad", "Poed ja toitlustus" või "Muud huvipunktid").
• Valida objektile mõistlik nimi.
• Vajutada nuppu "Save".

• TEHTUD!

Objekti kustutamine

Objekti kustutamiseks peab olema eelnevalt lubatud redigeerimise režiim, nii nagu objekti lisamise korralgi. Kustutamiseks kliki objekti peal ning vajuta avanenud prügikasti ikoonil:

Peale seda tuleb kaart ka ülevalt paremast nurgast Save nupu abil ära salvestada.

Taustakaardi valik

uMap võimaldab taustakaarti valida päris paljude hulgast, meid võiks rohkem huvitada "OSM hikebikemap" ja "OpenStreetMap". Neist esimene oleks ehk kõige teemakohasem, aga kuna on selgunud, et nende server on aeg-ajalt liiga ülekoormatud, siis võib kasulikuks osutuda teise kasutamine. Taustakaardi valimiseks tuleb esmalt minna redigeerimise režiimi, nii nagu seletatud ülalpool. Seejärel ilmub kaardi paremasse serva menüünuppude tulp, kus olemas ka "Change tilelayers" nimeline nupp. NB! Peale "Save" nupu vajutamist salvestub uus valik ära kõigi kaardi kasutajate jaoks, seega palun veenduge, et teie töö lõpuks ikkagi mingi mõistlik taustakaart alles jääks!

Muu info

Sissejuhatus

NB! Alates siit peatükist ei ole info oluline tavakasutajale, vaid administraatorile ja kaardi omanikule!

Kaardi privaatsus

Anonüümselt loodud kaart

On selgunud, et vaikimisi (anonüümselt) kaarte luues ei ole https://umap.openstreetmap.fr keskkonnas võimalik tekitada privaatset kaarti. On küll võimalik piirata kaardi redigeerimist, aga mitte vaatamist. Loodud kaardid tulevad välja keskkonna enda otsinguga, samuti indekseeris Google selle ära. Kui esialgu tundus, et Google poolt indekseeritud link andis lausa täielikud redigeerimisõigused, siis see ei leidnud siiski kinnitust - taoline õigus tekkis tänu eelnevalt paigaldatud küpsisele.

Kaardi esmakordsel salvestamisel näidatakse kasutajale linki, mille abil kaarti hiljem muuta saab. Privaatsuse tagamiseks on seal kaks erinevat osa:

• Kuuekohaline number, mis sisaldub ka avaliku vaatamise lingis (ning mille Google ära indekseeris).
• 27-kohaline tähtede ja numbrite kombinatsioon - seda sisaldav link annab kaardile täielikud õigused. Lingi avamisel paigutatakse arvutisse küpsis ning suunatakse kasutaja lühema, ainult 6-kohalist numbrit sisaldava lingi peale. Seeläbi võibki konkreetne kasutaja edaspidi ka lühemat linki (sh Googlest leitud) redigeerimiseks kasutada - seni kuni küpsis alles on.

Privaatsususe seadetele saab ligi läbi paremas servas oleva redigeerimise menüü, vajalik on klikkuda kõige alumisel "võtme ikooniga" nupul. Avanevas paneelis on hüpikmenüü, kus valikuvariantideks Everyone can edit ja Only editable with secret edit link. Neist esimene annab täielikud õigused kõigile, kes avalikku linki teavad (ja see tuleb otsingust välja), teine nõuab kaardi muutmiseks (vähemalt esimesel korral, kui küpsist veel pole) pikka ja keerulist linki. Avanenud paneelil on näha ka see salajane link, mida kaardi loomisel (esmasel salvestamisel) juba kuvati.

Nagu eespool öeldud, siis kaardi vaatamist anonüümselt loodud kaardil ära keelata ei saa.

Ühe huvitava omapärana tasub veel mainida, et inimesel, kes teab anonüümse kaardi redigeerimise linki, on võimalik peale sisse logimist see kaart ka "ära omada" ning õigused miinimumi keerata. Pigem tundus isegi, et see käitumine oli üsna automaatne, kui sisselogitud kasutajana kaardi salajane link avatud sai.

Kasutajakonto alt loodud kaart

https://umap.openstreetmap.fr keskkond lubab sisse logida läbi GitHub, BitBucket, Twitter või OpenStreetMap konto. 2018. aasta märtsis sai kaart loodud läbi GitHub keskkonna sisse logides. Tasub mainida, et sisse logimine tuli teha nii, et http://umap.openstreetmap.fr keskkonda kasutatakse ilma HTTPS-ita - vastasel juhul ei toiminud. Hiljem on kaarti võimalik kasutada ka läbi HTTPS-i.

Kaardi õiguste seadistamiseks tuleb ka praegusel juhul kasutada "võtme ikooniga" nuppu paremal redigeerimise menüüs. Tasub mainida, et see on mõneti problemaatiline - nimelt hangub veebileht peale nupu vajutamist 1-2 minutiks. Tundub, et see on seotud kuidagi avanevas paneelis oleva Editors lahtriga, kuhu keskkond üritab eelpool nimetatud sotsiaalkeskkondadest hiiglama palju kasutajanimesid laadida, et oskaks trükkimisel jooksvalt soovitusi jagada. Kokkuvõttes võib öelda, et Editors funktsionaalsuse kasutamine on problemaatiline kahel põhjusel:

• Kas kõigil kaardihuvilistel on vajalik konto olemas? Kas kõik redigeerijad on ette teada?
• Editors välja puudutamine laseb veebilehe pikaks ajaks pange.

Seega jätame meie Editors välja rahule ning lahendame asja teisel viisil:

• Edit status rippmenüüst on võimalik valida kolme variandi vahel: Everyone can edit, Only editors can edit ja Only owner can edit. Meie peame siit valima esimese variandi, sest teine ei toimi ja kolmas ei lubaks kellelgi peale kaardi looja seda muuta.
• Share status rippmenüüst on võimalik valida kolme variandi vahel: everyone (public), anyone with link ja editors only. Meie valime anyone with link. See valik tagab, et https://umap.openstreetmap.fr keskkond ei jaga kaardi linki välja ei enda otsingus ega teistele otsimootoritele. See omakorda tagab, et kaarti ei saa ilma linki teadmata ka muuta - raske on muuta asja, mille olemasolust sul aimugi pole :)

Tasub mainida, et kasutajakonto alt loodud kaartide puhul ei kasutata lingis pikka ja keerulist 27-kohalist identifikaatorit, vaid ainult 6-kohalist numbrit. Samas sisaldab kasutajakonto alt loodud kaart mingil kujul ka kaardi nime, seega kokkuvõttes ei ole kogu linki lihtsalt ära arvata siiski võimalik.

Ja tasub siis veelkord rõhutada, et:

• Ilma vajaduseta ära "võtme ikooni" puutu - leht hangub mõneks ajaks.
• Kui siiski pead teda puutuma, siis ära Editors välja näpi - hangub veel pikemaks ajaks.

Nimetatud hangumise probleem puudutab ainult kaarte, mis on loodud sisse logitud kasutaja poolt. Anonüümse autori kaardi korral Editors välja ei ole ning hangumist ei toimu.

Muud tähelepanekud

• Kui laadida kaardile pikem rajalogi, millel väga palju punkte, siis sellega majandamine on aeglane. Kaart hangub selle menetlemise ajaks. Selliste rajalogide puhul tasub punktide hulk eelnevalt mõistlikule tasemele viia.
• Kaardi andmete eksport käib vasakul olevast nupust "Embed and share this map". Võimalik on laadida alla nii kategooriate kaupa kui mitu kategooriat GPX-ina, KML-ina või GeoJSON-ina või siis teha kogu kaardi varukoopia uMap enda formaadis.
• Olemas on ka kaardi kustutamise, kloonimise ja tühjendamise valikud. Nendeni jõuab, kui valida paremal olevast redigeerimise menüüst nupp "Edit map settings" ning seejärel avanenud paneelist "Advanced actions".
• Väidetavalt peaks kaardile saama ka fotosid lisada, kasutades selleks välist linki. Tasub järgi proovida.

Paigaldamine oma serverisse

Sissejuhatus

Kuna esialgu tundus, et privaatset kaarti on võimalik luua ainult uMap keskkonda endale paigaldades, siis sai 2018. aasta märtsis proovitud seda teha. Keskkond sai prooviks paigaldatud Ubuntu 16 virtuaalmasina peale. Peamiselt aitasid selle juures see ja see juhend, kuid kumbki neist polnud päris üks-ühele järgitav.

Algne paigaldamine

sudo apt-get install python3.5 python3.5-dev python-virtualenv wget
sudo apt-get install nginx uwsgi uwsgi-plugin-python3 postgresql-9.5
sudo apt-get install postgresql-9.5-postgis-2.2 git
sudo apt-get install postgresql python-psycopg2 libpq-dev
sudo mkdir -p /srv/umap
sudo mkdir -p /etc/umap
sudo useradd -N umap -d /srv/umap/
sudo chown umap:users /etc/umap
sudo chown umap:users /srv/umap
sudo -u postgres createuser umap
sudo -u postgres createdb umap -O umap
sudo -u postgres psql umap -c "CREATE EXTENSION postgis"
sudo -u umap -i
virtualenv /srv/umap/venv --python=/usr/bin/python3.5
/bin/bash
source /srv/umap/venv/bin/activate
pip install umap-project
wget https://raw.githubusercontent.com/umap-project/umap/master/umap/settings/local.py.sample -O /etc/umap/umap.conf
export UMAP_SETTINGS=/etc/umap/umap.conf

Seadistamine

/etc/umap/umap.conf failis tuleks paika seada järgnev:

• Panna "SECRET_KEY" väljale mingi pikk suvaline joru.
• STATIC_ROOT = '/srv/umap/var/static'
• MEDIA_ROOT = '/srv/umap/var/data'
• UMAP_DEMO_SITE = False
• Teoreetilislt tuleks reaalses lahenduses panna "DEBUG = False". Seniste testide baasilt on sellega mingi probleem - avalehel näidati ainult tekste ilma graafikata ja kaarti polnud üldse näha.
• Kui soovi on, võib LEAFLET_LONGITUDE, LEAFLET_LATITUDE ja LEAFLET_ZOOM abil vaikimisi vaate paika panna.
• Vaikimisi SITE_URL on "http://localhost:8019". Näide serveri käivitamise käsust on aga umap runserver 0.0.0.0:8000. Pole hetkel teada, mida need erinevad pordid teevad, aga tundub et kuidagi nii peabki olema.

Paigaldamise jätk

Paigaldamist tuleks jätkata, olles sisse logitud kasutaja umap-ina ja virtualenv keskkonnas. Kui vahepeal on terminalist väljutud, tuleb anda uuesti käsk source /srv/umap/venv/bin/activate (ja vajadusel eelnevalt /bin/bash käivitada).

umap migrate
umap collectstatic
umap storagei18n
umap createsuperuser

Seejärel võib serveri käivitada:

umap runserver 0.0.0.0:8000

Ja külastada veebilehte http://localhost:8000

Administreerimisliides asub http://localhost:8000/admin (saab sisse logida eelnevalt seadistatud superuser kasutajanime ja parooliga).

Järgi proovimata jäi see, mida annab juurde Ubuntu juhendi sektsioonis Configure the HTTP API toodud seadistamine.