Vakioidut kyselyt: kyselypalvelu-ilmanhenkilotietoja

Palveluosoitteesta on haettavissa WFS 2.0.0-standardinmukaisilla kyselyillä vakioitujen kyselyiden luettelo (ListStoredQueries -kyselyllä) ja vakioitujen kyselyiden kuvaus (DescribeStoredQueries-kyselyllä). Alle on liitetty staattiset kopiot näiden kyselyiden vastauksista tutustumista varten.

Staattinen kopio vakioitujen kyselyiden luettelosta

Vakioitujen kyselyiden kuvaus listaa kaikki käytössä olevat vakioidut kyselyt hakuparametreineen: Staattinen kopio vakioitujen kyselyiden kuvauksesta.

Hakuparametrien käytöstä:

• Kaikki hakuparametrit ovat vapaaehtoisia, mutta kannattaa aina kyselyssä rajata tilanteen mukaan joko aikarajauksella, sijaintirajauksella, kuntarajauksella, kiinteistönluovutustunnuksella tai muulla rajaavalla ehdolla esim. kiinteistötunnuksella tai määräalatunnuksella.
• Kuntarajauksen ja sijaintirajauksen kanssa on hyvä käyttää aikarajausta, varsinkin jos haetaan isolta alueelta.
• Kun haetaan joltain pinta-alaväliltä, niin alarajalle ei kannata asettaa arvoa 0 (muuten ei hae kaikkia, koska osalla pinta-aloista ei ole arvoa ollenkaan)
• Jos hakuparametri on annettu kyselyssä, mutta sille ei ole annettu arvoa, niin hakuparametria ei käytetä kyselyssä
• Jos on annettu vakioituun kyselyyn kuulumaton hakuparametri, niin ko. hakuparametria ei käytetä kyselyssä
• Kyselyissä kaikille koodistotyyppisille hakuparametreille voi antaa useita arvoja pilkulla erotettuina esim. 1,2
• Hakuparametrit on nimetty niin, että ne ovat verrattavissa tuotekuvauksessa oleviin tietoihin. Tuotekuvaukset sisältävät tarkemmat kuvaukset tiedoista.
• Hakuparametrit on kuvauksissa pienillä kirjaimilla, mutta kyselyesimerkeissä on käytetty osittain myös isoja kirjaimia. Kirjainkoko ei merkitse kyselyssä käytettävissä hakuparametrien nimissä.
• Hakuparametrilla tulostuskoordinaatisto voi määrätä, mihin palvelun tukemaan koordinaatistoon vastaus tulostetaan. Tuetut arvon syöttämismuodot ovat joko urn:ogc:def:crs:EPSG::3067 tai EPSG:3067

Kaikille kolmelle tuotteelle (KiinteistonluovutuksenTunnistetiedot, KiinteistonluovutuksenTiedot ja KiinteistonluovutuksenLaajatTiedotIlmanHenkilotietoja) on samat hakumahdollisuudet. Vakioidun kyselyn nimi (StoredQuery id) kuitenkin vaihtelee sen mukaan, mikä tuote halutaan palautuvaksi. Alla on kuvattu eri hakumahdollisuudet eri tuotepalautuksineen kyselyesimerkkien avulla.

Kyselyesimerkit: kyselypalvelu-ilmanhenkilotietoja

Koko Suomesta aikarajauksella

Hakuparametrit kiinteistonluovutuspvm, rekisterointipvm, paivityspvm sekä lakkaamispvm joko yhdellä arvolla tai arvovälillä (Vahintaan, Enintaan). Lisäksi käytössä hakuparametri olotila .

Kiinteistonluovutuspvm avulla voi hakea kiinteistönluovutuksia koko Suomesta aikarajauksin.

Rekisterointipvm avulla voi hakea Kauppahintarekisteriin rekisteröityjä uusia kiinteistönluovutuksia aikarajauksin.

Paivityspvm avulla voi hakea Kauppahintarekisterissä muutettuja ja lakkautettuja kiinteistönluovutuksia aikarajauksin.

Lakkaamispvm avulla voi hakea Kauppahintarekisteristä lakkautettuja kiinteistönluovutuksia aikarajauksin.

Olotila avulla voi hakea voimassaolevia luovutuksia tai lakkautettuja luovutuksia. Jos hakuparametrin jättää pois, haetaan kaikki.

Suositeltu maksimihakuväli on viikko.

Koko Suomesta aikarajauksella, kiinteistönluovutuksen ominaisuuksilla sekä luovuttajan, saajan ja kohteen luokittelutiedoilla

Käytettävissä samat hakuparametrit kuin aikarajauksella haussa. Lisäksi monipuoliset hakuparametrit kiinteistönluovutuksen ominaisuuksiin liittyen. Lisäksi voi rajata luovuttajan, saajan ja kohteen luokittelutiedoilla.

Sijaintirajauksella luovutuksen pistemäisen sijainnin avulla sekä aikarajauksella, kiinteistönluovutuksen ominaisuuksilla sekä luovuttajan, saajan ja kohteen luokittelutiedoilla

Käytettävissä samat hakuparametrit kuin aikarajauksella haussa. Lisäksi monipuoliset hakuparametrit kiinteistönluovutuksen ominaisuuksiin liittyen. Lisäksi voi rajata luovuttajan, saajan ja kohteen luokittelutiedoilla.

Näiden lisäksi mahdollisuus käyttää hakuehtona sijaintirajausta, jolla haetaan luovutuksen yhden pistemäisen sijainnin mukaisia kohteita. Luovutuksen yksi pistemäinen sijainti on kattavampi tieto erityisesti vanhemmilla kiinteistönluovutuksilla kuin luovutuksen kohteiden pistemäinen sijainti, josta on oma vakioitu kyselynsä.

Sijaintirajaus annetaan jollain seuraavista hakuparametreista:

• bboxsijaintihaku (annetaan aina sijaintirajauksena Envelope)
• intersectssijaintihaku (sijaintirajauksena esim. Envelope tai Polygon)
• withinsijaintihaku (sijaintirajauksena esim. Envelope tai Polygon)
• dwithinsijaintihaku, jonka kanssa annetaan hakuparametri dwithinsijaintihakudistance metreinä (hakuvyöhyke/hakusäde) (sijaintirajauksena esim. LineString tai Point)

Sijaintirajauksella luovutuksen kohteiden pistemäisten sijaintien avulla sekä aikarajauksella, kiinteistönluovutuksen ominaisuuksilla sekä luovuttajan, saajan ja kohteen luokittelutiedoilla

Käytettävissä samat hakuparametrit kuin aikarajauksella haussa. Lisäksi monipuoliset hakuparametrit kiinteistönluovutuksen ominaisuuksiin liittyen. Lisäksi voi rajata luovuttajan, saajan ja kohteen luokittelutiedoilla.

Näiden lisäksi mahdollisuus käyttää hakuehtona sijaintirajausta, jolla haetaan luovutuksen kohteiden pistemäisten sijaintien mukaisia kohteita. Luovutuksen kohteiden pistemäinen sijainti ei ole niin kattava tieto erityisesti vanhemmilla kiinteistönluovutuksilla kuin luovutuksen yksi pistemäinen sijainti, josta on oma vakioitu kyselynsä.

Sijaintirajaus annetaan jollain seuraavista hakuparametreista:

• bboxsijaintihaku (annetaan aina sijaintirajauksena Envelope)
• intersectssijaintihaku (sijaintirajauksena esim. Envelope tai Polygon)
• withinsijaintihaku (sijaintirajauksena esim. Envelope tai Polygon)
• dwithinsijaintihaku, jonka kanssa annetaan hakuparametri dwithinsijaintihakudistance metreinä (hakuvyöhyke/hakusäde) (sijaintirajauksena esim. LineString tai Point)

Lisää esimerkkejä erityyppisistä sijaintihauista seuraavan vakioidun kyselyn esimerkeissä: "Sijaintirajauksella luovutuksen pistemäisen sijainnin avulla sekä aikarajauksella, kiinteistönluovutuksen ominaisuuksilla sekä luovuttajan, saajan ja kohteen luokittelutiedoilla". Erona kulloinkin käytettävä StoredQuery id.

Kuntarajauksella, kiinteistönluovutuksen kohteen osoitetiedolla sekä aikarajauksella, kiinteistönluovutuksen ominaisuuksilla sekä luovuttajan, saajan ja kohteen luokittelutiedoilla

Käytettävissä samat hakuparametrit kuin aikarajauksella haussa. Lisäksi monipuoliset hakuparametrit kiinteistönluovutuksen ominaisuuksiin liittyen. Lisäksi voi rajata luovuttajan, saajan ja kohteen luokittelutiedoilla.

Näiden lisäksi mahdollisuus käyttää hakuehtoina kiinteistönluovutushetken mukaista kuntarajausta sekä kiinteistönluovutuksen kohteen osoitetietoa.

• hakuparametrille kuntatunnus voi antaa useita arvoja pilkulla erotettuina.
• hakuparametreille  kunnanNimiSuomeksi ja kunnanNimiRuotsiksi voi antaa useita arvoja pilkulla erotettuina. Myös arvon osaa voi käyttää esim. Helsin*, Porv*
• hakuparametrille kiinteistonluovutuksenKohteenOsoitetieto voi käyttää arvon osaa esim. Jokut*

Luovutetun kohteen tunnustiedoilla ja aikarajauksella

Kiinteistönluovutuksen hakeminen luovutetun kohteen tunnustiedoilla: joko hakuparametrilla kiinteistotunnus tai hakuparametrilla maaraalatunnus. Hakuparametrille kiinteistotunnus voi antaa useita arvoja pilkulla erotettuina. Hakuparametrille maaraalatunnus voi antaa useita arvoja pilkulla erotettuina. Lisäksi on tarvittaessa käytettävissä samat hakuparametrit kuin aikarajauksella haussa.

Kiinteistönluovutuksen tunnustiedoilla

Kiinteistönluovutuksen hakeminen yksilöivällä tunnuksella: Yksilöivänä tunnuksena voi käyttää joko hakuparametria kiinteistonluovutustunnus tai yksiloivaTunnus (JHS193 mukainen yksilöivä tunnus). Hakuparametrille kiinteistonluovutustunnus voi antaa useita arvoja pilkulla erotettuina. Hakuparametrille yksiloivaTunnus voi antaa useita arvoja pilkulla erotettuina.