Hyppää pääsisältöön

Suomi.fi-kartat

Suomi.fi-kartat-palvelussa (ent. Hallinnon karttapalvelu) voit luoda kartan ja julkaista sen omilla verkkosivuillasi.

Taustakarttoina voi käyttää Maanmittauslaitoksen avoimia aineistoja: erilaisia maasto- ja taustakarttoja, kiinteistörajoja sekä ilmakuvia. Voit myös liittää palveluun omia rajapintojasi tai lisätä kartalle omia kohteita julkaistavaksi.

Palvelu on tarkoitettu julkishallinnon viranomaisille sekä sopimuksella julkista tehtävää hoitaville organisaatioille.

Gispo Oy järjestää koulutusta palvelusta

Tutustu esittelyvideoon (12 min.)

Suomi.fi-kartat -palvelussa voit koota omia karttanäkymiä palvelussa valmiina olevista karttatasoista sekä omista kohteistasi ja oman organisaatiosi rajapinnalla olevista aineistoista. Voit julkaista laatimasi karttanäkymät organisaatiosi verkkosivuilla.

Palvelun käyttö ei edellytä ohjelmointitaitoja. Riittää, että määrittelet palvelussa haluamasi karttanäkymän, kuten koon ja näytettävät karttatasot sekä valitset käytettävät karttatyökalut ja -toiminnot.

Palvelu luo muutaman rivin html-koodia. Liitä se verkkosivulle, jossa haluat karttapalvelun tarjota.

Muokkaa kartta tarpeen mukaan

Voit valita karttaikkunan koon valmiista kokovaihtoehdoista tai määrittää haluamasi koon pikseleinä. Myös julkaistavan kartan ulkoasua voi muokata. Voit valita valmiista väriehdotuksista tai määritellä omat värit. Teksteille on kaksi eri kirjasintyyppiä, ja työkalujen tyylin voit valita joukosta vaihtoehtoja.

Julkaistavaan karttaan valittavissa olevat toiminnot ja työkalut:

  • liikkumisnuolet (panorointitoiminto)
  • osoite-, paikannimi- ja kiinteistötunnushaku
  • karttatyökalut (siirry edelliseen/seuraavaan näkymään, matkan mittaus, pinta-alan mittaus)
  • karttanäkymän siirtäminen
  • käyttäjän sijaintiin keskittäminen
  • koordinaattityökalu.

Käytettävissä olevat karttatasot

Kartat-palvelussa on käytössä seuraavat Maanmittauslaitoksen avoimet aineistot:

  • ortoilmakuva
  • maastokartta
  • taustakartta
  • kiinteistörekisterikartta.

Karttoja on mittakaavoissa 1:2000 - 1:8 milj.

Omien rajapintojen kytkeminen

Palveluun voidaan kytkeä asiakkaan omia WMS-, WMTS- tai WFS-rajapintoja. Rajapinnat voivat olla vain omaan käyttöön tai kaikille Suomi.fi-kartat-palvelun käyttäjille.

Kun haluat rajapinnan kytkettäväksi palveluun, ota yhteyttä sovellustukeen, sovellustuki[ät]maanmittauslaitos.fi.

Ilmoita viestissäsi seuraavat tiedot

  • käyttöoikeustieto (avataanko rajapinta omaan käyttöön vai kaikille Suomi.fi-kartat-palvelun käyttäjille)
  • rajapintapalvelun osoite
  • mahdollinen käyttäjätunnus/salasana
  • lisättävät karttatasot (jos rajapintapalvelu sisältää on useita karttatasoja/tuotteita, lisätäänkö kaikki vai yksittäisiä tasoja)
  • WMS-palveluissa jokaisen tason osalta tieto, otetaanko käyttöön kohdetietojen kysely (GetFeatureInfo).

Kerro myös

  • käyttöliittymässä näytettävät karttatasojen nimet (suomi/ruotsi/englanti)
  • Paikkatietohakemiston aineistotunniste (eli Paikkatietohakemistossa aineistolle annettu yksilöivä tunniste).

Huomioithan palvelun rajoitukset: Rajapinnan toimivuutta ei pystytä varmuudella takaamaan. Erityisesti WFS-rajapinnan toimivuus saattaa olla puutteellista.

RPC-rajapinta Sovelluskehittäjille

Sovelluskehittäjät voivat hyödyntää Suomi.fi-kartat-palvelun karttakomponenttia myös ns. RPC (remote procedure call) -ohjelmointirajapinnan kautta. Sen avulla karttapalvelussa määritellyn kartan toimintoja voi räätälöidä palvelun omaa karttajulkaisutoimintoa monipuolisemmin.

RPC-rajapinta mahdollistaa kartan hyödyntämisen osana asiointipalvelua. Sen avulla voi välittää asiointiin liittyvää tietoa karttakäyttöliittymään, esimerkiksi piirtää asiointitilanteeseen liittyvät kohteet kartalle tai poimia käyttäjän kartalta osoittamat kohteet asiointisovellukseen. RPC-rajapinnan hyödyntäminen on helppoa eikä sovellukseen tarvitse tehdä erillistä karttatoteutusta.

RPC-rajapinta tarjoaa karttapalvelun perustoiminnallisuuksien lisäksi muun muassa HSL:n Avoimeen reittioppaaseen perustuvan valtakunnallisen reittihaun. Kesään mennessä on tulossa tuki Open311-palauterajapinnalle sekä teemakarttojen esittämiseen.

RPC-rajapinnan toiminnot

Rajapinta tarjoaa toiminnot kartan käsittelyyn ja kohdetietojen esittämiseen, omien merkintöjen tekemiseen, paikannukseen ja reititykseen.

Kartan käsittely

  • kartan ”bounding boxin” eli sijaintia rajaavan suorakaiteen kysely
  • kartan mittakaavan vaihtaminen, mittakaavatasojen määrän kysely
  • karttatason läpinäkyvyyden säätö
  • karttatasojen vaihtaminen upotettuun karttaan määriteltyjen karttatasojen välillä
  • kartan tilan kysyminen
  • kartan tallennetun tilan palauttaminen
  • kartan palauttaminen alkutilaan
  • kohdetietoikkunan avaaminen kartalle
  • vektorikohteiden kysely kartalta
  • kartan keskittäminen kartalle piirrettyyn kohteeseen
  • mahdollisuus näyttää kartalla ns. progress spinner, jos jokin haku kestää pidempään
  • funktiot, joiden avulla on haettavissa tarvittavat tiedot kartan käytön seurantaan.

Koordinaatit ja paikannus

  • koordinaattien poimiminen kartalta
  • kartan keskittäminen koordinaatteihin
  • kartan keskittäminen osoitteeseen
  • käyttäjän sijainnin kysyminen (paikannus)
  • Karttamerkintöjen tekeminen
  • käyttäjän omien karttamerkintöjen piirtäminen kartalle
  • vektorikohteiden (piste, alue, viiva) piirtäminen kartalle.

Reititys

  • reitin haku koordinaattipisteestä / osoitteesta toiseen ja näyttäminen kartalla
  • reitin kulkumoodin valinta (bussi, juna, auto, kävely, pyörä, jne.).

Lisätietoa RPC-rajapinnasta Oskari.org-sivustolla.

Suomi.kartat-palvelun käyttöoikeus kaikilla julkishallinnon viranomaisilla sekä sopimuksella julkista tehtävää hoitavilla organisaatioilla. Esimerkiksi valtion virastot, kunnat, kuntien yhteistyöelimet ja yliopistot ovat tällaisia organisaatioita. Palvelua eivät voi käyttää yksityiset yhteisöt, säätiöt tai elinkeinonharjoittajat.

Suomi.fi-kartat (KaPA-laissa Hallinnon karttapalvelu) on KaPA-lain 3.1 § 9 kohdassa määritelty yhdeksi yhteisistä sähköisen asioinnin tukipalveluista.

Palveluun kirjaudutaan tunnuksella ja salasanalla. Palvelun käyttöehdot (LINKKI) on hyväksyttävä ennen käyttöönottoa.

Suomi.fi-kartat-palvelun tilauslomake

Lisätietoja: Teija Tarvainen, p. 040 778 7391 tai Tatu Roitto, p. 040 083 4558, sähköposti etunimi.sukunimi[at]maanmittauslaitos.fi sekä verkkopalvelut[at]maanmittauslaitos.fi.

Kartat julkaisevan viranomaisen on hyväksyttävä Suomi.fi-kartat-palvelun käyttöehdot.

Suomi.fi-kartat-palvelun avulla julkaistavaan karttapalveluun sovelletaan julkaistun karttapalvelun käyttöehtoja. Julkaisija vastaa siitä, että julkaistun karttapalvelun käyttäjät sitoutuvat noudattamaan näitä ehtoja.

Suomi.fi-kartat-palvelun käyttöehdot

Suomi.fi-kartat (laissa Hallinnon karttapalvelu, jäljempänä ”HKP”) on hallinnon yhteisistä sähköisen asioinnin tukipalveluista annetun lain (571/2016, jäljempänä ”KaPA-laki”) 3 §:n1 momentin 9 kohdassa tarkoitettu sähköisen asioinnin tukipalvelu.

Maanmittauslaitos (jäljempänä ”MML”) vastaa HKP:n tuottamisesta ja kehittämisestä KaPA-lain 4 §:n 3 momentin nojalla.

HKP:tä voivat käyttää kaikki KaPA-lain 5 §:ssä tarkoitetut julkisen hallinnon viranomaiset ja muut julkista tehtävää hoitavat tahot säännöksessä säädetyin edellytyksin.

HKP:tä käyttävän viranomaisen tai muun vastaavan tahon tulee lukea huolellisesti nämä käyttöehdot. Käyttämällä HKP:tä HKP:n käyttäjä hyväksyy nämä käyttöehdot itseään sitoviksi.

1. Palvelun osapuolet

Näissä käyttöehdoissa osapuolista käytetään seuraavia nimityksiä:

  • HKP:n "Ylläpitäjä" on MML
  • "Julkaisija" on HKP:n avulla karttapalvelun julkaiseva viranomainen tai muu julkista tehtävää hoitava taho
  • "Käyttäjä" on viranomaisen tai muun julkista tehtävää hoitavan tahon julkaisemaa karttapalvelua käyttävä luonnollinen henkilö tai oikeushenkilö
  • "Tiedontuottaja" on HKP:n rajapintoja tarjoava taho

2. Palvelun sisältö

HKP:n avulla Julkaisija voi toteuttaa omille verkkosivuilleen karttapalvelun, jonka toiminnot ja kartat Julkaisija on valinnut HKP:ssä tarjolla olevista vaihtoehdoista.

Julkaisija voi ottaa HKP:ssä käyttöön omia rajapintapalveluitaan ja lisätä HKP:n työkaluilla kohteita (pisteitä, viivoja tai alueita ja niille ominaisuustietoja) sekä ladata kohteita tallentamalla tiedoston HKP:n tietokantaan.

Julkaisija voi antaa rajapintapalvelunsa HKP:n kautta muille HKP:n Julkaisijoille niiden palveluissa käytettäviksi. HKP:n Julkaisijoille tarkoitettujen rajapintapalveluiden käytön on oltava maksutonta.

Julkaisija liittää HKP:n verkkosivuilleen kopioimalla HKP:stä verkkosivuille tarvittavan kooditekstin.

Julkaisija voi hyödyntää HKP:n karttakomponenttia myös niin kutsutun RPC (remote procedure call) -ohjelmointirajapinnan kautta. RPC-ohjelmointirajapinnan avulla HKP:ssä määritellyn kartan toiminnot on mahdollista räätälöidä. RPC-ohjelmointirajapinta tarjoaa toiminnot kartan käsittelyyn ja kohdetietojen esittämiseen, omien merkintöjen tekemiseen, paikannukseen ja reititykseen.

Tarkemmin palvelun sisältö ja ylläpito on kuvattu HKP:n palvelukuvauksessa (pdf).

3. Palvelun käyttö

Julkaisija voi käyttää HKP:tä ja HKP:hen sisältyviä aineistoja näiden käyttöehtojen ja lain mahdollistamalla tavalla. HKP:n ja HKP:hen sisältyvien aineistojen käyttö on maksutonta.

Julkaisijan HKP:n avulla julkaisemaan karttapalveluun sovelletaan erillisiä karttapalvelun käyttöehtoja. Julkaisija vastaa siitä, että Julkaisijan HKP:n avulla julkaiseman karttapalvelun Käyttäjät sitoutuvat noudattamaan karttapalvelun käyttöehtoja ennen karttapalvelun käyttämistä.

HKP:ssä ei käsitellä eikä Julkaisija saa HKP:hen siirtää viranomaisten toiminnan julkisuudesta annetun lain (621/1999) tai muun lain nojalla salassa pidettäviä tietoja. RPC-ohjelmointirajapinnan avulla HKP:ssä määritellyllä kartalla voi näyttää kohteita Julkaisijan omasta tietojärjestelmästä, joita ei siirretä HKP:hen. Salassa pidettävien tietojen siirtämistä koskeva kielto ei koske näitä kohteita.

4. Vastuu palvelusta

MML vastaa HKP:n laadusta ja tietoturvallisuudesta siten kuin KaPA-lain 16, 17 ja 18 §:ssä säädetään. MML ei vastaa HKP:n toimimisesta Julkaisijan järjestelmä- tai laiteympäristöissä.

MML ei vastaa HKP:hen sisältyviin aineistoihin mahdollisesti sisältyvistä virheistä tai puutteista. MML korjaa MML:n aineistoissa todetun virheen tai puutteen kohtuullisessa ajassa asianomaisen virheen tai puutteen ilmaannuttua. MML ei vastaa Julkaisijoiden HKP:ssä tarjoamista aineistoista eikä HKP:n palvelukuvaus koske niitä.

MML varaa oikeuden muuttaa HKP.tä, HKP:hen sisältyviä aineistoja tai näitä käyttöehtoja tai rajoittaa HKP:n käyttämistä. Muutoksista pyritään tiedottamaan HKP:n verkkosivuilla ennen muutosten toteuttamista. Muutokset astuvat voimaan heti, kun ne on toteutettu.

MML ei vastaa HKP:n tai HKP:hen sisältyvien aineistojen käytöstä tai käytön estymisestä Julkaisijalle tai muulle osapuolelle aiheutuvista välittömistä tai välillisistä vahingoista ellei laista muuta johdu.

Julkaisija vastaa HKP:hen liittämäänsä tietojärjestelmään kohdistuvan häiriön tai uhkan tai sen päättymisen ilmoittamisesta MML:lle siten kuin KaPA-lain 18 §:n 3 momentissa säädetään.

5. Immateriaalioikeudet

MML:lla on tekijänoikeudet ja muut immateriaalioikeudet HKP:hen sisältyviin ortoilmakuva-, taustakartta- ja maastokartta-aineistoihin. MML:lla ja kiinteistörekisteriä ylläpitävillä kunnilla on tekijänoikeudet ja muut immateriaalioikeudet HKP:hen sisältyviin kiinteistötietoaineistoihin. Muilla HKP:ssä aineistojaan tarjoavilla Tiedontuottajilla on tekijänoikeudet ja muut immateriaalioikeudet omiin aineistoihinsa.  

Edellä selostetut tekijänoikeudet ja muut immateriaalioikeudet kuuluvat niiden haltijoille eivätkä ne siirry Julkaisijalle HKP:n käytön seurauksena. HKP:hen sisältyvien aineistojen käytön yhteydessä Julkaisijan on mainittava tekijänoikeuksien ja muiden immateriaalioikeuksien haltijat.

Julkaisijalla ei ole muita oikeuksia kuin näissä käyttöehdoissa ja laissa tarkoitettu käyttöoikeus HKP:hen ja siihen sisältyviin aineistoihin.

Palvelun käyttö on maksutonta ja käyttöoikeus on KaPA-lain 5 §:ssä tarkoitetuilla julkisen hallinnon viranomaisilla ja muilla julkista tehtävää hoitavilla tahoilla säännöksessä säädetyin edellytyksin. Palvelussa ei ole käyttömäärärajoituksia.

Suomi.fi-kartat palvelukuvaus

Selainvaatimukset

Suomi.fi-kartat toimii yleisimmillä selaimilla. Tuettuja selaimia ovat Internet Explorer versiosta 10.0 alkaen, Mozilla Firefox, Google Chrome ja Safari.

Häiriötiedottaminen

Palvelu on päällä jatkuvasti (24/7/365), mutta mahdollisiin häiriötilanteisiin reagoidaan virka-aikana. Käyttökatkoksista ja mahdollisista häiriötilanteista tiedotetaan palvelun verkkosivuilla. Palvelun toimivuuden voi tarkistaa myös Sovellusten käytettävyystilanne -verkkosivulta.

Palvelinympäristö

Suomi.fi-kartat sijaitsee Maanmittauslaitoksen tarjoamassa palvelinympäristössä. Myös asiakkaan palvelussa tuottamat omat kohteet tallennetaan Suomi.fi-kartat-palvelinympäristöön.

Sovellusten tila

Tarkista sovellusten ajankohtainen tilanne sekä mahdolliset häiriöt.

Ongelmia palvelun käytössä?

Ota yhteyttä tekniseen tukeen: sovellustuki@maanmittauslaitos.fi tai 029 530 1197.