{
  "service": {
    "id": "maa_ja_puutarhatalous",
    "metadataVersion": "1.0",
    "name": {
      "fi": "Maa- ja puutarhatalous",
      "sv": "Jord- och trädgårdsbruk",
      "en": "Agriculture and Horticulture"
    },
    "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"
    },
    "queryModel": "dimension-based",
    "generated": "2026-09-15T16:43:35Z"
  },

  "endpoints": {
    "query": {
      "url": {
        "fi": "https://taloustohtori.luke.fi/maa_ja_puutarhatalous/omat-valinnat/",
        "sv": "https://taloustohtori.luke.fi/jordbruks-och-tradgardsproduktion/egna-val/",
        "en": "https://taloustohtori.luke.fi/agriculture-and-horticulture/own-criteria/"
      },
      "methods": [
        "GET",
        "POST"
      ]
    }
  },

  "queryStructure": {
    "type": "flexible-dimension-order",

    "dimensionParameters": [
      {
        "main": "dim1paataso",
        "mainType": "integer",
        "sub": "dim1alataso",
        "subType": "string"
      },
      {
        "main": "dim2paataso",
        "mainType": "integer",
        "sub": "dim2alataso",
        "subType": "string"
      }
    ],

    "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": [
      "27",
      "1,2",
      "1,2,3,4"
      ]
    },

  "queryRules": {
    "minimumDimensions": 1,

    "requiredDimensions": [
      {
        "dimensionId": 1,
        "name": {
          "fi": "Vuosi",
          "sv": "År",
          "en": "Year"
        }
      }
    ],

    "rules": {
      "fi": [
        "Vähintään yksi pakollinen dimensio tulee sisällyttää",
        "Dimensioiden järjestys on joustava",
        "Dimensiovalinnat validoidaan palvelinpuolella"
      ],
      "sv": [
        "Minst en obligatorisk dimension måste inkluderas",
        "Dimensionernas ordning är flexibel",
        "Dimensionsval valideras på serversidan"
      ],
      "en": [
        "At least one required dimension must be included",
        "Dimension order is flexible",
        "Dimension selections are validated server-side"
      ]
    }
  },

  "response": {
    "contentType": "text/html",
    "primaryDataFormat": "html-table",
    "format": "html",
    "structure": "statistical-table",    
    "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": 2, "label": { "fi": "Tunnusluvut", "sv": "Ekonomiska nyckeltal", "en": "Financial Ratios" } },{ "id": 32, "label": { "fi": "Tunnusluvut  2", "sv": "Nyckeltal 2", "en": "Key Figures 2" } },{ "id": 1, "label": { "fi": "Tuloslaskelma", "sv": "Resultaträkning", "en": "Income Statement" } },{ "id": 3, "label": { "fi": "Taselaskelma", "sv": "Balansräkning", "en": "Balance Sheet" } },{ "id": 5, "label": { "fi": "Tuottoerittely", "sv": "Intäkterspecifikationer", "en": "Revenues" } },{ "id": 37, "label": { "fi": "Tukierittely", "sv": "Stödspecifikationer ", "en": "Subsidies" } },{ "id": 8, "label": { "fi": "Kustannuserittely ", "sv": "Kostnadsspecifikatio", "en": "Costs Specification" } },{ "id": 11, "label": { "fi": "Maksuvalmiuslaskelma", "sv": "Likviditetsräkning", "en": "Liquidity" } },{ "id": 6, "label": { "fi": "Viljelyalat", "sv": "Odlingsarealer", "en": "Arable Land" } },{ "id": 10, "label": { "fi": "Kotieläimet", "sv": "Husdjur", "en": "Livestock " } },{ "id": 12, "label": { "fi": "Työpanos", "sv": "Arbetstimmar", "en": "Working Hours" } },{ "id": 14, "label": { "fi": "FADN tulokset", "sv": "FADN resultater", "en": "FADN results" } },{ "id": 23, "label": { "fi": "Tunnusluvut -FADN", "sv": "Nyckeltal -FADN", "en": "Financial Ratios -FADN" } },{ "id": 22, "label": { "fi": "Tuloslaskelma -FADN", "sv": "Resultaträkning -FADN", "en": "Income Statement -FADN" } },{ "id": 24, "label": { "fi": "Taselaskelma -FADN", "sv": "Balansräkning -FADN", "en": "Balance sheet -FADN" } },{ "id": 25, "label": { "fi": "Tuotot -FADN", "sv": "Intäkter -FADN", "en": "Revenues -FADN" } },{ "id": 31, "label": { "fi": "Tuet -FADN", "sv": "Stöd -FADN", "en": "Subsidies  -FADN" } },{ "id": 27, "label": { "fi": "Kustannukset -FADN", "sv": "Produktionskostnader -FADN", "en": "Costs -FADN" } },{ "id": 26, "label": { "fi": "Viljelyalat -FADN", "sv": "Odlingsarealer -FADN", "en": "Arable land -FADN" } },{ "id": 28, "label": { "fi": "Hehtaarisadot Lannoitteet -FADN", "sv": "Skördar. Gödningsmedel -FADN", "en": "Yields. Fertilizer -FADN" } },{ "id": 29, "label": { "fi": "Tuotantoeläimet -FADN", "sv": "Husdjur -FADN", "en": "Livestock -FADN" } },{ "id": 30, "label": { "fi": "Työpanos -FADN", "sv": "Arbetstimmar -FADN", "en": "Work units  -FADN" } }]
    },

    "nayta": {
      "type": "string",
      "required": true,
      "allowedValues": [
        "laheta"
      ]
    }
  },

  "dimensions": [
    {
	"id": 1, "name": { "fi": "Vuosi", "sv": "År", "en": "Accounting year" }, "values": [{ "id": 27, "label": "2024" },{ "id": 26, "label": "2023" },{ "id": 25, "label": "2022" },{ "id": 24, "label": "2021" },{ "id": 23, "label": "2020" },{ "id": 22, "label": "2019" },{ "id": 21, "label": "2018" },{ "id": 20, "label": "2017" },{ "id": 19, "label": "2016" },{ "id": 18, "label": "2015" },{ "id": 17, "label": "2014" },{ "id": 16, "label": "2013" },{ "id": 15, "label": "2012" },{ "id": 14, "label": "2011" },{ "id": 13, "label": "2010" },{ "id": 12, "label": "2009" },{ "id": 11, "label": "2008" },{ "id": 10, "label": "2007" },{ "id": 9, "label": "2006" },{ "id": 8, "label": "2005" },{ "id": 7, "label": "2004" },{ "id": 6, "label": "2003" },{ "id": 5, "label": "2002" },{ "id": 4, "label": "2001" },{ "id": 3, "label": "2000" }]
    },

    {
    "id": 2, "name": { "fi": "Tukialue", "sv": "Stödområde", "en": "Subsidy Region" }, "values": [{ "id": 1, "label": "A" },{ "id": 2, "label": "B" },{ "id": 3, "label": "C1" },{ "id": 4, "label": "C2" },{ "id": 5, "label": "C2p" },{ "id": 6, "label": "C3" },{ "id": 7, "label": "C4" }]
    }
  ],

  "examples": [
    {
      "description": {
        "fi": "Tunnusluvut vuodelta 2024 tukialueilla A ja B",
        "sv": "Nyckeltal för år 2024 i stödområde A och B",
        "en": "Key figures for year 2024 in support areas A and B"
      },

      "request": {
        "method": "GET",

        "url": {
          "fi": "https://taloustohtori.luke.fi/maa_ja_puutarhatalous/omat-valinnat/?tulostus=2&nayta=laheta&dim1paataso=1&dim1alataso=27&dim2paataso=2&dim2alataso=1,2",

          "sv": "https://taloustohtori.luke.fi/jordbruks-och-tradgardsproduktion/egna-val/?tulostus=2&nayta=laheta&dim1paataso=1&dim1alataso=27&dim2paataso=2&dim2alataso=1,2",

          "en": "https://taloustohtori.luke.fi/agriculture-and-horticulture/own-criteria/?tulostus=2&nayta=laheta&dim1paataso=1&dim1alataso=27&dim2paataso=2&dim2alataso=1,2"
        }
      }
    }
  ],
  
  "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"
    ],

    "sv": [
      "Använd endast dokumenterade parametrar",
      "GET rekommenderas för indexering",
      "Resultaten genereras i realtid",
      "Dimensionsvärden kan ändras automatiskt baserat på Oracle-databasen."
    ],

    "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"
    ]
  }
}