Datum 2016-03-08 1(10) Skogliga grunddata samt datum för laserskanning teknisk specifikation Dokumentversion 1.0 Innehåll Skogliga grunddata samt datum för laserskanning teknisk specifikation... 1 Gränssnittsdefinition... 2 Åtkomstpunkt produktion... 2 Informationsslag... 2 Frågor och svar... 3 Implementerade RasterFunctions... 3 Användningsområden... 5 Eempel på användbara operationer via REST... 6 Skogliga grunddata - teknisk beskrivning Postadress Besöksadress Telefon Organisationsnr E-post Huvudkontor Vallgatan 8 036-35 93 00 202100-5612 skogsstyrelsen@skogsstyrelsen.se Skogsstyrelsen Jönköping Fa Momsreg.nr www.skogsstyrelsen.se 551 83 Jönköping 036-16 61 70 SE202100561201
Skogsstyrelsen 2016-02-24 2(10) Gränssnittsdefinition Åtkomstpunkt produktion https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/imageserver https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/wmsserver http://geodpags.skogsstyrelsen.se/arcgis/rest/services/geodataportal/geodataportalvisadatumlaserskanning_ 1_0/MapServer Informationsslag Lager Beskrivning GeoService med Skogliga grunddata som 7-bands bild band Skogliga grunddata Band 1 = Volym Band 2 = Medelhöjd (grundytevägd) Band 3 = Grundyta Band 4 = Medeldiameter (grundytevägd) Band 5 = Biomassa Laserskanningsdatum WMS-tjänst med datum för Lantmäteriets nationella laserskanning per 2.5 km ruta
Skogsstyrelsen 2016-02-24 3(10) Frågor och svar Implementerade RasterFunctions https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/imageserver /rasterfunctioninfos RasterFunction Biomassa Biomassa_gron Biomassa_gulrod DgvGy_Gy Gallringsinde_G16G22 Gallringsinde_G23G28 Gallringsinde_G29G34 Gallringsinde_G35G40 Gallringsinde_T14T17 Gallringsinde_T18T21 Gallringsinde_T22T25 Gallringsinde_T26T30 Medelhöjd Beskrivning Visar Biomassa (band 5) i enheten ton torrsubstans/ha. Används lämpligen för beräkningar av medelvärden och total biomassa per yta/bestånd samt för att ge information om biomassa i en enskild punkt. Visar Biomassa (band 5) i en glidande grön färgskala. Områden med Denna karta bör ej användas som underlag för beräkningar av medelvärden etc. Kartan visas lämpligen med en flygbild eller karta i bakgrunden. Visar Biomassa (band 5) i en glidande gul-röd färgskala. Områden med Denna karta bör ej användas som underlag för beräkningar av medelvärden etc. Kartan visas lämpligen med en flygbild eller karta i bakgrunden. Skapar en 2-bands bild där band 1 = Medeldiameter (dgv) Grundyta (Gy) och band 2= Grundyta (Gy). Används vid beräkning av medelvärde per yta/bestånd för Medeldiameter. För information om hur beräkningen av medeldiameter utförs, se eempel 3 i Användbara operationer via REST. Gallringsinde för GRAN på lågproduktiv medelgod mark för ståndortsinde G16-G22. Observera att användaren måste själv välja aktuell karta/rasterfunktion för olika ståndorter och att gallringsmallen i sig inte innehåller någon information om trädslag eller om området tidigare gallrats efter tidpunkten för laserskanning. Gallringsinde för GRAN på medelgod högproduktiv mark för ståndortsinde G23-G28. Observera att användaren måste själv välja aktuell karta/rasterfunktion för olika ståndorter och att gallringsmallen i sig inte innehåller någon information om trädslag eller om området tidigare gallrats efter tidpunkten för laserskanning. Gallringsinde för GRAN på högproduktiv mark för ståndortsinde G29- G34. Observera att användaren måste själv välja aktuell karta/asterfunktion för olika ståndorter och att gallringsmallen i sig inte innehåller någon information om trädslag eller om området tidigare gallrats efter tidpunkten för laserskanning. Gallringsinde för GRAN på mycket högproduktiv mark för ståndortsinde G35-G40. Observera att användaren måste själv välja aktuell karta/asterfunktion för olika ståndorter och att gallringsmallen i sig inte innehåller någon information om trädslag eller om området tidigare gallrats efter tidpunkten för laserskanning. Gallringsinde för TALL på lågproduktiv mark för ståndortsinde T14-T17. Observera att användaren måste själv välja aktuell karta/asterfunktion för olika ståndorter och att gallringsmallen i sig inte innehåller någon information om trädslag eller om området tidigare gallrats efter tidpunkten för laserskanning. Gallringsinde för TALL på lågproduktiv medelgod mark för ståndortsinde T18-T21. Observera att användaren måste själv välja aktuell karta/asterfunktion för olika ståndorter och att gallringsmallen i sig inte innehåller någon information om trädslag eller om området tidigare gallrats efter tidpunkten för laserskanning. Gallringsinde för TALL på medelgod mark för ståndortsinde T22-T25. Observera att användaren måste själv välja aktuell karta/asterfunktion för olika ståndorter och att gallringsmallen i sig inte innehåller någon information om trädslag eller om området tidigare gallrats efter tidpunkten för laserskanning. Gallringsinde för TALL på högproduktiv mark för ståndortsinde T26-T30. Observera att användaren måste själv välja aktuell karta/asterfunktion för olika ståndorter och att gallringsmallen i sig inte innehåller någon information om trädslag eller om området tidigare gallrats eller tidpunkten för laserskanning. Visar Grundytevägd medelhöjd (band 2) i enheten decimeter. Används för att ge information om medelhöjd i en enskild punkt. Bör ej användas för
Skogsstyrelsen 2016-02-24 4(10) beräkning av medelvärden för yta/bestånd utan för detta ändamål använd istället Raster Function HgvGy_Gy. Medelhöjd_gron Medelhöjd_gulrod Grundyta Grundyta_gron Grundyta_gulrod HgvGy_Gy Medeldiameter Medeldiameter_gron Medeldiameter_gulrod Volym Volym_gron Volym_gulrod Visar Medelhöjd (band 2) i en glidande grön färgskala. Områden med Denna karta/asterfunktion bör ej användas som underlag för beräkningar av medelvärden etc. Kartan/rasterfunktionen används lämpligen med en flygbild eller karta i bakgrunden. Visar Medelhöjd (band 2) i en glidande gul-röd färgskala. Områden med Denna karta/asterfunktion bör ej användas som underlag för beräkningar av medelvärden etc. Kartan/rasterfunktionen används lämpligen med en flygbild eller karta i bakgrunden. Visar Grundyta (band 3) i enheten centimeter. Används lämpligen för beräkningar av medelvärden per yta/bestånd samt för att ge information om grundyta i en enskild punkt. Visar Medelhöjd (band 2) i en glidande grön färgskala. Områden med Denna karta/rasterfunktion bör ej användas som underlag för beräkningar av medelvärden etc. Rasterfunktionen används lämpligen med en flygbild eller karta i bakgrunden. Visar Medelhöjd (band 2) i en glidande gul-röd färgskala. Områden med Denna karta/rasterfunktion bör ej användas som underlag för beräkningar av medelvärden etc. Kartan/rasterfunktionen används lämpligen med en flygbild eller karta i bakgrunden. Skapar en 2-bands bild där band 1 = Medelhöjd (Hgv) * Grundyta (Gy) och band 2= Grundyta (Gy). Används vid beräkning av medelvärde per yta/bestånd för Medelhöjd. För information om hur beräkningen av medelhöjd utförs, se eempel 3 i Användbara operationer via REST: Visar Grundytevägd medeldiameter (band 4) i enheten centimeter. Används för att ge information om medeldiameter i en enskild punkt. Bör ej användas för beräkning av medelvärden för yta/bestånd utan för detta ändamål använd istället Raster Function DgvGy_Gy. Visar Grundytevägd medeldiameter (band 4) i en glidande grön färgskala. Områden med medelhöjd träd < 3 m har satts till Null och visas som transparanta. OBS! Denna karta/rasterfunktion bör ej användas som underlag för beräkningar av medelvärden etc. Kartan/rasterfunktionen används lämpligen med en flygbild eller karta i bakgrunden. Visar Grundytevägd medeldiameter (band 4) i en glidande gul-röd färgskala. Områden med medelhöjd träd < 3 m har satts till Null och visas som transparanta. OBS! Denna karta/rasterfunktion bör ej användas som underlag för beräkningar av medelvärden etc. Kartan/rasterfunktionen används lämpligen med en flygbild eller karta i bakgrunden. Visar Volym (band 1) i enheten m3sk/ha. Används lämpligen för beräkningar av medelvärden och totalvolym per yta/bestånd samt för att ge information om volym i en enskild punkt. Visar Volym (band 1) i en glidande grön färgskala. Områden med Denna karta/rasterfunktion bör ej användas som underlag för beräkningar av medelvärden etc. Kartan/rasterfunktionen används lämpligen med en flygbild eller karta i bakgrunden. Visar Volym (band 1) i en glidande gul-röd färgskala. Områden med Denna karta/rasterfunktion bör ej användas som underlag för beräkningar av medelvärden etc. Kartan/rasterfunktionen används lämpligen med en flygbild eller karta i bakgrunden.
Skogsstyrelsen 2016-02-24 5(10) Användningsområden RasterFunction Visning i karta Beräkningar per yta/bestånd Bildvärde i piel Biomassa Biomassa_gron Biomassa_gulrod DgvGy_Gy Gallringsinde_G16G22 Gallringsinde_G23G28 Gallringsinde_G29G34 Gallringsinde_G35G40 Gallringsinde_T14T17 Gallringsinde_T18T21 Gallringsinde_T22T25 Gallringsinde_T26T30 Medelhöjd Medelhöjd_gron Medelhöjd_gulrod Grundyta Grundyta_gron Grundyta_gulrod HgvGy_Gy Medeldiameter Medeldiameter_gron Medeldiameter_gulrod Volym Volym_gron Volym_gulrod
Skogsstyrelsen 2016-02-24 6(10) Eempel på användbara operationer via REST Eempel 1. Skicka förfrågan via REST-anrop för att identifiera Volym i en piel Koordinat: easting: 500000, northing: 6600000 Rasterfunktion: Volym Resource: identify Anrop med html+ JSON-svar: https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/imageserver/identify?geometry="":500000,"y":6600000&geometrytype=esrigeometrypoint&mosaicrule=&renderingrul e="rasterfunction":"volym"&pielsize=&time=&returngeometry=false&returncatalogitems=false&f= html Anrop med JSON-svar: https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/imageserver/identify?geometry="":500000,"y":6600000&geometrytype=esrigeometrypoint&mosaicrule=&renderingrul e="rasterfunction":"volym"&pielsize=&time=&returngeometry=false&returncatalogitems=false&f= pjson Svaret i JSON-format där volym-värdet redovisas i value. I det här fallet är volymen 53 m3sk/ha "objectid": 0, "name": "Piel", "value": "53", "location": "": 500000, "y": 6600000, "spatialreference": "wkid": 3006, "latestwkid": 3006, "properties": null, "catalogitems": null, "catalogitemvisibilities": [ ] Eempel 2. Skicka förfrågan via REST-anrop för beräkna (a) medelvolym och (b) total volym per bestånd Anrop med html- och JSON-svar: https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/imageserver/compu testatisticshistograms?geometrytype=esrigeometrypolygon&geometry="rings":[[[555137,6677080],[ 556459,6677080],[556459,6676000],[555137,6676000],[555137,6677080]]]&mosaicRule=&rendering Rule="rasterFunction":"Volym"&pielSize=&f=html Anrop med enbart JSON-svar: https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/imageserver/compu testatisticshistograms?geometrytype=esrigeometrypolygon&geometry="rings":[[[555137,6677080],[ 556459,6677080],[556459,6676000],[555137,6676000],[555137,6677080]]]&mosaicRule=&rendering Rule="rasterFunction":"Volym"&pielSize=&f=pjson Svaret i JSON-format:
Skogsstyrelsen 2016-02-24 7(10) "statistics": [ "min": 0, "ma": 760, "mean": 66.497703713423434, "standarddeviation": 97.526637595367433, "count": 7621, "median": 17.882352941176471, "mode": 0 ], "histograms": [ "size": 256, "min": 0, "ma": 760, "counts": [ 3742, 0, 0, 0,... 1 ] ] (a) Medelvolymen ges av informationen i gruppen statistics där värdet kopplas till mean. Enheten är definierad i beskrivningen av den använda rasterfunktionen. I det här fallet är det m 3 sk per hektar (b) Totalvolymen kan räknas ut på två sätt 1. Genom att använda arealuppgiften (observera att det är hektar som ska användas) från polygonet som skickades in och multiplicera det med medelvolymen. polygonarea (i hektar) mean = totalvolym 2. Genom att använda antalet pilar som beräkningen utförts på och multiplicera deras area med medelvolymen. mean count pielarea (i hektar) = totalvolym Kommentar: Erfarenheter har visat att noggrannheten och därigenom användbarheten av skogliga grunddata påverkas av beståndsavgränsningen. En slarvig beståndsavgränsning där man får med kantpilar med 0-värden påverkar medelvärdet för beståndet. För kantpilar gäller att de ingår i beräkningen om centroiden (pielns mittpunkt) ligger inom polygonen. Ett sätt att hantera dessa kanteffekter är att sätta PielSize till värdet 2 för att därigenom minska känsligheten för påverkan av kantpilar. OBS! Detta gäller främst bestånd < 5 ha. För större bestånd blir effekten av kantpilar marginell och en operation med 2 m upplösningen blir onödigt tung på servern. Eempel 3. Skicka förfrågan via REST-anrop beräkna medelhöjd per bestånd Grundytevägd medelhöjd (h) inom en polygon (i) beräknas enligt: h i Σhp, i g = Σg p, i p, i Där hp,i är höjd för piel p inuti polygon i och gp,i är Grundyta för piel p inuti polygon i. Beräkningen av grundytevägd medeldiameter sker på samma sätt där hp,i ersätts av dp,i i.
Skogsstyrelsen 2016-02-24 8(10) Figurerna nedan representerar rasterdata med grundytevägd medelhöjd (h) och Grundyta (g). Height (h) Basal area (g) Polygon i Polygon i Rasterfunktion: HgvGY_Gy Funktionen returnerar en bild som har två stycken band. I det första bandet finns för varje piel en multiplikation av den grundytevägda höjden och grundytan (Hgv * Gy) och i det andra bandet finns grundytan (Gy). Beståndet definieras av det polygon som skickas in till computestatisticshistogram. I det här fallet är polygonen en ring med fem brytpunkter där första och sista punkten är identiska. Anrop med html- och JSON-svar: https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/imageserver/compu testatisticshistograms?geometrytype=esrigeometrypolygon&geometry="rings":[[[555137,6677080],[ 556459,6677080],[556459,6676000],[555137,6676000],[555137,6677080]]]&mosaicRule=&rendering Rule="rasterFunction":"HgvGy_Gy"&pielSize=&f=html Anrop med enbart JSON-svar: https://geodata.skogsstyrelsen.se/arcgis/rest/services/publikt/skogligagrunddata/imageserver/compu testatisticshistograms?geometrytype=esrigeometrypolygon&geometry="rings":[[[555137,6677080],[ 556459,6677080],[556459,6676000],[555137,6676000],[555137,6677080]]]&mosaicRule=&rendering Rule="rasterFunction":"HgvGy_Gy"&pielSize=&f=pjson Svaret i JSON-format: "statistics": [ "min": 0, "ma": 15582, "mean": 1494.1896076630364, "standarddeviation": 2215.376344174434, "count": 7621, "median": 244.42352941176472,
Skogsstyrelsen 2016-02-24 9(10) "mode": 0, "min": 0, "ma": 53, "mean": 8.770502558719329, "standarddeviation": 10.593042391570341, "count": 7621, "median": 4.988235294117647, "mode": 0 ], Den grundytevägda medelhöjden för beståndet kan inte direkt läsas ut från de statistiska variablerna utan måste beräknas för att bli korrekt. Kvoten mellan medelvärdena i band ett respektive band två ger det korrekta värdet. Beståndets grundytevägda medelhöjd = mean (band1) / mean (band2) Samma förhållanden gäller för den grundytevägda medeldiametern. Eempel 4. Skicka fråga via HTML eller JSON för att ta reda på datum för laserskanning Anrop görs som en query mot lagret som i tjänsten heter VisaDatumlaserskanning_1_0. Fälten SkanningDatum och Lov (ej lövat = 0 lövat = 1), returneras i svaret. Ingen geometri returneras i svaret. Observera att datum returneras i numeriskt format och representeras i epoch format (antalet milisekunder sedan 1 januari 1970). Läs mer på http://www.epochconverter.com/. Koordinat: easting: 500000, northing: 6600000 Anrop med HTML som svar http://geodpags.skogsstyrelsen.se/arcgis/rest/services/geodataportal/geodataportalvisadatumlasersk anning_1_0/mapserver/0/query?where=&tet=&objectids=&time=&geometry=%7b%22%22%3a500 000%2C%22y%22%3A6600000%7D&geometryType=esriGeometryPoint&inSR=&spatialRel=esriSpat ialrelintersects&relationparam=&outfields=skanndatum%2c+lov&returngeometry=false&returntru ecurves=false&maallowableoffset=&geometryprecision=&outsr=&returnidsonly=false&returncoun tonly=false&orderbyfields=&groupbyfieldsforstatistics=&outstatistics=&returnz=false&returnm=fals e&gdbversion=&returndistinctvalues=false&resultoffset=&resultrecordcount=&f=html Anrop och svaret i JSON format http://geodpags.skogsstyrelsen.se/arcgis/rest/services/geodataportal/geodataportalvisadatumlasersk anning_1_0/mapserver/0/query?where=&tet=&objectids=&time=&geometry=%7b%22%22%3a500 000%2C%22y%22%3A6600000%7D&geometryType=esriGeometryPoint&inSR=&spatialRel=esriSpat ialrelintersects&relationparam=&outfields=skanndatum%2c+lov&returngeometry=false&returntru ecurves=false&maallowableoffset=&geometryprecision=&outsr=&returnidsonly=false&returncoun tonly=false&orderbyfields=&groupbyfieldsforstatistics=&outstatistics=&returnz=false&returnm=fals e&gdbversion=&returndistinctvalues=false&resultoffset=&resultrecordcount=&f=json "displayfieldname": "SKANN_OMR", "fieldaliases": "SkannDatum": "SkannDatum", "Lov": "Lov", "fields": [ "name": "SkannDatum", "type": "esrifieldtypedate",
Skogsstyrelsen 2016-02-24 10(10) "alias": "SkannDatum", "length": 36, "name": "Lov", "type": "esrifieldtypeinteger", "alias": "Lov" ], "features": [ "attributes": "SkannDatum": 1319328000000, "Lov": 1, "attributes": "SkannDatum": 1351382400000, "Lov": 0, "attributes": "SkannDatum": 1276732800000, "Lov": 1, "attributes": "SkannDatum": 1277251200000, "Lov": 1 ]