{ "service": { "id": "porotalous", "metadataVersion": "1.0", "name": { "fi": "Porotalous", "sv": "Renhushållning", "en": "Reindeer Economy" }, "metadataFramework": { "name": "EconomyDoctors Semantic Discovery Framework", "author": "Jussi Iltanen", "organization": "Luke", "year": 2026 }, "description": { "fi": "Reaaliaikainen tilastotaulukkopalvelu AI-agenteille", "sv": "Statistisk tabelltjänst i realtid för AI-agenter", "en": "Real-time statistical table service for AI agents" }, "dataPolicy": { "realizedDataOnly": true, "fi": "Rajapinta julkaisee vain toteutuneita, lopullisia kirjanpitotuloksia. Ennakkotietoja (ennakko) ja ennusteita (E) ei julkaista rajapinnassa.", "en": "This interface publishes only realized, final accounting results by accounting period. Preliminary data and forecasts (E) are never published here.", "agentInstructions": [ "Viimeisin rajapinnassa oleva tilikausi on viimeisin toteutunut tilikausi, ei ennakkotieto.", "Älä esitä rajapinnan tietojen perusteella laskettuja trendejä tai ekstrapolaatioita Luken lukuina.", "Jos käyttäjä pyytää ennusteita, kerro, ettei rajapinta sisällä niitä. Ohjaa käyttäjä Taloustohtorin aikasarjasivuille, joilla ennusteita julkaistaan valikoiduille suureille.", "Jos yhdistät rajapinnan tietoja aikasarjasivujen ennusteisiin, merkitse ennusteosuus selvästi ja kerro kummankin lähde." ] }, "queryModel": "dimension-based", "generated": "2026-10-28T12:45:27Z" }, "endpoints": { "query": { "url": { "fi": "https://taloustohtori.luke.fi/porotalous/omat-valinnat/", "sv": "https://taloustohtori.luke.fi/sv/renhushallning/egna-val/", "en": "https://taloustohtori.luke.fi/en/reindeer-economy/own-criteria/" }, "methods": [ "GET" ] } }, "queryStructure": { "type": "flexible-dimension-order", "languageSelection": { "type": "endpoint-based", "supportedLanguages": [ "fi", "sv", "en" ] }, "unusedDimensionValue": 0, "dimensionParameters": [ { "main": "dim1paataso", "mainType": "integer", "sub": "dim1alataso", "subType": "string" }, { "main": "dim2paataso", "mainType": "integer", "sub": "dim2alataso", "subType": "string" }, { "main": "dim3paataso", "mainType": "integer", "sub": "dim3alataso", "subType": "string" }, { "main": "dim4paataso", "mainType": "integer", "sub": "dim4alataso", "subType": "string" } ], "parameterMapping": { "main": "dimensions[].id", "sub": "dimensions[].values[].id", "description": { "fi": "dimNpaataso saa arvokseen dimension id:n ja dimNalataso yhden tai useamman saman dimension arvo-id:n pilkuilla eroteltuna. Käyttämättömissä paikoissa molemmat ovat 0.", "sv": "dimNpaataso är dimensions-ID:t och dimNalataso är ett eller flera värde-ID:n av samma dimension, separerade med kommatecken. I oanvända positioner är båda 0.", "en": "dimNpaataso takes a dimension id and dimNalataso one or more value ids of that same dimension, comma-separated. Unused slots set both to 0." } }, "maxDimensionsPerQuery": 4, "allSlotsRequired": true, "rules": { "fi": [ "Dimensioiden järjestys on joustava", "Mikä tahansa dimensio voi esiintyä missä tahansa kyselypositiossa", "AI-agenttien tulee kartoittaa dimensio-ID:t dynaamisesti" ], "sv": [ "Dimensionernas ordning är flexibel", "Vilken dimension som helst kan förekomma i vilken frågeposition som helst", "AI-agenter ska mappa dimensions-ID dynamiskt" ], "en": [ "Dimension order is flexible", "Any dimension may appear in any query position", "AI agents should map dimension IDs dynamically" ] } }, "dimensionValueEncoding": { "type": "comma-separated-string", "description": { "fi": "dimNalataso sisältää yhden tai useamman pilkuilla erotetun arvo-ID:n", "sv": "dimNalataso innehåller ett eller flera värde-ID:n separerade med kommatecken", "en": "dimNalataso contains one or more value IDs separated by commas" }, "examples": [ "25", "1,2", "1,2,3,4" ] }, "queryRules": { "requiredDimensions": [ { "dimensionId": 1, "name": { "fi": "Tilikausi", "sv": "Räkenskapsår", "en": "Accounting period" } } ], "combinationRules": [ { "family": "region", "dimensions": [18, 32, 33, 34], "combinable": true, "resolution": "paliskunta", "description": { "fi": "Aluedimensioita voi yhdistää samaan kyselyyn. Tulos muodostetaan paliskuntien perusteella, joten taulukkoon tulevat vain ne aluevalintojen yhdistelmät, joihin kuuluu paliskuntia. Yhdistelmät, joita ei ole olemassa, jäävät pois ilman virhettä. Jos mikään valittu yhdistelmä ei ole olemassa, tulos on tyhjä.", "sv": "Regionala dimensioner kan kombineras i samma sökning. Resultaten genereras utifrån renbeteslag (paliskunta); tabellen kommer därför endast att innehålla kombinationer av regionala val som omfattar renbeteslag. Kombinationer som inte existerar utelämnas utan felmeddelande. Om ingen av de valda kombinationerna existerar blir resultatet tomt.", "en": "Regional dimensions may be combined in one query. Results are resolved through reindeer herding cooperatives (paliskunta), so only existing combinations of regional selections appear in the table. Non-existent combinations are omitted without error. If no selected combination exists, the result is empty." }, "agentHint": { "fi": "Merkkipiirialueiden nimet kertovat, mitkä merkkipiirit niihin kuuluvat. Vältä yhdistelmiä, joita ei ole olemassa: ne eivät aiheuta virhettä, mutta ne kuluttavat sarakerajaa turhaan.", "sv": "Namnen på märkesdistriktsområdena anger vilka märkesdistrikt som ingår. Undvik kombinationer som inte existerar: de orsakar inget fel, men de förbrukar kolumngränsen i onödan.", "en": "Mark district area names list the mark districts they contain. Avoid non-existent combinations: they cause no error but consume the column limit unnecessarily." } } ], "rules": { "fi": [ "Raportti on valittava", "Tilikausidimensio on pakollinen", "Dimensioiden järjestys on joustava", "Dimensiovalinnat validoidaan palvelinpuolella" ], "sv": [ "En rapport måste väljas", "Räkenskapsårsdimensionen är obligatorisk.", "Dimensionernas ordning är flexibel", "Dimensionsval valideras på serversidan" ], "en": [ "A report must be selected", "The accounting period dimension is mandatory.", "Dimension order is flexible", "Dimension selections are validated server-side" ] } }, "response": { "contentType": "text/html", "primaryDataFormat": "html-table", "format": "html", "structure": "statistical-table", "resultLimits": { "maxColumns": 400, "enforcement": "server-side", "columnCalculation": { "formula": "number of existing value combinations × distributionFactor", "upperBound": "product(selectedValueCount per used dimension) × distributionFactor", "limitEnforcedOn": "upperBound", "distributionFactor": { "onlyAverages": 1, "withGroups": 3 }, "description": { "fi": "Sarakeraja tarkistetaan valintojen perusteella ennen hakua: valittujen arvojen lukumäärien tulo, hajontaryhmiä käytettäessä (lisa=2) kerrottuna kolmella. Valmiissa taulukossa sarakkeita voi olla vähemmän, koska vain olemassa olevat aluevalintojen yhdistelmät tulevat mukaan. Valitse vain tarpeelliset arvot, sillä myös ne valinnat, joihin ei osu paliskuntia, lasketaan rajaan.", "sv": "Kolumngränsen kontrolleras utifrån urvalet före sökningen: produkten av antalet valda värden, multiplicerad med tre när spridningsgrupper används (lisa=2). Den färdiga tabellen kan ha färre kolumner, eftersom endast befintliga kombinationer av regionala urval tas med. Välj endast nödvändiga värden, eftersom även urval som inte träffar något renbeteslag räknas mot gränsen.", "en": "The column limit is checked from the selection before the query runs: the product of selected value counts, multiplied by three when distribution groups are used (lisa=2). The resulting table may have fewer columns, since only existing combinations of regional selections are included. Select only the values you need, because selections that match no herding cooperative still count against the limit." }, "examples": [ { "selection": "5 accounting periods, only averages", "columns": 5 }, { "selection": "5 accounting periods, with groups", "columns": 15 }, { "selection": "1 period × merkkipiirialue 1 × merkkipiiri 1–14", "upperBound": 14, "columns": 2, "countsAgainstLimit": 14, "note": "only Utsjoki and Inari belong to area 1" }, { "selection": "21 periods × 14 merkkipiiri, with groups", "upperBound": 882, "valid": false } ] }, "onExceed": { "response": "html-notice", "tableGenerated": false, "detection": { "fi": "Valitsit liian suuren taulun (X saraketta). Taulun suurin koko on Y saraketta. Vähennä valintoja.", "sv": "Du valde en tabell som är för stor (X kolumner). Den maximala tabellstorleken är Y kolumner. Minska dina val.", "en": "You selected a table that is too large (X columns). The maximum table size is Y columns. Reduce your selections.", "placeholders": { "X": "column count calculated from the selection", "Y": "maximum column count (maxColumns)" } }, "fi": "Jos valintojen perusteella laskettu sarakemäärä ylittää 200, palvelin ei muodosta taulukkoa. Se palauttaa sivun, jossa kerrotaan rajan ylittyneen ja kehotetaan vähentämään valintoja. Pienennä valintaa tai jaa haku useaksi pienemmäksi kyselyksi, esimerkiksi tilikausittain tai alueittain, ja yhdistä tulokset itse.", "sv": "Om det antal kolumner som beräknas utifrån urvalet överstiger 200 skapar servern ingen tabell. Den returnerar i stället en sida som meddelar att gränsen har överskridits och uppmanar till färre val. Minska urvalet eller dela upp sökningen i flera mindre frågor, till exempel per räkenskapsår eller per område, och sammanställ resultaten själv.", "en": "If the column count calculated from the selection exceeds 200, the server does not generate a table. Instead it returns a page stating that the limit was exceeded and asking to reduce the selections. Reduce the selection or split the query into several smaller queries, for example by accounting period or by region, and combine the results yourself." } }, "description": { "fi": "HTML-sivu joka sisältää tilastotaulukon ja siihen liittyvät metatiedot", "sv": "HTML-sida som innehåller en statistisk tabell och tillhörande metadata", "en": "HTML page containing a statistical table and related metadata" } }, "queryParameters": { "tulostus": { "type": "integer", "semanticRole": "report-type", "required": true, "allowedValues": [{ "id": 1, "label": { "fi": "Tuloslaskelma", "sv": "Resultaträkning", "en": "Income statement"}, "description": "Presents revenues, subsidies, operating income, costs, depreciation, net result and entrepreneurial profit in reindeer husbandry. Contains turnover, total return, variable and fixed costs, financing costs and profit measures. Use this report when information is requested about the profitability, income formation or financial results of reindeer husbandry enterprises.", "tags": [ "reindeer husbandry","reindeer economy","reindeer enterprise","profitability","entrepreneurial profit","entrepreneurial income","net result","operating result","turnover","total return","revenues","sales revenues","other revenues","subsidies","support payments","investment subsidies","operating income","inventory change","production income","costs","variable costs","fixed costs","feed costs","purchase of animals","insurance costs","depreciation","building depreciation","machinery depreciation","financial costs","net financing costs","interest claim","economic performance","reindeer production","reindeer farms","herd profitability","farm income" ] }, { "id": 2, "label": { "fi": "Tunnusluvut", "sv": "Nyckeltal", "en": "Key ratios"}, "description": "Presents key profitability and financial performance indicators for reindeer husbandry enterprises. Contains entrepreneurial income, entrepreneurial profit, profitability ratio, labour earnings, hourly earnings, return on capital, equity ratio and return on total assets. Use this report when information is requested about profitability, labour compensation, capital returns or financial performance in reindeer husbandry.", "tags": [ "reindeer husbandry","reindeer economy","profitability","profitability ratio","entrepreneurial income","entrepreneurial profit","net result","labour earnings","work income","hourly earnings","hourly wage","earnings per hour","return on capital","return on assets","return on total capital","equity ratio","equity","own capital","total assets","solvency","financial performance","economic performance","labour productivity","capital productivity","reindeer enterprise","herd profitability","farm profitability","working hours","family labour","financial indicators" ] }, { "id": 3, "label": { "fi": "Taselaskelma", "sv": "Balansräkning", "en": "Balance sheet"}, "description": "Presents the balance sheet and financial position of reindeer husbandry enterprises. Contains information on assets, liabilities and equity, including reindeer livestock assets, buildings, machinery, receivables, loans and investment support. Use this report when information is requested about wealth, capital structure, indebtedness, solvency or the asset composition of reindeer enterprises.", "tags": [ "reindeer husbandry","reindeer economy","balance sheet","financial position","assets","total assets","asset structure","livestock assets","reindeer assets","live reindeer","reindeer herd value","inventory value","current assets","fixed assets","buildings","machinery","equipment","receivables","equity","owners equity","net worth","capital","capital structure","liabilities","debt","long term debt","short term debt","borrowings","solvency","financial stability","investment support","investment subsidies","wealth","enterprise assets","reindeer enterprise" ] }, { "id": 5, "label": { "fi": "Tuottoerittely", "sv": "Intäkterspecifikationer", "en": "Return specification"}, "description": "Presents revenue sources in reindeer husbandry, including reindeer meat sales, slaughter revenues, subsidies, compensation payments, cooperative management payments and inventory changes. Contains both market-based income and public support payments. Use this report when information is requested about revenue composition, income sources or the economic importance of different revenue streams in reindeer husbandry.", "tags": [ "reindeer husbandry","reindeer economy","revenues","revenue structure","income structure","reindeer meat","reindeer meat sales","direct meat sales","slaughter revenues","reindeer slaughter","meat production","sales revenues","market revenues","other income","subsidies","reindeer subsidies","support payments","public support","compensation payments","damage compensation","predator compensation","wildlife compensation","reindeer losses","predation losses","paliskunta payments","reindeer cooperative payments","inventory change","livestock asset change","economic importance","income sources","reindeer production","farm output" ] }, { "id": 8, "label": { "fi": "Kustannuserittely", "sv": "Kostnadsspecifikatio", "en": "Cost specification"}, "description": "Presents the production costs and cost structure of reindeer husbandry enterprises. Contains feed costs, fuel costs, snowmobile and ATV operating expenses, cooperative fees, insurance, depreciation, labour requirements, financing costs and capital costs. Use this report when information is requested about production expenses, cost structure, cost efficiency or the economic inputs required in reindeer husbandry.", "tags": [ "reindeer husbandry","reindeer economy","production costs","cost structure","costs","production expenses","operating costs","input costs","feed costs","hay costs","silage costs","supplementary feeding","feeding costs","snowmobile costs","snowmobile fuel","atv costs","quad bike costs","vehicle costs","fuel costs","transport costs","reindeer herding costs","calving costs","fencing costs","reindeer enclosure costs","paliskunta fees","cooperative fees","insurance costs","depreciation","machinery depreciation","building depreciation","labour requirement","labour costs","wage claim","family labour","financing costs","interest costs","capital costs","cost efficiency","economic inputs","reindeer production" ] }, { "id": 10, "label": { "fi": "Eloporot", "sv": "Renantal", "en": "Live reindeers"}, "description": "Presents the herd structure and animal numbers in reindeer husbandry. Contains the number of live reindeer, breeding females, breeding males, young reindeer and calves. Use this report when information is requested about herd size, herd composition, production structure or the animal population in reindeer husbandry.", "tags": [ "reindeer","live reindeer","reindeer herd","herd size","herd structure","animal numbers","reindeer population","breeding females","female reindeer","does","vaadin","breeding males","male reindeer","hirvas","young reindeer","pailakka","calves","reindeer calves","calf production","calving rate","animal structure","livestock numbers","reindeer production","reindeer husbandry","reindeer management","herd composition","breeding herd" ] }, { "id": 12, "label": { "fi": "Työpanos", "sv": "Arbetstimmar", "en": "Labour input"}, "description": "Presents labour input and working hours in reindeer husbandry, including reindeer herding work and cooperative (paliskunta) work performed by the farm family and hired labour. Contains total labour input and the distribution of labour between reindeer management and cooperative activities. Use this report when information is requested about labour use, workload, family labour or labour allocation in reindeer husbandry.", "tags": [ "reindeer husbandry","reindeer work","labour input","labor input","working hours","workload","family labour","family labor","family workforce","farm family work","reindeer herding work","herding work","paliskunta work","reindeer cooperative work","cooperative activities","labour allocation","work distribution","labour hours","labor hours","work input","annual workload","hired labour","hired labor","employment","workforce","reindeer management","reindeer enterprise","labour productivity","time use","working time" ] }, { "id": 16, "label": { "fi": "Tukierittely", "sv": "Stödspecifikation", "en": "Subsidies"}, "description": "Presents subsidies and support payments received by reindeer husbandry enterprises, including live reindeer support and investment support. Contains total subsidy amounts and the share of subsidies in total returns. Use this report when information is requested about support levels, subsidy dependency, public funding or the economic significance of subsidies in reindeer husbandry.", "tags": [ "reindeer husbandry","reindeer subsidies","subsidies","support payments","public support","government support","live reindeer support","reindeer support","investment support","investment subsidy","all subsidies","total subsidies","support level","support dependency","subsidy dependency","subsidy share","support share","subsidies as percentage of income","subsidies as percentage of revenue","public funding","state support","agricultural support","northern support","economic significance of subsidies","reindeer enterprise","reindeer economy","support income","profitability support" ] }] }, "distribution": { "semanticRole": "result-grouping", "description": { "fi": "Hajontavalinta määrittää tuloksiin muodostettavat vertailuryhmät. Kun valitaan muu kuin vain keskiarvot, luokittelijanro määrittää muuttujan, jonka perusteella havaintoyksiköt jaetaan vertailuryhmiin. Luokittelija ei rajaa raportoitavia tunnuslukuja, vaan määrittää ryhmät, joille valitun raportin tulokset esitetään. Hajontaryhmien käyttö tuottaa jokaiselle valinnalle kolme tulossaraketta keskiarvon yhden sarakkeen sijasta, joten tulostaulukko voi kasvaa huomattavasti leveämmäksi.", "sv": "Spridningsvalet bestämmer vilka jämförelsegrupper som bildas i resultaten. När något annat än endast medelvärden väljs anger luokittelijanro den variabel som används för att dela in observationsenheterna i jämförelsegrupper. Klassificeraren begränsar inte vilka nyckeltal som rapporteras, utan bestämmer de grupper för vilka resultaten i den valda rapporten visas. Användning av spridningsgrupper ger tre resultatkolumner för varje val i stället för en kolumn för medelvärdet, vilket kan göra resultattabellen betydligt bredare.", "en": "The distribution selection determines the comparison groups included in the results. When an option other than averages only is selected, luokittelijanro specifies the variable used to divide observation units into comparison groups. The classifier does not restrict the reported indicators; it determines the groups for which the selected report results are presented. Using distribution groups produces three result columns for each selection instead of the single average column, so the resulting table can become considerably wider." }, "classifier": { "parameter": "luokittelijanro", "requiredWhen": "distribution other than averages only", "allowedValues": [ { "id": 2, "label": { "fi": "Kannattavuuskerroin", "sv": "Lönsamhetskoefficient", "en": "Profitability Ratio" } }, { "id": 3, "label": { "fi": "Yrittäjätulo", "sv": "Lantbruksinkomst", "en": "Entrepreneur's income" } }, { "id": 4, "label": { "fi": "Kokonaistuotto", "sv": "Bruttointäkter", "en": "Gross Return" } }, { "id": 5, "label": { "fi": "Eloporomäärä", "sv": "Antal livrenar", "en": "Number of live reindeer" } } ] }, "allowedCombinations": [ { "label": { "fi": "Vain keskiarvot", "sv": "Bara medelvärden", "en": "Only averages" }, "note": { "fi": "Tuloksissa esitetään vain keskiarvot. Luokittelijaa ei käytetä.", "sv": "Resultaten visar endast medelvärden. Ingen klassificerare används.", "en": "Only average values are presented. No classifier is used." }, "lisa": 1, "ptyyppi": 1, "hhtark": "4,6,8", "classifierRequired": false }, { "label": { "fi": "Myös hyvät/heikot -ryhmät", "sv": "Också bra/svaga -grupper", "en": "Also weak/strong -groups" }, "note": { "fi": "Tuloksissa esitetään keskiarvon lisäksi luokittelijan perusteella muodostetut hyvät 75–95 % ja heikot 5–25 % -ryhmät.", "sv": "Resultaten visar utöver medelvärdet även grupperna bra 75–95 % och svaga 5–25 %, bildade enligt den valda klassificeraren.", "en": "In addition to the average, the results include high 75–95% and low 5–25% groups formed using the selected classifier." }, "lisa": 2, "ptyyppi": 1, "hhtark": "4,6,8", "classifierRequired": true }, { "label": { "fi": "Myös parhaat/heikoimmat", "sv": "Också de bästa/svagaste -grupper", "en": "Also the best/weakest -groups" }, "note": { "fi": "Tuloksissa esitetään keskiarvon lisäksi luokittelijan perusteella muodostetut parhaimmat 5 % ja heikoimmat 5 % -ryhmät.", "sv": "Resultaten visar utöver medelvärdet även de bästa 5 % och de svagaste 5 % grupperna, bildade enligt den valda klassificeraren.", "en": "In addition to the average, the results include the top 5% and bottom 5% groups formed using the selected classifier." }, "lisa": 2, "ptyyppi": 1, "hhtark": "2,6,10", "classifierRequired": true } ] }, "nayta": { "type": "string", "required": true, "allowedValues": [ "laheta" ] } }, "dimensions": [ { "id": 1, "name": { "fi": "Tilikausi", "sv": "Räkenskapsår", "en": "Accounting period" }, "note": { "fi": "Tiedot esitetään tilikausittain. Tilikausi merkitään muodossa VVVV/VVVV, esimerkiksi 2022/2023. Merkintä tarkoittaa yhtä tilikautta, ei kahta erillistä kalenterivuotta. Mukana ovat vain toteutuneet tilikaudet; ennakko- ja ennustetietoja ei ole.", "sv": "Uppgifterna redovisas per räkenskapsår. Räkenskapsåret anges i formatet ÅÅÅÅ/ÅÅÅÅ, till exempel 2022/2023. Beteckningen avser ett räkenskapsår, inte två separata kalenderår. Endast realiserade räkenskapsår ingår; preliminära uppgifter och prognoser ingår inte.", "en": "Data is reported by accounting period. Accounting periods are expressed in YYYY/YYYY format, for example 2022/2023. The notation represents one accounting period, not two separate calendar years. Only realized accounting periods are included; preliminary data and forecasts are not included." }, "values": [{ "id": 25, "label": "2022/2023" },{ "id": 24, "label": "2021/2022" },{ "id": 23, "label": "2020/2021" },{ "id": 22, "label": "2019/2020" },{ "id": 21, "label": "2018/2019" },{ "id": 20, "label": "2017/2018" },{ "id": 19, "label": "2016/2017" },{ "id": 18, "label": "2015/2016" },{ "id": 17, "label": "2014/2015" },{ "id": 16, "label": "2013/2014" },{ "id": 15, "label": "2012/2013" },{ "id": 14, "label": "2011/2012" },{ "id": 13, "label": "2010/2011" },{ "id": 12, "label": "2009/2010" },{ "id": 11, "label": "2008/2009" },{ "id": 10, "label": "2007/2008" },{ "id": 9, "label": "2006/2007" },{ "id": 8, "label": "2005/2006" },{ "id": 7, "label": "2004/2005" },{ "id": 6, "label": "2003/2004" },{ "id": 5, "label": "2002/2003" }] }, { "id": 18, "name": { "fi": "Poronhoitoalue, 2-jako", "sv": "Renskötselområde", "en": "Reindeer husbandry area" }, "values": [{ "id": 1, "label": "Reindeer husbandry area" },{ "id": 2, "label": "Other reindeer husbandry area" }] }, { "id": 32, "name": { "fi": "Poronhoitoalue, 3-jako", "sv": "Sameområde", "en": "Samiarea" }, "values": [{ "id": 1, "label": "Samiarea" },{ "id": 2, "label": "Ohter northern area" },{ "id": 3, "label": "Other reindeer husbandry area" }] }, { "id": 33, "name": { "fi": "Merkkipiiri", "sv": "Märkesdistrikt", "en": "Merkkipiiri" }, "values": [{ "id": 1, "label": "Utsjoki" },{ "id": 2, "label": "Inari" },{ "id": 3, "label": "Enontekiö" },{ "id": 4, "label": "Pallastunturi" },{ "id": 5, "label": "Kittilä" },{ "id": 6, "label": "Sodankylä" },{ "id": 7, "label": "Keminkylä" },{ "id": 8, "label": "Salla" },{ "id": 9, "label": "Raudanjoki" },{ "id": 10, "label": "Läntinen" },{ "id": 11, "label": "Itäkemijoki" },{ "id": 12, "label": "Kuusamo" },{ "id": 13, "label": "Pudasjärvi" },{ "id": 14, "label": "Kainuu" }] }, { "id": 34, "name": { "fi": "Merkkipiirialue", "sv": "Märkekretsområde", "en": "Markdistrict" }, "values": [{ "id": 1, "label": "Markdistrict Utsjoki-inari" },{ "id": 2, "label": "Markdistrict Enontekiö-Pallastunturi-Kittilä" },{ "id": 3, "label": "Markdistrict Raudanjoki-Läntinen-Itäkemijoki" },{ "id": 4, "label": "Markdistrict Sodankylä-Keminkylä-Salla" },{ "id": 5, "label": "Markdistrict Kuusamo-Pudasjärvi-Kainuu" }] }, { "id": 35, "name": { "fi": "Eloporomäärä", "sv": "Antal livrenar", "en": "Number of live reindeer" }, "values": [{ "id": 4, "label": "80-100 (rather small)" },{ "id": 5, "label": "100-130 (average)" },{ "id": 6, "label": "130-180 (rather large)" },{ "id": 7, "label": "180-230 (large)" },{ "id": 8, "label": ">230 (very large)" }] } ], "examples": [ { "description": { "fi": "Paljonko poronhoitajat saivat vahingonkorvauksia tilikaudella 2021/2022?", "sv": "Hur mycket skadeersättning fick renskötarna under räkenskapsåret 2021/2022?", "en": "How much compensation for damages did reindeer herders receive during the accounting period 2021/2022?" }, "request": { "method": "GET", "url": { "fi": "https://taloustohtori.luke.fi/porotalous/omat-valinnat/?tulostus=5&nayta=laheta&dim1paataso=1&dim1alataso=24&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8", "sv": "https://taloustohtori.luke.fi/sv/renhushallning/egna-val/?tulostus=5&nayta=laheta&dim1paataso=1&dim1alataso=24&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8", "en": "https://taloustohtori.luke.fi/en/reindeer-economy/own-criteria/?tulostus=5&nayta=laheta&dim1paataso=1&dim1alataso=24&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8" } } }, { "description": { "fi": "Miten tuloslaskelman luvut eroavat kannattavuudeltaan parhaimman ja heikoimman neljänneksen välillä tilikaudella 2022/2023?", "sv": "Hur skiljer sig resultaträkningens uppgifter mellan den bästa och svagaste kvartilen enligt lönsamhet under räkenskapsåret 2022/2023?", "en": "How do the income statement results differ between the top and bottom profitability quartiles in accounting period 2022/2023?" }, "request": { "method": "GET", "url": { "fi": "https://taloustohtori.luke.fi/porotalous/omat-valinnat/?tulostus=1&nayta=laheta&dim1paataso=1&dim1alataso=25&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=2&ptyyppi=5&hhtark=4,6,8&luokittelijanro=2", "sv": "https://taloustohtori.luke.fi/sv/renhushallning/egna-val/?tulostus=1&nayta=laheta&dim1paataso=1&dim1alataso=25&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=2&ptyyppi=5&hhtark=4,6,8&luokittelijanro=2", "en": "https://taloustohtori.luke.fi/en/reindeer-economy/own-criteria/?tulostus=1&nayta=laheta&dim1paataso=1&dim1alataso=25&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=2&ptyyppi=5&hhtark=4,6,8&luokittelijanro=2" } } }, { "description": { "fi": "Kannattavuuskerroin tilikausilla 2018/2019–2022/2023", "sv": "Lönsamhetskvot för räkenskapsåren 2018/2019–2022/2023", "en": "Profitability ratio for accounting periods 2018/2019–2022/2023" }, "request": { "method": "GET", "url": { "fi": "https://taloustohtori.luke.fi/porotalous/omat-valinnat/?tulostus=2&nayta=laheta&dim1paataso=1&dim1alataso=25,24,23,22,21&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8", "sv": "https://taloustohtori.luke.fi/sv/renhushallning/egna-val/?tulostus=2&nayta=laheta&dim1paataso=1&dim1alataso=25,24,23,22,21&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8", "en": "https://taloustohtori.luke.fi/en/reindeer-economy/own-criteria/?tulostus=2&nayta=laheta&dim1paataso=1&dim1alataso=25,24,23,22,21&dim2paataso=0&dim2alataso=0&dim3paataso=0&dim3alataso=0&dim4paataso=0&dim4alataso=0&lisa=1&ptyyppi=1&hhtark=4,6,8" } } } ], "dimensionCoverage": { "fi": "Tämä metadata voi sisältää vain osajoukon palvelun käytettävissä olevista dimensioista.", "sv": "Denna metadata kan innehålla endast en delmängd av tillgängliga dimensioner.", "en": "This metadata may contain only a subset of the dimensions available in the service." }, "agentGuidance": { "fi": [ "Käytä vain dokumentoituja parametreja", "GET on suositeltava indeksointiin", "Tulokset generoidaan reaaliajassa", "Dimensioiden arvot voivat muuttua automaattisesti Oracle-tietokannan mukaan", "AI-agentit voivat muodostaa omia aikasarjojaan valitsemalla yhden tai useamman tilikauden.", "Taulukon leveys kasvaa valittujen dimensioarvojen yhdistelmien mukaan. AI-agenttien tulee välttää tarpeettoman laajoja valintajoukkoja.", "Alueelliset luokitukset perustuvat paliskuntiin.", "Poronhoitoalueet ja muut aluejaot muodostuvat paliskunnista.", "Aluedimensioiden yhdistämisestä ks. queryRules.combinationRules ja sarakerajan laskennasta response.resultLimits." ], "sv": [ "Använd endast dokumenterade parametrar", "GET rekommenderas för indexering", "Resultaten genereras i realtid", "Dimensionsvärden kan ändras automatiskt baserat på Oracle-databasen.", "AI-agenter kan skapa egna tidsserier genom att välja ett eller flera räkenskapsår.", "Antalet kolumner ökar enligt kombinationerna av valda dimensionsvärden. AI-agenter bör undvika onödigt omfattande urval.", "Regionala klassificeringar baseras på renbeteslag (paliskunta).", "Renskötselområden och andra regionala indelningar bildas av renbeteslag.", "För kombination av regionala dimensioner, se queryRules.combinationRules, och för beräkning av kolumngränsen, se response.resultLimits." ], "en": [ "Use only documented parameters", "GET is recommended for indexing", "Results are generated in real time", "Dimension values may change automatically according to the Oracle database", "AI agents may construct custom time series by selecting one or more accounting periods.", "Table width increases according to the combinations of selected dimension values. AI agents should avoid unnecessarily large selections.", "Regional classifications are based on reindeer herding cooperatives (paliskunta).", "Reindeer husbandry areas and other regional classifications are formed from reindeer herding cooperatives.", "For combining regional dimensions see queryRules.combinationRules, and for the column limit calculation see response.resultLimits." ] } }