Ympäristöministeriö / Rakentaminen ja maankäyttö

Laatusäännöt

  1. Johdanto
  2. Yhteiset laatusäännöt
    1. UML-mallin mukaisuus
    2. Tunnisteet ja sisäisten viittausten eheys
    3. Elinkaarisääntöjen mukaisuus
    4. Soveltamisohjeiden mukaisuus
    5. Merkkijonojen käyttö
      1. Merkistöt
      2. Monikielinen sisältö ja kielikoodit
      3. Enimmäispituudet
      4. Tekstiarvojen käyttö
    6. Geometriat
      1. Geometriatyypit
      2. Sallitut koordinaatistot ja koordinaattijärjestys
      3. Geometrinen ja topologinen eheys
      4. Paikkatietokohteiden geometrioiden sisäkkäisyys ja päällekkäisyys
    7. Päivämäärät ja kelloanajat
  3. Luokkakohtaiset säännöt
    1. AbstraktiMaankayttoasia
    2. Lahtotietoaineisto
    3. KaavanKumoamistieto
    4. Kaava
    5. Kaavakohde

Johdanto

Yhteiset laatusäännöt

UML-mallin mukaisuus

Vaatimus 
laatu/vaat-uml-mukaisuus

Kaavatietomallin loogisen tietomallin toteutusten tulee noudattaa tietomallin UML-kielisen luokkakaavion määrityksiä luokkien attribuuttien ja assosiaatioiden kardinaliteetin ja tyypin suhteen.

Vaatimus 
laatu/vaat-uml-toteutus

Kunkin fyysisen tietomallin kuvauksessa tulee määritellä minkälaista rakennetta ja tietotyyppiä kukin loogisen tietomallin luokka ja attribuutin tyyppi vastaa fyysisessä mallissa. Attribuutit ja assosiaatiot, joiden kardinaliteetti on loogisessa tietomallissa 0..1 tai 0..* voivat puuttua fyysisen tietomallin mukaisista objekteista.

Tunnisteet ja sisäisten viittausten eheys

Vaatimus 
laatu/vaat-tunnukset-viittaukset

Kaavatietomallin versioitavilla tietokohteilla tulee olla yksilöivät tunnukset, joiden luomisessa ja käyttämisessä viittaamiseen toisiin tietokohteisiin tulee noudattaa elinkaarisääntöjen luvun Tunnukset ja niiden hallinta vaatimuksia.

Elinkaarisääntöjen mukaisuus

Vaatimus 
laatu/vaat-elinkaarisaannot

Kaavatietomallin mukaisten aineistojen tulee noudattaa Kaavatietomallin elinkaarisääntöjen vaatimuksia, ja niiden on suositeltavaa noudattaa elinkaarisääntöjen suosituksia. Vaatimukset ja suositukset on erotettu selkeästi elinkaarisääntöjen muusta sisällöstä.

Soveltamisohjeiden mukaisuus

Vaatimus 
laatu/vaat-soveltamisohjeet

Kaavatietomallin mukaisten aineistojen tulee noudattaa niiden kaavalajikohtaisten soveltamisprofiilien (Asemakaava, Yleiskaava) vaatimuksia, ja niiden on suositeltavaa noudattaa soveltamisprofiilien suosituksia. Vaatimukset ja suositukset on erotettu selkeästi soveltamisprofiilien muusta sisällöstä.

Merkkijonojen käyttö

Merkistöt

Vaatimus 
laatu/vaat-merkisto-utf8

Kaikki Kaavatietomallin tekstimuotoiset sisällöt on tiedonsiirtoa varten koodattava käyttäen UTF-8 -merkistökoodausta.

Monikielinen sisältö ja kielikoodit

Kaikki kaavatietomallin tekstimuotoinen sisältö ilmaistaan ISO 19103 -standardin määrittelemän LanguageString-luokan avulla.

Vaatimus 
laatu/vaat-monikielisyys-kielikoodi

Kunkin LanguageString-luokan objektin tulee toteuttaa language-attribuutti, jonka arvona on ISO 639-2 -standardin mukainen terminologinen, kolmekirjaiminen kielikoodi code (ISO 639-2/T).

Tekstimuotoiset attribuutit on määritelty siten, että ne sisältävät nolla tai enemmän LanguageString-tyyppisiä arvoja.

Vaatimus 
laatu/vaat-yksi-teksti-per-kieli

Kunkin tekstimuotoista sisältöä kuvaavan attribuutin arvoina tulee olla enintään yksi LanguageString-tyyppinen arvo kutakin kielikoodia (language-attribuutti) kohti.

Enimmäispituudet

Vaatimus 
laatu/vaat-merkijono-pituus

Kunkin yhdellä kielellä annetun LanguageString-tyyppisen merkkijonon enimmäispituus on 2048 merkkiä.

Tekstiarvojen käyttö

Tekstimuotoisina annettujen kaavamääräysten ja niiden lisätietojen koneellinen tulkittavuus on monimutkaisempaa, epätäsmällisempää ja epäluotettavampaa kuin kuvattaessa sama ohjausvaikutus koodistojen arvojen tai numeeristen arvojen avulla. Tekstimuotoiset arvot ovat kuitenkin toisinaan tarpeen, koska kaikkia mahdollisia yksityiskohtaisia kaavamääräystietoja ei ole mielekästä koodittaa. Ihmisen tulee todennäköisesti aina tarkistaa tekstimuotoisten kaavamääräysten tulkinta, mikä heikentää konetulkittavan kaavatiedon käsittelytehokkuutta. Tämän vuoksi tekstimuotoisia kaavamääräysten ja niiden lisätietojen arvoja ei tule käyttää tarpeettomasti, esimerkiksi kuvaamaan uudelleen jo kaavamääräyslajikoodin otsikkoon, määritelmään tai kuvaukseen sisältyvää sisältöä.

Vaatimus 
laatu/vaat-vain-tarpeelliset-tekstiarvot

Mikäli Kaavamaarays- tai Lisatieto-luokkien arvo-attribuuteille on sallittu nollasta poikkeava määrä TekstiArvo-tyyppisiä arvoja, tulee niitä käyttää ainoastaan tapauksissa, joissa teksti on välttämätön täydentämään kaavamääräyksen tai lisätiedon muiden attribuuttien avulla kuvattua merkitystä. Mikäli sama ohjausvaikutus saavutetaan myös jättämällä TekstiArvo-tyyppinen arvo pois, ei sitä tule käyttää.

Vaatimus 
laatu/vaat-otsikointi-nimi

Kaavamaarays-, Kaavasuositus- ja Kaavakohde-luokkien instanssien mahdolliseen ei-oikeusvaikutteiseen otsikointiin tulee käyttää niiden nimi-attribuutteja.

Geometriat

Geometriatyypit

Vaatimus 
laatu/vaat-geom-piste-maar

Pistemäiset geometriat toteuttavat ISO 19107 -standardin määrittelemän Point-rajapinnan.

Vaatimus 
laatu/vaat-geom-viiva-maar

Viivamaiset geometriat toteuttavat ISO 19107 -standardin määrittelemän Curve-rajapinnan.

Vaatimus 
laatu/vaat-geom-2d-alue-maar

Aluemaiset geometriat toteuttavat ISO 19107 -standardin määrittelemän Surface-rajapinnan.

Vaatimus 
laatu/vaat-geom-3d-kappale-maar

3-ulotteiset kappalegeometriat toteuttavat joko ISO 19107 -standardin määrittelemän Solid-rajapinnan.

Vaatimus 
laatu/vaat-geom-kokoelmat-maar

Geometriakokoelmat toteuttavat ISO 19107 -standardin määrittelemän Collection-rajapinnan. Monipiste (multipoint) -geometriat rakentuvat Point-rajapinnan, moniviiva (multicurve) -geometriat Curve-rajapinnan, monialue (multisurface) -geometriat Surface-rajapinnan ja monikappale (multisolid) -geometriat Solid-rajapinnan toteuttavista osista (element-attribuutti).

Sallitut koordinaatistot ja koordinaattijärjestys

Vaatimus 
laatu/vaat-koord-jarjestys

Geometrioiden ilmaisemisessa tulee noudattaa kunkin koordinaatiston määritelmässä annettua virallista koordinaattijärjestystä.

Geometrinen ja topologinen eheys

Vaatimus 
laatu/vaat-suljetut-ringit

Mikäli viiva on osa aluemaisen geometrian reunaviivaa, on sen oltava suljettu, eli sen alku- ja loppuppisteiden on oltava samat.

Vaatimus 
laatu/vaat-viiva-kielletyt-leikkaukset

Viivamainen geometria ei saa leikata itseään.

Vaatimus 
laatu/vaat-alue-kielletyt-leikkaukset

Aluemaisen geometrian ulkoreunan ja reikien reunaviivat eivät saa leikata itseään tai toisiaan. Kukin reunaviiva saa koskettaa alueen ulkoreunaa tai reiän reunaa, mukaanlukien se itse, vain yksittäisissä pisteissä.

Vaatimus 
laatu/vaat-yhteneva-alue

Aluemaisen geometrian sisäosan on oltava yhtenevä, eli minkä tahansa kahden alueen sisäpisteen välillä on voitava muodostaa yhtenäinen käyrä, joka kulkee kokonaan alueen sisällä.

Vaatimus 
laatu/vaat-ei-tyhja-alue

Aluemaisen geometrian sisäosan pinta-ala on oltava mitattavissa, eli alueeseen tulee sisältyä pisteitä, jotka eivät ole osa alueen ulkoreunaa.

Vaatimus 
laatu/vaat-pinnan-orientaatio

Aluemaisten geometrioiden kiertosuuntien tulee noudattaa ISO 19107 -standardin määritelmää: Geometrioiden reunojen kiertosuunnat tulee valita siten, että pinnan yläpuolelta katsottuna ulkorajan reunan kiertosuunta on vastapäivään ja pinnan mahdollisten reikien reunojen kiertosuunnat ovat myötäpäivään. Mikäli pinta on osa 3-ulotteisten geometrian ulkorajaa, ulkopuoli vastaa yläpuolta.

Paikkatietokohteiden geometrioiden sisäkkäisyys ja päällekkäisyys

Vaatimus 
laatu/vaat-kaavakohteet-kaavan-sisalla

Kaava-luokan objektin aluerajaus-attribuutin ilmaiseman kaava-alueen tulee pitää sisällään kaikki kaavaan sisältyvien AbstraktiKaavakohde-luokan objektien geometriat, poislukien sellaiset Kaavakohde-luokan objektit, joiden kaikki kaavamääräykset ja kaavasuositukset ovat kumottuja.

Päivämäärät ja kelloanajat

Kaavatietomallin yksittäisiä ajanhetkiä kuvaavat attribuutit ovat ISO 19108 -standardin määrittämää tyyppiä TM_Instant ja aikavälejä kuvaavat attribuutit tyyppiä TM_Period. Päivämäärät annetaan käyttäen Gregoriaanista kalenteria ja kellonajat käyttäen 24 tunnin kelloaikamuotoa alkaen kellonajasta 00:00:00.000 ja päättyen ajanhetkeen 23:59:59.999 (tunti, minuutti, sekunti, millisekunti).

Vaatimus 
laatu/vaat-ajanhetki-tarkkuus

Yksittäisiä ajanhetkiä kuvaavat attribuutit ilmaistaan joko pelkän päivämäärän tai päivämäärän ja kelloajan avulla. Päivämäärät ilmaistaan antamalla vuoden, kuukauden ja kuukauden päivän numeeriset arvot. Kellonajat ilmaistaan vähintään yhden minuutin ja enintään yhden millisekunnin tarkkuudella antamalla tunnin, minuutin, sekunnin ja millisekunnin numeeriset arvot.

Vaatimus 
laatu/vaat-aikavyohykkeet

Päivämäärien ja kellonaikojen yhteydessä voidaan antaa myös tieto aikavyöhykkeestä tai aikojen poikkeamasta UTC-ajasta. Mikäli muuta ei tietoa ei anneta, tulee ajanhetkitiedot tulkita siten, että ne kuvaavat Suomen aikaa noudattaen kyseisellä ajanhetkellä voimassaolleita asetuksia kesäaikaan liittyen.

Suositus 
laatu/suos-ajanhetki-muoto

Mikäli fyysinen tietomalli ei aseta ajanhetken muodolle rajoituksia, on suositeltavaa käyttää IETF RFC 3339 Date and Time on the Internet: Timestamps-standardin määrittelemää syntaksia.

Vaatimus 
laatu/vaat-aikavali-maar

Aikavälejä kuvaavat attribuutit voidaan antaa joko sekä alku- että loppuajanhetken avulla tai vain joko alku- tai loppuajanhetken avulla. Mikäli alkuajanhetkeä ei anneta, tulkitaan aikavälin sisältävän minkä tahansa ajanhetken loppuajanhetkeen saakka. Vastaavasti mikäli loppuajanhetkeä ei anneta, tulkitaan aikavälin sisältävän minkä tahansa ajanhetken alkujanhetkestä lähtien.

Luokkakohtaiset säännöt

AbstraktiMaankayttoasia

Vaatimus 
laatu/vaat-mkp-aluerajaus-geometria

AbstraktiMaankayttoasia-luokan objektien aluerajaus-attribuutin arvon tulee kuvata kaavan suunnittelualue joko aluemaisena geometriana tai monialueena.

Lahtotietoaineisto

Vaatimus 
laatu/vaat-lahtotietoaineisto-aluerajaus-geometria

Lahtotietoaineito-luokan objektien aluerajaus-attribuutin arvon tulee kuvata aineiston maantieteellinen kattavuus joko aluemaisena geometriana tai monialueena.

KaavanKumoamistieto

Vaatimus 
laatu/vaat-lahtotietoaineisto-aluerajaus-geometria

KaavanKumoamistieto-luokan objektien kumottavanKaavanAlue-attribuutin arvon tulee kuvata kumottava alue joko aluemaisena geometriana tai monialueena.

Kaava

Vaatimus 
laatu/vaat-kaava-paallekkaiset-aluerajaukset

Kaavatietovarastossa ei tule olla kahta Kaava-luokan objektia, joiden

  • laji-attribuutin arvot ovat samat,
  • voimassaoloAika-attribuutin arvojen kuvaamat aikavälit ovat sisäkkäisiä tai lomittain, ja
  • aluerajaus-attribuuttien kuvaavat geometriat leikaavat toisiaan tai ovat sisäkkäisiä.
Vaatimus 
laatu/vaat-kaava-aluerajaus-annettava

Kaava-luokan objektilla, jonka elinkaatila on kaavaehdotus tai myöhempi (koodi 04, 05, 06, 07, 08, 09, 10, 11 tai 12) tulee olla ei-tyhjä aluerajaus-attribuutin arvo.

Vaatimus 
laatu/vaat-kaava-virelletuloaika-annettava

Kaava-luokan objektilla, jonka elinkaatila on virelletullut tai myöhempi (koodi 02, 03, 04, 05, 06, 07, 08, 09, 10, 11 tai 12), tulee olla ei-tyhjä virelletuloAika-attribuutin arvo.

Vaatimus 
laatu/vaat-kaava-hyvaksymistuloaika-annettava

Kaava-luokan objektilla, jonka elinkaatila on hyväksytty kaava tai myöhempi (koodi 06, 07, 08, 09, 10, 11 tai 12), tulee olla ei-tyhjä hyvaksymisAika-attribuutin arvo.

Vaatimus 
laatu/vaat-kaava-voimassaolo-alku

Kaava-luokan objektilla, jonka elinkaatila on osittain voimassa, voimassa, tai niitä myöhempi (koodi 09, 10, 11 tai 12) tulee olla ei-tyhjä voimassaAika-attribuutin alkuajanhetken arvo.

Vaatimus 
laatu/vaat-kaava-voimassaolo-loppu

Kaava-luokan objektilla, jonka elinkaatila on kumottu tai kumoutunut (koodi 11 tai 12), tulee olla annettu ei-tyhjä voimassaAika-attribuutin loppuajanhetken arvo.

Kaavakohde

Vaatimus 
laatu/vaat-kaavakohde-geometria

Kaavakohde-luokan objektin geometria-attribuutin arvon tulee olla piste, viiva, alue, 3-ulotteinen kappale, moniviiva, monialue tai monikappale.

Vaatimus 
laatu/vaat-kaavakohde-3d-konsistenssi

Mikäli Kaavakohde-luokan objektin geometria-attribuutin arvo on 3-ulotteinen kappale tai monikappale, ja sille on annettu pystysuuntainenRajaus-attribuutti, tulee geometria-attribuutin arvon sijaita pystysuuntaisen rajauksen määrittämien korkeuksien ala- ja ylärajojen väleissä.

Vaatimus 
laatu/vaat-paallekkaiset-kaavakohteet

Kaavatietovarastossa ei tule olla kahta Kaavakohde-luokan objektia, joiden

  • kaava-attribuutin arvo viittaavat eri kaavoihin,
  • voimassaoloAika-attribuutin arvojen kuvaamat aikavälit ovat sisäkkäisiä tai lomittain, ja
  • geometria- ja pystysuuntainenRajaus-attribuuttien yhdessä kuvaavat geometriat leikaavat toisiaan tai ovat sisäkkäisiä.