Anvisningar för användningen av Ryhti-systemets öppna gränssnitt
Via gränssnitten får du tillgång till öppna geodata i datasystemet för den byggda miljön. På den här sidan finns allmänna anvisningar för hur gränssnitten kan användas.
För att du ska kunna använda gränssnittstjänster måste du ha ett geodataprogram eller något annat program som gör begäran till gränssnittet.
Via gränssnitten får du alltid de senaste uppgifterna och du behöver inte ladda ner uppgifterna till din egen miljö.
Gränssnittsadresser
Du hittar gränssnittsadresserna på en undersida på Ryhti-webbplatsen som är avsedd för dem som utnyttjar informationen.
Adresserna finns också listade enligt INSPIRE-indelningen på Finlands miljöcentrals webbsida om geodatagränssnitt (Paikkatietorajapinnat).
Användningslicens och ansvar
Användningen av öppna gränssnitt är avgiftsfri.
Användningen kräver ingen API-nyckel, men om du tänker använda gränssnitten i en applikation som du utvecklat eller upprätthåller under en längre tid eller i någon annan lösning som orsakar belastning förutsätter vi användning av en applikationsspecifik identifierare.
Läs också med användarvillkoren för gränssnitten innan du tar i bruk tjänsterna.
Uppdatering av informationen
De uppgifter som gränssnitten erbjuder uppdateras en gång per dag.
Gränssnittstyper – WMS eller OGC?
Det finns två olika typer av gränssnitt. Välj den gränssnittstyp som passar ditt användningsändamål.
En kombination av olika gränssnitt är ofta en fungerande lösning: materialet som syns på kartan hämtas från WMS-tjänsten, men vid behov görs preciserande förfrågningar i OGC-gränssnittet. Ett exempel på detta är att det valda objektet framhävs på kartan, varvid endast det valda objektet har hämtats från OGC-gränssnittet.
WMS
WMS-tjänsterna är det bästa alternativet för kartvisualisering, eftersom de erbjuder bättre prestanda för både användarens applikation och kartverktyget.
Utöver kartvisualisering möjliggör WMS-gränssnittet förfrågningar om objektens egenskapsuppgifter vid en viss punkt med GetFeatureInfo-anrop.
Däremot är det inte möjligt att göra mer komplicerade förfrågningar (t.ex. utifrån områdesavgränsning eller egenskapsuppgifter). Förfrågningarna returnerar inte heller objektets geometri, dvs. lägesuppgifter. Mer information om hur man använder WMS-gränssnitt finns t.ex. i dokumentationen från GeoServer.
OGC API Features
En standardiserad OGC Api Feature-gränssnittstjänst som returnerar data i vektorformat.
Välj OGC-gränssnittet när det inte räcker med enbart visuell presentation av uppgifter och enkla förfrågningar om egenskapsuppgifter. Detta alternativ lämpar sig för situationer där du till exempel vill söka objekt i ett visst område, söka objekt som har en viss egenskapsuppgift eller få objektens geometri (koordinater) som svar.
Vektorgränssnitten har alltid begränsningar för maximiantalet objekt som ska returneras. Detta innebär att man vid användning av dem ska se till att anropen delas upp (paginering).
OGC API Features är ett modernare utförande som i stor utsträckning motsvarar tidigare WFS-tjänster (OGC Web Feature Service).
Metadatabeskrivningar
I metadatabeskrivningarna ser du närmare information om Finlands miljöcentrals material och tjänster. Det finns egna beskrivningar för de öppna gränssnitten.
Störningsinformation
Man strävar efter att minimera driftsavbrotten i gränssnitten. Eventuella avbrott meddelas i störningsmeddelandena på Ryhti-webbplatsen.
Vanliga frågor
Hur kommer jag igång med OGC API Features-gränssnitten?
Du kan granska uppgifterna i ett gränssnitt genom att gå till dess adress med webbläsaren.
T.ex. https://paikkatiedot.ymparisto.fi/geoserver/ryhti_permit/ogc/features/v1
Du kommer först till landningssidan. På undersidorna hittar du följande information.
- API definition: tjänstens gränssnittsbeskrivning
- Collections: beskrivning av tjänstens samlingar, dvs. materialhelheter
- Conformance: kompatibilitetslista
- Contact information: kontaktuppgifter
Med vilken programvara kan jag testa gränssnitten?
Du kan testa gränssnitten med det geodataprogram du använder.
Om du inte har ett geodataprogram rekommenderar vi att du testar ett avgiftsfritt QGIS-program som grundar sig på öppen källkod.
Du kan också testa OGC API Features-gränssnitten med webbläsaren genom att skriva in gränssnittets adress i webbläsarens adressrad och avgränsa sökningen med parametrar.
Varför är materialet inte tillgängligt i CSV-format?
Materialet kan hämtas direkt via gränssnitten. Materialet uppdateras dagligen, så genom att använda gränssnitten kan man försäkra sig om att det alltid finns aktuellt material.
Jag kunde söka endast 3 000 byggobjekt i gränssnittet. Hur kan jag hämta resten?
För sökningen av objekt har en gräns på 3 000 objekt fastställts för att undvika överbelastning. Genom att koppla anropen till varandra kan du söka flera objekt.
Till exempel kan geodataprogrammet QGIS söka objekt i delar. Om du anropar gränssnittet på annat sätt kan du söka objekten genom att använda sidindelning (paginering). Sidindelning kan fås inbyggd i standarden OGC API Features.
Om du inte kan söka fler än 3 000 objekt, försök lägga till parametern &limit=3000 efter anropet. Detta lägger till en länk till sökningen av följande sida i svaret.
Exempelanrop
https://paikkatiedot.ymparisto.fi/geoserver/ryhti_building/ogc/features/v1/collections/open_address/items?&limit=3000
Jag vill endast söka byggobjekt i en viss kommun i gränssnittet. Går det att göra så?
Du kan göra avgränsningen i ditt geodataprogram eller pröva direkt med parametrar som läggs till OGC API Features-gränssnittets adress. Gör avgränsningen genom att till exempel utnyttja kommunkoden eller områdesavgränsningen (bounding box, bbox).
Exempel: avgränsning till byggnaderna i Vasa
/items?filter=municipality_number=905&limit=3000
Exempel: områdesavgränsning
Avgränsning med områdesavgränsning, dvs. bounding box, så att det område som söks är avgränsat enligt Finlands officiella koordinatsystem (ETRS TM35FIN, dvs. EPSG:3067).
/items?bbox=490000,6904000,492000,6906000&bbox-crs=http://www.opengis.net/def/crs/EPSG/0/3067&limit=3000