AuroraAI-palvelusuosittelijat mahdollistavat annettujen suositusten rajaamisen eri metatietojen perusteella. Hyödynnettävien metatietojen määrä kasvaa AuroraAI-ydinkomponenttien julkaisussa 0.6.0 (ajoitettu 28.4.22) merkittävästi. Tässä artikkelissa esitellään miten uusia rajauskenttiä hyödynnetään rajapintakutsuissa.
Aluerajaukset
Aiemmin suosittelukutsuissa on ollut mahdollista rajata tuloksia käyttäen yhtä kuntakoodia:
"municipality_code": "091"
Julkaisun 0.6.0 yhteydessä aluerajaukset laajenevat seuraavasti: kuntakoodeja on jatkossa mahdollista antaa useampia. Lisäksi voidaan antaa listat maakunnista ja sairaanhoitopiireistä, joita käytetään palautettavien palvelujen rajaamiseen vastaavasti kuin kuntakoodeja. Uutena ominaisuutena voidaan lisäksi antaa tieto siitä, halutaanko tuloksiin valtakunnallisia palveluita. Rajapintakutsussa nämä aluerajaukset näyttävät tältä:
"service_filters": {
"include_national_services": false,
"municipality_codes": [
"091",
"638"
],
"region_codes": [
"02",
"19"
],
"hospital_district_codes": [
"04",
"12"
],
"service_classes": [
"http://uri.suomi.fi/codelist/ptv/ptvserclass2/code/P1.2",
"http://uri.suomi.fi/codelist/ptv/ptvserclass2/code/P25.3"
]
},
Aluerajaukset on siis jatkossa ryhmitelty yhdessä palveluluokkien kanssa service_filters-otsikon alle. Kentät eivät ole pakollisia eli minimimuutoksena rajapintakutsua päivitettäessä voidaan siirtää haluttu kuntakoodi vanhasta service_filter-kentästä uuteen service_filters-listaan. Lisätoimintoja voidaan ottaa käyttöön tarpeen mukaan.
Käytetyt numeromuotoiset koodit kunnille, maakunnille ja sairaanhoitopiireille löydät Yhteentoimivuusalustalta:
Kuntakoodit 2022: https://koodistot.suomi.fi/codescheme;registryCode=jhs;schemeCode=kunta_1_20220101
Maakuntakoodit 2022: https://koodistot.suomi.fi/codescheme;registryCode=jhs;schemeCode=maakunta_1_20220101
Sairaanhoitopiirien koodit 2022: https://koodistot.suomi.fi/codescheme;registryCode=jhs;schemeCode=sairaanhoitop_1_20220101
Palveluluokkarajaukset
Aluerajausten lisäksi tuloksia voidaan rajata hyödyntäen julkisten palvelujen palveluluokkia. Rajapinta ottaa vastaan listan halutuista pää- ja alaluokista ja palauttaa vain kyseisiin palveluluokkiin kuuluvia palveluita. Palveluluokat rajataan listalla URI-koodeja, jotka löytyvät Yhteentoimivuusalustalta.
Julkisten palvelujen luokitus: https://koodistot.suomi.fi/codescheme;registryCode=ptv;schemeCode=ptvserclass2