Stationsregistret - Handledning v0.5

Transkript

1 v

2 1 (39) Version Datum Ändring Sign Första versionen av handledningen. Sweco NV-GIS länkarna borttagna. Nya skärmdumpar tillagda Tidigare användarhandledning uppdateras med ny mall. Texten omarbetas GIS-kapitlet från Martin S inlagt och uppdaterat. AF AF AF Granskad, kommenterad. HDA 0.4 Ändringar föreslagna av HDA införda. AF Kap 4, Redigera PP med REST-API tillagt AP/AF

3 2 (39) Innehållsförteckning 1 Målgrupper för denna handledning 4 2 Använda Stationsregistret Söka information om Övervakningsstationer (Ej klar) Söka information om enstaka Provplatser i kartan Visa position för enstaka Provplatser i kartan Söka fram ett urval av provplatser Sökbara attribut för Provplatser Exportera Provplatser efter urval Exportera Provplatser per Datavärd/SSM eller Media Exportera Provplatser med hjälp av WFS Jämföra egna provplatser mot Stationsregistrets provplatser Använda koordinatsök Använda professionell koordinat-omvandlare 15 3 Redigera Stationsregistret Redigera enstaka provplatser Redigera provplatser genom excel-uppladdning Excelfilen för redigering - attribut och förklaring Lägg till provplats <10 m från befintlig (Forcera) Ta bort en befintlig provplats (Aktiv = FALSKT) Ladda upp hemliga provplatser (Hemlig) Respons efter att Exceluppladdning är utförd 22 4 Redigera provplatser med REST-API URL Autentisering Funktioner Skapa ny provplats Uppdatera en existerande provplats Inaktivera en provplats Modell Exempel Skapa ny provplats Uppdatera en provplats Uppdatera en provplats från annat koordinatsystem 28 5 Använda Stationsregistrets API:er API 29

4 3 (39) 5.2 WFS-tjänster PROD: Produktionsmiljön AT: Testmiljön DEV: Utvecklingsmiljön Publicerade WFS-lager Uppkoppling till WFS-tjänst med QGIS Avståndsanalys. Jämföra egna PP mot Stationsregistrets PP. 35

5 4 (39) 1 Målgrupper för denna handledning Målgrupper för denna handledning är: Beställare av miljöövervakningsuppdrag eller motsvarande Utförare Datavärdarna, Strålsäkerhetsmyndigheten (SSM), Jordbruksverket (SJV) Andra användare För närmare beskrivning av dessa roller/användare, se Stationsregistrets översiktliga beskrivning i huvuddokumentet. 2 Använda Stationsregistret De viktigare funktionerna i webbapplikationen förklaras i kapitlen som följer. Ofta refereras till de siffror som finns angivna i Figur 1 nedan. Figur 1. Stationsregistrets ingångssida med viktigare funktioner angivna med siffra.

6 5 (39) 2.1 Söka information om Övervakningsstationer (Ej klar) Återstår att beskriva 2.2 Söka information om enstaka Provplatser i kartan Klicka i vänsterpanelen på namnet Provplatser [2]. Då görs lagret aktivt. Använd kartverktyget för att zooma in i det område du vill studera. För att se information om enstaka provplatser, markera (Identifiera) i verktygsraden [5]. Klicka därefter på den provplats du vill veta mer om i kartan. Det går att jämföra två närliggande provplatser utan att den ena informationsrutan döljer den som är bakom. Klicka på lilla häftstiftet, dra sedan informationsrutan åt sidan. Se resultat i Figur 2. Figur 2. Information om enstaka provplats eller station.

7 6 (39) 2.3 Visa position för enstaka Provplatser i kartan Genom att klicka på en rad i tabellen dvs en provplats, så visas provplatsen i kartan med en fyrkant runt, Figur 3. Figur 3. Badplatsen med namnet Kairo visas i kartan med fyrkant runt efter att den markerats. Man kan även zooma till markerat objekt i kartan genom att högerklicka på raden och därefter klicka i det blå in-zoomningsfältet. Figur 4 Figur 4. Högerklick på rad i tabell, zooma till objektet.

8 7 (39) 2.4 Söka fram ett urval av provplatser Figur 5. Stationsregistrets ingångssida med referenser till viktigare funktioner. Klicka i vänsterpanelen på namnet Provplatser [2]. Då görs lagret aktivt. Därefter markeras (Sök) i verktygsraden upptill [6]. Då öppnas Sökfönstret i vänsterpanelens nedre del [14] och där kan du söka på värden för olika attribut eller olika kombinationer av dessa attribut [14], Figur 5. I Figur 6 har en sökning gjorts för att få fram alla provplatser som innehåller namnet Vänern, vilket gav 339 träffar. Sökningarna ger inte exakt match utan sökning sker på del av namn. Det spelar ingen roll om du skriver stora eller små bokstäver.

9 8 (39) Figur 6. Sökning av provplatser som har ett namn som innehåller Vänern. 2.5 Sökbara attribut för Provplatser Du kan i Sökfönstret i vänsterpanelen söka på värden för olika attribut eller olika kombinationer av dessa. Det finns för närvarande 9 olika attribut att söka på. Se Figur 7. Figur 7. Sökfönster i vänsterpanelen för att göra urval av provplatser/stationer.

10 9 (39) Sökbara attribut för provplatser i Stationsregistret Attribut ID Namn Ansvarig DV Användande DV Media Synonym LänsID Förklaring Attributet ID (Local ID) består av 8 siffror. Stationsregistrets unika identifierare består av ett Namespace + Local ID. Identifieraren är uppbyggd enligt rekommendationer från EU och följer Inspire-standard. Den och fullständiga identifieraren ser ut så här: För att förenkla den interna hanteringen inom Stationsregistret och vid sökning på attribut erbjuds Local-ID som sökbegrepp t ex: Sökning sker på både helt namn och del av namn. Ansvarig Datavärd eller SSM anger den som har huvudansvaret för provplatsen. Datavärdskap representerat av namnen: "DV Sjöar och vattendrag" "DV Provfiske" "DV Grundvatten" "DV Oceanografi och marinbiologi" "DV Miljögifter" "DV Luftkvalitet" "DV Jordbruksmark" "DV Hälsorelaterad miljöövervakning" "DV Badvatten" SSM Strålsäkerhetsmyndigheten Användande datavärd eller SSM innebär att denna samutnyttjar en redan befintlig provplats som någon annan ansvarar för. Vilken mediatyp som provplatsen är associerad till. Det finns 7 olika mediatyper + övrigt. Se Tabell 2. Media-typer.Tabell 2. Kan utgöra ett äldre namn som man av oika skäl vill synliggöra. LänsID. Läns-ID som består av två siffror. Automatgenereras när en PP läggs in. Om någon manuellt skrivit in Läns-ID, då behålls detta och skrivs ej över. Provplatser i havet utanför länsgränserna saknar Läns-ID. Se Tabell 3.

11 10 (39) ÄldreProvplatsID EU_CD ÄldreProvplatsID. Kan innehålla äldre provplats-id som man av oika skäl vill synliggöra. EU_CD. Detta ID är ett VISS-ID som kommer från Vatteninformationssystem Sverige (VISS). Detta fält är i nuläget ( ) oftast tomt. Kopplingen mellan StnReg och VISS kommer att göras maskinellt är tanken. Tabell 1. Sökbara attribut för Provplatser. 1. Luft t.ex. partikelhalter i luft 2. Biota t.ex. antal och vikt av bottenfauna 3. Sediment t.ex. miljögifter i sediment 4. Jord/berg t.ex 5. Landskap t.ex 6. Avfall t.ex 7. Vatten t.ex. vattenkemi, temperatur 8. Övrigt t.ex. bröstmjölk, damm, hår, fogmassa, slam, kogödsel Tabell 2. Media-typer. 01 Stockholms län 03 Uppsala län 04 Södermanlands län 05 Östergötlands län 06 Jönköpings län 07 Kronobergs län 08 Kalmar län 09 Gotlands län 10 Blekinge län 12 Skåne län 13 Hallands län 14 Västra Götalands län 17 Värmlands län 18 Örebro län 19 Västmanlands län 20 Dalarnas län 21 Gävleborgs län 22 Västernorrlands län 23 Jämtlands län 24 Västerbottens län 25 Norrbottens län Tabell 3. LänsID koder enligt SCB:s kodnummerordning. 2.6 Exportera Provplatser efter urval Efter att ett urval i Sökfönstret [14] gjorts på exempelvis LänsID: 09 för Gotland kan man exportera resultatet till Excel [15].

12 11 (39) Figur 8. Verktyg för Excel-export efter urval i sökfunktionen. Figur 9. Sökning har gjorts på Gotland 09, export är påbörjad. Figur 10. Den nedladdade Excelfilen. Urval 09 Länsstyrelsen i Gotlands län. 2.7 Exportera Provplatser per Datavärd/SSM eller Media Det är även möjligt att göra en export av provplatser per Datavärd/SSM eller per mediatyp. Upp till poster går att exportera vilket tar några minuter. Behöver du göra större uttag bör du istället använda WFS-tjänsten, se kapitlet om det längre fram i handledningen. Export görs genom att klicka på exportknappen i verktygsraden och därefter välja datavärd eller mediatyp eller en kombination. Figur 11.

13 12 (39) Figur 11. Export till Excel av provplatser för ett Datavärdsskap/SSM eller Mediatyp. 2.8 Exportera Provplatser med hjälp av WFS I kapitel 4 ges anvisningar om hur du kopplar upp dig mot WFS-tjänsterna. När detta är gjort kan du enkelt exportera och spara ner innehållet i önskat format som t ex CSV vilket kan öppnas i Excel. 2.9 Jämföra egna provplatser mot Stationsregistrets provplatser Med funktionen Gästlager och Personliga lager kan du kan jämföra positioner och namn för dina egna provplatser i förhållande till vad som redan är inlagt i Stationsregistret. Du kan därmed själv granska din fil istället för att be datavärden/ssm göra den kontrollen. Med denna funktion behöver du inget GIS-program. Funktionen hittar du överst i verktygsmenyn Ladda upp. Gästlager - Dessa lager kan skapas av alla och är synliga för alla, inloggad som icke inloggad. De är tillfälliga och försvinner 3h efter skapande. Figur 12. Personliga lager - Dessa lager kan skapas av en inloggad användare dvs datavärd/ssm, och blir sen endast synlig för denne användare. De är tillfälliga och försvinner vid midnatt. Filen måste vara i Excelformat och innehålla följande kolumner: Namn, Position N, Position E. Om du laddat ner en fil från annan källa måste du alltså ändra kolumnnamnen enligt ovan. Det gör inget om ytterligare kolumner finns i den fil du vill testa. Dessa läses inte in och påverkar inget. Namnen på dessa tillfälliga lager som skapas består av prefix (timme-minut-sekund) samt det filnamn du hade från början. I webbklienten kommer du kunna se dina egna provplatser och dess namn mot bakgrunden som utgör Stationsregistrets provplatser. Färgerna på prickarna i ditt eget lager slumpas fram. Figur 13.

14 13 (39) Figur 12. Gästlager eller Personligt lager som gör att man kan lägga till egna lager för jämförelse mot Stationsregistrets provplatser. Figur 13. Ett Gästlager med provplatser är inläst i Stationsregistret för jämförelse med vad som redan finns i Stationsregistret. Namnet Stora Lysingen kommer från Gästlagret. Man anar att det är samma provplats som avses eftersom den befintliga heter STORA LYSINGEN.

15 14 (39) 2.10 Använda koordinatsök Uppe till höger i verktygsmenyn finns en funktion Koordinatsök för att kunna skriva in en koordinat i något av de vanligare koordinatsystemen och se var i Sverige denna position hamnar. Du kanske har tänkt att inrätta en ny provplats och vill kontrollera om det finns någon befintlig provplats du kan samutnyttja, eller tvärtom, du vill välja en plats där ingen har mätt något tidigare. Eller så vill du bara verifiera att en koordinat befinner sig där du förväntade dig. Koordinatsök finns för att du enkelt ska kunna testa egna koordinater och få dem transformerade och markerade i kartan. Stationsregistrets grundformat är SWEREF 99 TM. Om du har koordinater i något annat system så känner Stationsregistret med hygglig säkerhet igen vilket koordinatsystem du använt och transformerar koordinaterna till SWEREF 99 TM. Var dock uppmärksam på vilket Tolkat system som funktionen anger. Detta är det koordinatsystem som funktionen tror du menar. Vissa koordinater passar i flera system och funktionen kan då anta/tolka fel. Du får även på köpet koordinater i SWEREF 99, RT 90, WGS84. WGS84 visas i formaten DEC, DM, DMS. Figur 14. Resultat av inmatning av ett koordinatpar i koordinatsystemet SWEREF 99 TM. Figur 15. Resultat efter ett klick på zoomnings-knappen.

16 15 (39) Om du vill kopiera någon av de transformerade koordinaterna i den blå rutan är det bara att klicka mitt på koordinaterna till höger. Ett klick med vänster musknapp räcker. Då kopieras koordinatparen och kan klistras in där du önskar. Figur 16. Kopierade koordinater från den blå rutan i koordinatsök Använda professionell koordinat-omvandlare År 2001 införde Lantmäteriet referenssystemet SWEREF 99 i Sverige, dvs för 18 år sedan. I och med detta började utfasningen av det gamla koordinatsystemet RT 90. I de fall vi hanterar nivån provpunkt med provets exakta läge så accepterar datavärdarna/ssm endast SWEREF 99 (EPSG:4619), SWEREF 99 TM (EPSG:3006) och WGS 84 (EPSG:4326) vid inrapportering av data. Har du koordinater i RT90 måste du omvandla dessa innan rapportering. För att säkerställa att transformationen blir helt korrekt om du har källkoordinater i RT 90 eller annat system rekommenderas att du använder en professionell koordinatomvandlare som t ex: För enstaka koordinater: Omvandlarens korrekthet är verifierad mot Lantmäteriets specifikation för Tredimensionell Helmerttransformation (7-parametertransformation). Det finns andra verktyg som FME eller omvandlare som är inbyggda i GIS-program du kan använda, men det är lätt att göra fel. Var noggrann så att du väljer rätt EPSG-kod eller ta hjälp. 3 Redigera Stationsregistret 3.1 Redigera enstaka provplatser För att kunna redigera stationsuppgifter är det nödvändigt att logga in [12]. De som är behöriga att redigera information i Stationsregistret är datavärdarna och SSM. I vänsterpanelen måste du ange om det är provplatser eller övervakningsstationer som ska redigeras. Figur 17. För att redigera Stationsregistret krävs inloggning [12]

17 16 (39) För att redigera uppgifter för en befintlig provplats/övervakningsstation, eller helt radera, en PP/ÖS väljer man Redigera och klickar därefter på den provplats som avses. Det är nu möjligt att redigera attribut-uppgifter. För att ta bort en provplats väljs inaktivera. En ny provplats/övervakningsstation skapas genom att välja Skapa ny. Därefter placeras provplatsen i kartan med markören och ett fönster för att fylla i provplatsuppgifter öppnas. Figur 18 Figur 18. Möjlighet att välja att redigera ett befintligt objekt (PP eller ÖS) eller att skapa ett nytt objekt. Figur 19. Meny för att fylla i attributvärden för provplats/övervakningsstation. Här är det möjligt att fylla i koordinater och övriga attribut.

18 17 (39) 3.2 Redigera provplatser genom excel-uppladdning Med hjälp av knappen Ladda upp/data till registret är det möjligt att lägga till, redigera eller ta bort provplatsuppgifter i Stationsregistret med en Excelfil som innehåller de önskade förändringarna. Figur 20. Excelfilen du använder ska ha samma format och kolumnrubriker som den Excelfil som applikationen genererar vid export av provplatsuppgifter. Figur 21. Excelfilen finns även som mall och ligger tillgänglig på: Excelfilen kan användas både för Provplatser och Övervakningsstationer. Fliken med all information vara döpt till antingen Provplatser eller Övervakningsstationer. Vad de olika kolumnerna i filen ska innehålla redogörs för i kap 3.3. Där framgår vilka värden som är obligatoriska (Mandantory M) respektive valfria (Optional O). Inom parentes står det namn som fältet har i databasen och är det som används vid uttag från WFS-tjänsten. Figur 20. Knappen Data till registret användas för massuppladdning med Excel. Figur 21. Exempel på Excelfil som genererats av applikationens exportfunktion. Figur 22. För ändring av t ex befintligt namn måste en kolumn läggas till: Forcera.

19 18 (39) 3.3 Excelfilen för redigering - attribut och förklaring M M O O O M Attribut Typ (active_site) (active_station) ID (localid) Aktiv (active) Hemlig (classified) Namn (PreferredName) Ansvarigt datavärdskap (datahost_name) ResponsibleParty? Förklaring Anger om objektet är en övervakningsstation eller en provplats. Genereras av DV/SSM som väljer typ. ID (localid). För en ny provplats lämnas fältet tomt och applikationen genererar då automatiskt ett nytt ID. Om provplatsuppgifter ska redigeras för en befintlig provplats ska ID för denna befintliga provplats vara ifylld. Databasen kommer då att uppdateras med de uppgifter som finns i övriga kolumner i Excelfilen. Om ny provplats läggs till eller om attribut för provplatsen redigeras anges värdet SANT. Om en provplats ska tas bort ges värdet FALSKT. OBS detta är ej någon koppling till om provplatsen är operativ eller ej! En övervakningsstation/provplats kan anges som hemlig och då behöver inte läget anges. Här anges: SANT Provplatsens lägesuppgift är hemlig och visas ej. Koordinater för provplatsen kommer då inte läsas in till stationsregistret. Koordinatuppgifterna förvaltas hos datavärden och ska alltså inte anges i Stationsregistret. FALSKT Då är koordinaterna inte hemliga utan visas för alla. Officiellt namn på övervakningsstationen/provplatsen som inte behöver vara unikt. Utformat för att kunna användas i dagligt tal. Ansvarig Datavärd eller SSM anger den som har huvudansvaret för övervakningsstationen/provplatsen och som har möjlighet att redigera dess kärnuppgifter som ID, position mm. Ansvarigt datavärdsskap (responsible_datahost_name) Datavärdsskap representerat av namnen: "DV Sjöar och vattendrag" "DV Provfiske" "DV Grundvatten" "DV Oceanografi och marinbiologi" "DV Miljögifter" "DV Luftkvalitet"

20 19 (39) M M O M M M O O Ansvarig organisation (datahost_organization_name) Ansvarig organisation e-post Anges ej eftersom detta styrs av Ansvarigt datavärdskap. (datahost_organization_ ) Användande datavärdskap (associated_datahosts) Media (media_types) Position N (position_n) Position E (position_e) Synonymer (synonyms) EU_CD (eu_cd) "DV Jordbruksmark" "DV Hälsorelaterad miljöövervakning" "DV Badvatten" SSM Strålsäkerhetsmyndigheten Den myndighet som ansvarar för datavärdskapet. E-postadress till datavärd/ssm. Flera olika mätningar kan göras på samma plats och data från samma plats kan således finnas hos olika datavärdar. Här anges vilka datavärdskap förutom ansvarigt datavärdskap som förvaltar data från provplatsen eller övervakningsstationen. Användande datavärd/ssm kan endast redigera vissa fält, främst lägga till synonyma namn, mediatyp etc. För att stationsregistret ska uppfylla kraven enligt Inspire-temat Environmental Monitoring Facilities anges här vilket medium provtagningen är associerad till. Det finns 7 olika mediatyper + övrigt. Om flera värden anges avdelas dessa med semikolon (;) För giltiga mediatyper, se kap 2.5. Koordinat i nordlig riktning anges i SWEREF 99 TM Om en station är hemlig utelämnas koordinat. Se Hemlig Koordinat i ostlig riktning. Se ovan. Alternativa namn på en övervakningsstation/provplats som t ex populärnamn, etablerade felstavade namn, tidigare identiteter mm. Dessa kan förekomma i olika varianter för olika övervakningsprogram. Genereras av DV/SSM. Om flera värden anges avdelas dessa med semikolon (;) EU_CD är ett VISS-ID som kommer från Vatteninformationssystem Sverige (VISS). Detta

21 20 (39) O O O O O O LänsID (county_id) Sjö-Id_SMHI_sjöregister (sjoid_smhi_sjoregister) SjöID_RI (sjoid_ri) VdrID_RI (vdrid_ri) ÄldreProvplatsID (older_site_id) Kommentar (comment) fält är i nuläget ( ) oftast tomt. Kopplingen mellan StnReg och VISS kommer att göras maskinellt är tanken. Läns-ID Automatgenereras när en PP läggs in. Om någon manuellt skrivit in Läns-ID, då behålls detta och skrivs ej över. Provplatser i havet utanför länsgränserna saknar Läns-ID. SMHI:s sjöregister-id från SVAR. Kommer troligen utgå när Stationsregistret är tvättat. Avser SMHI:s sjö-id som hanteras av SLU. Sjö-ID. Kommer troligen utgå när Stationsregistret är tvättat. Avser sjö-id som hanteras av SLU. Vattendrags-ID. Kommer troligen utgå när Stationsregistret är tvättat. Avser vattendrags-id som hanteras av SLU. Kan innehålla äldre provplats-id som man av oika skäl vill synliggöra. Möjlighet för datavärdar/ssm att ge synpunkter på en övervakningsstation/provplats. Används även för att kvalitetsflagga PP/ÖS isamband med datavärdarnas kvalitetssäkring av innehållet. O Forcera Forcera i kombination med värdet SANT kan användas när man vill läsa in en ny provplats/övervakningsstation som ligger närmare än 10 m från en befintlig. Forcera i kombination med värdet SANT kan även användas om man vill radera en provplats/övervakningsstation från registret. Se kap nedan. Lagrad Valideringsstatus Här anges om uppgifterna på den aktuella raden har lagrats i databasen (SANT) eller inte (FALSKT). Här beskrivs orsaken till att posten inte kunde uppdateras för de rader som fick värde FALSKT i kolumnen Lagrad. Tabell 4. Attribut och dess förklaring. 3.4 Lägg till provplats <10 m från befintlig (Forcera) Vid uppladdning av stationer görs en kontroll om en provplats ligger inom 10 m radie från en annan provplats. Om du ändå vill läsa in din PP måste du för den provplatsen i fältet Forcera skriva SANT. Då läses provplatsen in även om den ligger inom 10 meter från en annan provplats. Värdet SANT anger att provplatsen ska läsas in.

22 21 (39) Figur 23. Exempelfil för uppladdning. I kolumnen Forcera anges värden SANT om raden ska läsas in trots att validering varnat för att provplatsen ligger nära en annan provplats. 3.5 Ta bort en befintlig provplats (Aktiv = FALSKT) Om du vill ta bort provplatser från Stationsregistret måste du för den eller de provplatserna i fältet Aktiv skriva FALSKT. Det som då händer är att objektet får ett EndLifespan med dagens datum. Det raderas inte ur registret men är inte längre möjligt att använda. I praktiken är provplatsen att anse som raderad, men den finns som sagt ändå kvar i registret så att en administratör kan söka rätt på den. Alla provplatser som tvättas bort för att de är felaktiga eller är dubbletter hanteras på detta sätt. Figur 24. Exempelfil för uppladdning. I kolumnen Aktiv anges värdet FALSKT om provplatserna ska tas bort. 3.6 Ladda upp hemliga provplatser (Hemlig) Övervakningsstationer/provplatser med hemlig lägesuppgift hanteras genom att attributet Hemlig sätts till True. Det blir då möjligt att registrera övervakningsstationen/provplatsen utan att ange dess läge. För övervakningsstationer/provplatser som inte är hemliga måste läget anges. En hemlig övervakningsstation/provplats användas endast av den datavärd som ansvarar för övervakningsstationen/provplatsen. Hemliga övervakningsstationer/provplatser blir på så sätt en form av kodlista för datavärden som kan användas av valideringstjänsten. När en utförare ska validera en undersökning i valideringstjänsten är det möjligt att kontrollera att övervakningsstationens/provplatsens ID och namn finns i stationsregistret och är knutet till den datavärd som ansvarar för övervakningsstationen/provplatsen. Det blir däremot inte möjligt för valideringstjänsten att kontrollera om övervakningsstationens/provplatsens läge är korrekt. En konsekvens av detta är att en annan datavärd kan skapa en publik övervakningsstation/provplats på samma plats som en hemlig station. Att två övervakningsstationer/provplatser finns på samma plats kommer dock aldrig att synas eftersom de hemliga övervakningsstationerna/provplatserna saknar position i stationsregistret.

23 22 (39) 3.7 Respons efter att Exceluppladdning är utförd När en fil har lästs in returnerar applikationen en resultatfil som är en kopia på filen som lästes in där två kolumner har lagts till: Lagrad Här anges om uppgifterna på den aktuella raden har lagrats i databasen (SANT) eller inte (FALSKT). Valideringsstatus här beskrivs orsaken till att posten inte kunde uppdateras för de rader som fick värde FALSKT i kolumnen Lagrad. Figur 25. Provplatser som inte lästs in i Stationsregistret då det finns PP som ligger närmare än 10 m. Vill man ändå läsa in dessa PP måsta man välja Forcera. Figur 26. Resultatfil från validering som anger att inläsningen har lyckats då koden SANT är ifylld. 4 Redigera provplatser med REST-API Användare av detta API är HTTP klienter, såsom ex FME eller programkod och kräver att man är registrerad som användare i Stationsregistret med rollen STNREG_DATA- HOST. Denna roll har datavärdarna och SSM. 4.1 URL

24 23 (39) 4.2 Autentisering Varje request kräver en API-nyckel som identifierar den anropande användaren. Användare får tag på nyckeln genom att logga på Stationsregistrets webbklient och sedan klicka på info-ikonen bredvid användarnamnet. Nyckelns värde kommer alltid vara densamma så länge användarens namn eller lösenord inte förändras. Nyckeln ska skickas med som en separat header kallad X-STNREG-APIKEY (eller som cookie med samma namn) med nyckeln som värde. 4.3 Funktioner Skapa ny provplats Metod: POST URL: /geoserver/rest/nv/stnreg/api/monitoringfacility Möjliga URL-parametrar: force=true (Ignorerar status 409) Content-Type: application/json Body: Se modell och exempel nedan Möjliga resultat: Status Betydelse Modell 201 PP blev skapad local_id och uuid för skapad PP. 400 Bifogad modell har felaktig data. Saknas 409 En existerande PP existerar inom 10m. local_id och distance (meter) till existerande PP. 500 Ett oväntat fel har inträffat på servern. Saknas Uppdatera en existerande provplats Provplatsens id (local_id) måste finnas som sista del i URL, eller som en del av bodyn. Ex, /geoserver/rest/nv/stnreg/api/monitoringfacility/

25 24 (39) Metod: PUT URL: /geoserver/rest/nv/stnreg/api/monitoringfacility/<id> Möjliga URL-parametrar: force=true (Ignorerar status 409) Content-Type: application/json Body: Se modell och exempel nedan Möjliga resultat: Status Betydelse Modell 204 PP blev uppdaterad Saknas 400 Bifogad modell har felaktig data. Saknas 404 PP existerar inte Saknas 409 En existerande PP existerar inom 10m. Inträffar endast om koordinaterna förändrats. local_id och distance (meter) till existerande PP. 500 Ett oväntat fel har inträffat på servern. Saknas Inaktivera en provplats Provplatsens id (local_id) måste finnas som sista del i URL. Ex, /geoserver/rest/nv/stnreg/api/monitoringfacility/ Metod: DELETE Body: Ska inte skickas Möjliga resultat: Status Betydelse Modell 204 PP blev inaktiverad. Saknas 400 URL saknar id. Saknas 404 PP existerar inte. Saknas 500 Ett oväntat fel har inträffat på servern. Saknas

26 25 (39) 4.4 Modell Notera: Typ CSV-sträng (multivärde) ska separeras med ; dvs semikolon. Position_n/position_e kan anges i alternativa system. Namn Betydelse Typ Krävs Värde om ej angivet local_id LokalId Sträng Ja, PUT/DE- LETE preferred_name Namn Sträng Ja, POST/PUT responsible_datahost_name Ansvarig datavärd Sträng Ja, POST/PUT position_n position_sweref99_n Koordinat N, i SWEREF99T M Sträng/Deci mal Ja, om ej angivet i annat system, POST/PUT (inget) position_e position_sweref99_e Koordinat E, i SWEREF99T M Sträng/Deci mal Ja, om ej angivet i annat system, POST/PUT (inget) position_sweref99_n Koordinat N, i SWEREF99 Sträng/Deci mal Nej (inget) position_sweref99_e Koordinat E, i SWEREF99 Sträng/Deci mal Nej (inget) position_wgs84_dec_n Koordinat N, i WGS84 Decimalt Sträng/Deci mal Nej (inget) position_wgs84_dec_e Koordinat E, i WGS84 Decimalt Sträng/Deci mal Nej (inget) position_wgs84_dm_n Koordinat N, i WGS84 DM Sträng Nej (inget)

27 26 (39) position_wgs84_dm_e Koordinat E, i WGS84 DM Sträng Nej (inget) media Media CSV-Sträng Ja, POST/PUT comment Kommentar Sträng Nej (inget) synonyms Synonymer CSV-Sträng Nej (inget) older_site_id county_id LänsId Sträng Nej Automatisk Äldre- ProvplatsID CSV-Sträng Nej (inget) eu_cd EU_CD CSV-Sträng Nej (inget) associated_datahosts Användande DV CSV-Sträng Nej (inget) classified Klassificerad Boolean Nej false sjoid_ri CSV-Sträng Nej (inget) vdrid_ri CSV-Sträng Nej (inget) sjoid_smhi_sjoregister CSV-Sträng Nej (inget) validated Datum för godkänd kvalitetsgranskning Sträng YYYY-MM- DD Nej (inget)

28 27 (39) 4.5 Exempel Skapa ny provplats { } "preferred_name": "En provplats", "responsible_datahost_name": "DV Provfiske", "position_n": " ", "position_e": "794207", "validated": " ", "comment": "En kommentar", "synonyms": "aaa;bbb;ccc", "county_id": "10", "older_site_id": "aaa;bbb;ccc", "eu_cd": "aaa;bbb;ccc", "associated_datahosts": "DV Grundvatten;DV Badvatten", "media": "Sediment;Biota;Avfall", "facilitytype": 2, "classified": false, "sjoid_ri": "aaa;bbb;ccc", "vdrid_ri": "aaa;bbb;ccc", "sjoid_smhi_sjoregister": "aaa;bbb;ccc" Uppdatera en provplats { } "local_id": " ", "preferred_name": "En provplats", "responsible_datahost_name": "DV Provfiske", "position_n": " ", "position_e": "794207", "validated": " ", "comment": "En kommentar", "synonyms": "aaa;bbb;ccc", "county_id": "10", "older_site_id": "aaa;bbb;ccc", "eu_cd": "aaa;bbb;ccc", "associated_datahosts": "DV Grundvatten;DV Badvatten", "media": "Sediment;Biota;Avfall", "facilitytype": 2, "classified": false, "sjoid_ri": "aaa;bbb;ccc", "vdrid_ri": "aaa;bbb;ccc", "sjoid_smhi_sjoregister": "aaa;bbb;ccc"

29 28 (39) Uppdatera en provplats från annat koordinatsystem Position N/E kommer transformeras från WGS84 DM i detta fallet. { } "local_id": " ", "preferred_name": "En provplats", "responsible_datahost_name": "DV Provfiske", "position_n": "", // Fältet kan lämnas tomt eller utelämnas helt "position_e": "", // Fältet kan lämnas tomt eller utelämnas helt "position_wgs84_dm_n": "N '", "position_wgs84_dm_e": "E '", "comment": "En kommentar", "synonyms": "aaa;bbb;ccc", "county_id": "10", "older_site_id": "aaa;bbb;ccc", "eu_cd": "aaa;bbb;ccc", "associated_datahosts": "DV Grundvatten;DV Badvatten", "media": "Sediment;Biota;Avfall", "facilitytype": 2, "classified": false, "sjoid_ri": "aaa;bbb;ccc", "vdrid_ri": "aaa;bbb;ccc", "sjoid_smhi_sjoregister": "aaa;bbb;ccc"

30 29 (39) 5 Använda Stationsregistrets API:er API:erna följer OGC-standarder och bygger på Geoserver för tillhandahållande av data. Data kan hämtas i en rad olika format (json, csv, xml osv.) via http-anrop till servern, se kap 4.1. För beskrivning av olika dataset och objektens attribut, se beskrivning av respektive Feature type. Feature type: Provplats Feature type: Övervakningsstation Vid uppkoppling till en WFS-tjänst innebär det kort att man ber servern om ett capabilities-dokument som beskriver de funktioner och lager som är publicerade av servern. Sökvägen ser alltid likadan ut, oavsett miljö (PROD, AT, DEV): /geoserver/stationsregistret/ows Capabilities för PROD: Ett capabilities-dokument läses mest korrekt av ett GIS-program eller motsvarande. Med hjälp av capabilities-dokumentet kan sedan programmet du använder bl.a lista ut vilka lager som finns tillgängliga. 5.1 API Det finns nuläget två API:er för maskinell åtkomst till Stationsregistret. WMS och WFS. Ett REST-API är under utveckling. WMS (Web Map Service) kan användas om man vill ha en snabbare åtkomst till innehållet i form av en zoomingsbar kartbild men inte behöver vektordata. WMS ger en kartbildbild med alla provplatser/övervakningsstationer och det går att klicka på provplatserna och få upp en attributtabell, men några djupare analyser eller filtreringar går inte att göra. Hur man kopplar upp sig till WMS-tjänsten följer WFS uppkopplingen i stort och beskrivs inte närmare. Beskrivning/specifikation av WMS: WFS (Web Feature Service) använder den som vill göra analyser eller filtreringar av Stationsregistret och kanske jämföra ett eget dataset med Stationsregistrets databas. Till WFS-tjänsten kan man koppla sitt GIS-program men det går också att ladda ned uppgifter. Beskrivning/specifikation av WMS:

31 30 (39) REST-API Datavärdarna/SSM som har behörighet att redigera registret kommer kunna använda ett REST-API för redigering genom att använda egen programvara som t ex FME. Detta beräknas vara klart i augusti WFS-tjänster PROD: Produktionsmiljön Webbklient: WFS: AT: Testmiljön Webbklient: WFS: DEV: Utvecklingsmiljön Webbklient: WFS: Publicerade WFS-lager Lager active_site active_station county flag_a flag_c flag_d v_active_site v_active_station v_dv_badvatten v_dv_grundvatten v_dv_halsorelateradmiljoovervakning Beskrivning Provplatser för datavärdar Stationer för datavärdar Län polygoner Kommer utgå Kommer utgå Kommer utgå Vy som används av stationsregistrets klientapplikation, denna vy visar inte hemliga stationer. Vy som används av stationsregistrets klientapplikation, denna vy visar inte hemliga provlatser. Dessa vyer innehåller Inspire metadata och är en färdigfiltrerad version av respektive datavärdskaps provplatser.

32 31 (39) v_dv_jordbruksmark v_dv_luftkvalite v_dv_miljogifter v_dv_oceanografiochmarinbiologi v_dv_provfiske v_dv_sjoarochvattendrag v_dv_stralningsmatningar v_montoring_facility_survey v_survey_organization_levels v_survey_per_organization_level v_vt Test-vy i POC för länkade provplatser och undersökningar Test-vy i POC för undersökningsnamn (RMÖ/VISS etc.). Test-vy i POC för datavärdskap/ssm (PP visas per DV-skap). Vy för validering av provplatser för valideringstjänsten. Visar hemliga provplatsers ID. Visar inte hemliga provplatsers koordinater. Tabell 5. Tillgängliga lager i WFS-tjänsten. 5.4 Uppkoppling till WFS-tjänst med QGIS Nedan beskrivs hur du gör i QGIS. Beskrivning för ArcGIS är ej klar (aug 2019). För att koppla upp sig till WFS-tjänsten med QGIS gör följande: 1. Öppna QGIS Desktop. 2. I Datakällor till vänster högerklicka WFS och välj Ny anslutning. Figur I dialogfönstret Skapa en ny WFS-anslutning, ange ett beskrivande namn för tjänsten vid Namn och vid URL, ange adressen till WFS-tjänsten (t.ex. produktionsmiljön: Inga användaruppgifter behöver anges. Klicka därefter OK för att acceptera. Figur Den tillagda WFS-tjänsten visas därefter i Datakällor Figur 29 med alla tillgängliga lager. Figur 30. För beskrivning av lagren se kap Dubbelklicka önskat lager för att lägga till det i kartvyn. T ex active_site. 6. Resultatet visas i Figur 31. Du får själv lägga till lämplig bakgrundskarta.

33 32 (39) Figur 27. Var du aktiverar WFS i utforskaren i QGIS

34 33 (39) Figur 28. Namnge ditt lager, skriv in URL till WFS.

35 34 (39) Figur 29. Anslutning till WFS-tjänsten är utförd. Figur 30. Tillgängliga lager i WFS-tjänsten. Figur 31. Kartlagret active_site med Provplatser är öppnat i QGIS.

36 35 (39) 5.5 Avståndsanalys. Jämföra egna PP mot Stationsregistrets PP. Figur 32. Uppkoppling till WFS-lagret Provplatser, eller lämplig vy. Instruktion 1. Öppna QGIS och lägg till Stationsregistrets lager med provplatser (active_site) som WFS. Om t ex endast luftstationer ska jämföras mot luftstationer kan vyn för luftstationer istället användas vilket ger betydligt snabbare inläsning. Se tillgängliga lager i kap 4.1. Figur Strukturera upp dina provplatser som ska kontrolleras mot Stationsregistret och spara ner dessa som CSV. Stationsregistret hanterar koordinater i SWEREF 99 TM så det är fördel om provplatserna använder samma koordinatsystem. Figur Använd funktionen Lager/Lägg till separerad text-lager för att lägga till dina provplatser i QGIS. Figur 34. Figur Kontrollera så att dina provplatser positioner hamnar i kartan och visas korrekt med avvikande färg. Figur Använd verktyget Avståndsmatris för att för varje provplats beräkna avståndet till närmsta provplats i Stationsregistret. Detta verktyg finns under: Vektor/Analysverktyg/Avståndsmatris Figur I fönstret för Avståndsmatris ska du ange dina provplatser som Punktlager med indata och det ID som du har i din CSV-fil för dina provplatser anger du i Indata unik ID fält. I Målpunktlager anger du Stationsregistrets provplatslager du vill jämföra din fil mot, vanligen active-site eller en delmängd av t ex enbart Luft-provplatser som i exemplet. I fältet Mål unik ID fält anger du localid. Under Använd bara de närmaste (k) punkterna väljer du siffran 1 för att beräkna avståndet till enbart den närmsta provplatsen i Stationsregistret (se nedan). Klicka sedan Kör för att köra. Figur 38

37 36 (39) Figur 33. Skapa tabell för dina provplatser som ska kontrolleras mot Stationsregistret Figur 34. Verktyg för att lägga till din egen CSV-fil som du vill jämföra mot Stationsregistrets lager.

38 37 (39) Figur 35. Var du lägger till dina provplatser i QGIS.

39 38 (39) Figur 36. Kontrollera resultatet. QGIS väljer annan färg för dina egna provplatser. Figur 37. Verktyg för att göra avståndsanalys mellan provplatser från två olika källor.

40 39 (39) Figur 38. Avståndskontroll. /Här tar dokumentet slut.