Vexline

Vexline on Viitekehysmuunnin-rajapinnan käyttöliittymä, jonka avulla voidaan suorittaa VKM-rajapintakutsuja CSV- tai XLSX-taulukon muodossa. Tulostiedoston saa vietyä suoraan paikkatieto-ohjelmistoon, jossa aineisto tai data näkyy kartalla. Vexline korvaa aikaisemmin käytössä olleet Tatun ja VKM-Excelin.

Vexline tekee muunnoksen tiedoston otsikkoriviltä löytyvien VKM-hakuparametrien avulla, jotka voivat olla missä tahansa järjestyksessä ja kombinaatiossa. Hakurivien muut sarakkeet säilytetään muuttumattomina ja liitetään myöhemmin vastaaviin tulosriveihin. Tiedoston muunnos voi epäonnistua kokonaan tai osittain, mikäli hakuparametrit eivät ole VKM:n ohjeiden mukaisia tai niiden arvoja ei pysty muuntaa.

Pääset helpoimmin alkuun valitsemalla jonkin alla esitellyistä yleisesti käytetyistä muunninesimerkeistä. Halutessasi voit myös valita itse manuaalisen syöttötavan, jossa kaikki muunnokset ovat käytettävissäsi. Muunnettavan tiedoston maksimi rivilukumäärä on toistaiseksi 50 000, ja Vexlinen käyttämä koordinaattijärjestelmä on ETRS89/TM35FIN(E,N). Tieverkon päivämäärä: 1.1.2026.

1. Valitse muunnoksen palautusarvot.

Palautusarvot määrittävät muunnoksen viitekehykset, kuten tieosoite, koordinaatit ja geometria, joissa muunnettu paikkatietodata esitetään.

Lisätietoa ajoradoista:

Ajoratatietoa ei tarvitse määrittää muunnostiedostossa, ellei halua muunnosten kohdistuvan juuri tiettyihin ajoratoihin, tai muunnettava tiedosto muuten sisältää ajoratakohtaisia kohteita. Jos tiedostossa ei ole ajorata-kenttää eli muunnettavien kohteiden ajoratatietoja ei ole määritetty, mutta kohteiden sijainnit osuvat moniajorataisiin tieosuuksiin, Vexline kohdistaa kohteet oikeille ajoradoille. Eli esim. yhdestä hakurivistä voi syntyä useampi tulosrivi, mikäli kohteen sijainti osuu kaksiajorataiselle tieosuudelle.

Lisätietoa väylän luonteesta:

Väylän luonne on ajoratatiedon tapaan valinnainen ns. tarkentava VKM-parametri, jolla voidaan rajata muunnokset tiettyihin tienumeroihin. Esim. vaylan_luonne = 1 sisältää tienumerot 1–19 999 eli maantiet ja vaylan_luonne = 7 taas kevyen liikenteen väylät 70 000–99 999. Se on hyödyllinen etenkin koordinaatti–tieosoite-muunnoksessa, jossa annetulle koordinaattipisteelle haetaan lähin tieosoite 100 metrin säteeltä. Luettelo vaylan_luonne-parametrin eri arvoista löytyy Viitekehysmuuntimen rajapintakuvauksesta, (PDF-tiedoston) sivuilta 31–32.

Palautusarvot:

Erilliset ohjeet GeoPackagen vientiin QGIS-ohjelmaan.

Tarkentavat ja rajaavat parametrit (Ylikirjoittavat tiedoston samannimiset VKM-kentät ja ovat täysin valinnaisia.):

2. Lähetä tiedosto muunnettavaksi

Vaatimukset:

Tiedoston nimessä ei saa olla skandeja (Å, Ä ja Ö)

CSV-tiedoston erotimerkin on oltava ";" (puolipiste).

Sarake, jonka nimessä on "pvm" ja sisältää "dd.mm.yyyy"-muotoisia päivämääriä, muutetaan "datetime"-tyypiksi, jos tulostiedoston formaatiksi on valittu GeoPackage.

Muunnettavan tiedoston tieosoitekenttien tulee seurata Velhon, Tierekisterin tai/ja Viitekehysmuuntimen tieosoitesyntaksia. Tieosoiteparametreja (={tie/tienumero}, {aosa/alkuosa/osa}, {ajr/ajoratanumero/ajorata}, {aet/alkuetaisyys/etaisyys}, {losa/loppuosa/osa_loppu}...) voi sekoittaa keskenään, eikä kirjainten koolla ole merkitystä. Esim. Tienumero, AOSA, alkuetaisyys, osa_loppu, Let. Parametrien ei tarvitse olla tietyissä paikoissa tai järjestyksessä ja niitä voi yhdistellä vapaasti.

Aiemmin mainittujen tieosoitekenttien ja muiden muunnosparametrien lisäksi muunnettava aineisto voi sisältää vapaamuotoisia kenttiä, joiden nimiä, formaattia tai arvoja ei sovelluksessa rajoiteta. Nämä kentät prosessi säilyttää muuttumattomina ja liittää myöhemmin vastaaviin tulosriveihin.

Lataa halutessasi esimerkkitiedosto, josta voi ottaa mallia. Tiedostot sisältävät eri parametrien käyttötarkoituksia tarkentavia kommentteja. Esimerkkitiedostoja ei tarvitse käyttää tiedostopohjina vaan muunnoksen tekemiseen voi käyttää omaa tiedostoa, jossa voi olla erilaisia VKM-parametrien ja muunnettavien kohteiden lisäominaisuuksien kombinaatioita. Esim. Lisäominaisuus1, tie, Lisäominaisuus2, etaisyys, osa, ajorata.

CSV on suositelluin tiedostomuoto Vexlinelle syötettäväksi, jos käyttää aineiston käsittelyyn muita sovelluksia kuin Excel.

Kuvia esimerkkitiedostoista. Vihreällä värillä on merkattu tieosoitemuunnokseen vaikuttavat kentät, sinisellä käyttäjän lisäämät vapaamuotoiset kentät:

2. Lähetä tiedosto muunnettavaksi

4. Jatkokäsittelyohjeet

Vexline muunnoksia voi hyödyntää myös QGIS:sissa:

• 1. Suorita CSV- tai XLSX-taulukon muunnos ja talleta tulostiedosto.
• 2. Avaa QGIS ja valitse sopiva projekti.
• 3. CSV: Avaa tietolähteiden hallinta ja valitse Eroteltu teksti. GPKG: Valitse GeoPackage.
• 4. Valitse tulostiedosto (.csv tai .gpkg) tiedoston nimeksi ja valitse muunnetuille csv-tiedoille sopivat asetukset.
• 5. Paina lisää ja tietojen pitäisi ilmestyä projektiin.