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.