Reittihärvelin ver. 3 tarvittavat osat ja työkalut:

* RG3.zip
- palvelimelle asennnettava osuus. php skripti. Pura zippi, kopioi palvelimelle. Avaa /admin/admin.php ja seuraa ohjeita.

Mikäli halutaan tavallisen 2D lisäksi myös 3D moodi, tarvitaan tämä: 
* https://routegadget.net/tee3D//
- 3D-mallin luontiohjelma tee3Dfinland.exe. Windows exe. Zipissä ohjeita.
- tarjolla kaksi versiota, toinen tee3Dfinland.exe on Suomeen (lataa laserkaileusaineistot automaattisesti) 
  ja toinen ulkomaille (joudut itse etsimään jostain laz tiedostot)

* https://3d.routegadget.net/
- sivu jolla voi avata paikallisia 3D-malleja ja varmistaa että ne on OK ennen nettiin lataamista.
- tätä ei tarvitse asentaa tai tehdä mitään, tätä sivua vain käytetään tapahtuman näyttämiseen 3D moodissa.

* https://2d.routegadget.net/
- kartta georefearointityökalu. Käytä sitä mikäli kartta ei ole georeferoitu.
- iof xml 3.0 ratasuunnitelmien georeferointi/muunnostyökalu gpx formaattiin.
- tätä ei tarvitse asentaa tai tehdä mitään, tätä sivua vain käytetään tapahtuman näyttämiseen 2D moodissa.

* Strava integraatio
- mikäli haluat että kilpailijat voivat ladata reittinsä nappia painamalla suoraan Stravasta, luo Stravaan 
oma tunnus ja sinne oma API aplikaatio (settings -> My API Application) ja poimi sieltä "app id" ja "secret" 
reittihärvelin config.php tiedostoon niille varattuihin kohtiin.

Tapahtuman julkaisu


Ennen kilpailua:

1 a) jos riittää vain 2D näkymä
- exporttaa Ocadista (tai OOMapperista tms) png + pgw karttakuva
- zippaa ne samaan zippiin.
- mikäli kartan projektio on TM35FIN (EPSG:3067) kuten Suomessa yleensä, kelpaa tämä zip sellaisenaan
- mikäli koordinatisto on jokin muu: nimeä zippi siten, että siinä on projektion EPSG koodn nimessä mukana 
  nimämistapa: _EPSG[nro]_.zip
  esimerkki:  kisakartta_EPSG3877_.zip
- näin nimetylle zipille reittihärveli osaa hakea muunnoskaavan, mikäli se löytyy https://epsg.io/ palvelusta

1 b) jos kartta on georeferoitu ja projekti on TM35FIN (EPSG:3067) ja halutaan myös 3D-näkymä

- exporttaa Ocadista (tai OOMapperista tms) png + pgw karttakuva rajattuna mahdollisimman pieneksi siten, 
  että mukana on vain tarvittava alue. 
- Kopio .png ja .pgw samaan hakemistot t3d.exe:n kanssa. Raahaa png tiedosto exe:n päälle ja 
  odota. Parissa minuutissa syntyy zip tiedosto, joka on 3D-malli (karttakuva ja maasto samassa zipissä ).
- mene 3d.routegadget.net ja avaa siellä zip tiedosto. Tarkista että 3D maailma on OK.

2) Jos karttaa ei ole georeferoitu mitenkään (ei missään koordinaaatistossa tai skannattu kartta)
- joudut manuaalisesti georeferoimaan kartan. Sen voi tehdä monella tavalla, alla selitetty kätevin tapa.
- exporttaa Ocadista png karttakuva rajattuna niin, että mukana on vain tarvittava alue.
- mene https://2d.routegadget.net/ ja asemoi png karttakuva. nimeä png sivun antamalla pitkällä nimellä
  (nimessä wgs84 nurkkakoordinaatit). Katso ohjeita https://youtu.be/vJbZoX0xVDY 
  Lyhyesti:  raahaa kartasta yksi kohta läheltä jotain nurkka paikalleen ja klikkaa ko kohdata kierron 
  keskipiste, sitten ota vastaisesta nurkasta kiinni ja kierrä kartta kohdalleen. Tarvittaessa toista.
- tällainen pitkäniminen kuvatiedosto ei tarvitse pgw aputiedostoa. Eli sen voi raahata tee3d.exe luontiohjelmaan
  tai zipata yksinään zipin sisälle ja käyttää reittihärvelin 2D moodissa.

3a) Ratatiedot jotka on georeferoitu
- exporttaa Ocad/Condes/PurplePen ratasuunnitelmat gpx muodossa. Tarvittessa nimeä radat /sarjat
  järkevästi, ne tulevat valintalistaan.
- vaihtoehtoisesti exportaa iof xml ver 3.0 radat.
- lisää tämä radat sisältävä gpx (tai xml) tekemääsi kartan jo sisältävään zip tiedostoon. Avaa se 
  taas 2d.routegadget.net sivulla ja tarkista että radat on ok. mikäli teit 3D mallin voit avata sen 
  myös 3d.routegadget.net sivulla ja näet miten radat istuvat 3D karttaan.

3b) Georeferoimattomat radat
- Mikäli kartta on tunnetussa koordinaatistossa mutta Ocad/OOM teidostossa koordinaatistoa 
  ei ole määritetty, voit käydä ocadissa määritämässä sen.
- Jos tuo ei onnistu, radat pitää georeferoida manuaalisesti. Exportaa radat IOF xml 3.0 muodossa
- mene 2d.routegadget.net ja avaa ensin kartan sisältävä zip ja sitten tuo iof xml 3.0 raahaamalla se "open files" laatikon päälle.
- asemoi rastit kohdalleen raahaamalla kahta vastakkaisissa kulmissa olevia rasteja. Tallenna gpx muodossa (painike).
- lisää tämä gpx-teidosto kartan sisältävään zippiin.  Avaa se taas 2d.routegadget.net tai 3d.routegadget.net ja 
  tarkista että radat on ok.


Kilpailun jälkeen:
- Mene asentamaasi hallintaosioon /admin/admin.php
- syötä kilpailun nimi
- valitse tekemäsi zip
- kilpailijalista syötetään tekstikenttään. Käytä jotain kolmesta lataustyökalusta työkalusta 
  (irma, rastilippu, navisport) tai xml tiedostoa (IOF3 tai Pirila) tai manuaalisesti lisää tekstikenttään 
  osanottajat riveittäin sarja;kilpailijanimi -muodossa. 
- voit myös jättää kilpailijakentän tyhjäksi. Tällöin valintalistan sijaan kysytään suunnistajan nimi reitin tallennuksen yhteydessä.
- paina nappia ja tapahtuma on julkaistu.