EA-Tools: API

Denne artikel beskrivelser hvordan eksterne systemer kan trække på overlapundersøgelser fra EA-Tools og forudsætningerne for det. API’et gør det muligt at integrere resultater fra overlapundersøgelsen til eget system for at få præsenteret konkrete overlap i egen sagsbehandling.

Brugerstyring

API'et kræver at man har en bruger til Danmarks Miljøportal med de korrekte roller.

Det kræver at du har roller:

• miljoe_eatools_write

Der er som udgangspunkt ikke restriktioner på, hvilke organisationer eller myndigheder der kan få denne rolle. Det kræver dog, at din organisation er oprettet i Danmarks Miljøportals brugerstyring eller at du har adgang til din organisations MitID Erhverv.

Er du i tvivl om din organisation er oprettet i Danmarks Miljøportals brugerstyring kan du kontakte vores support her: Indsend kontaktformular

Hvor findes API'et?

API'et og adgangen til dette kan du læse mere om på vores GitHub. Du finder denne ved at følge dette link til GitHub. Her finder du diverse endpoints, swagger samt beskrivelse af API'ets funktioner og muligheder.

API'et kan tilgås i både TEST-, DEMO-, og PROD miljøet. Vi anbefaler at man benytter DEMO-miljøet til test af opsætning og PROD når du er klar til at benytte integrationen.

Overordnet flow for API'et

Informationer du skal sende med API'et:

• Skabelon ID (fx urn:dmp:ea:survey:flora-fauna-og-biodiversitet-skabelon. Du kan lave din egen skabelon og indsende den til Danmarks Miljøportal til oprettelse her (indsend kontaktformular) eller benytte en af de eksisterende).
• Geometri (GeoJSON format)
• Buffer (i meter)
• Titlen, du giver din undersøgelsen
• Dit navn
• Sprog (DA eller EN)
• Outputformat (PDF-rapport, data i JSON og PNG format eller begge dele)
• Evt. Bemærkninger, der skal fremgå i pdf-rapporten

Skabeloner indeholder en udvalgt mængde datasæt og kan indeholde specifikke buffere og distanceanalyser pr. datasæt. En skabelon kan fx være en opsætning i EA-Tools opsat med tekniske regler på datasæt målrettet solenergiprojekter eller skovrejsningsprojekter. Det kan også være en skabelon, der kun indeholder datasæt, der har med flora, fauna og biodiversitet at gøre.

Når du indsender en skabelon til Danmarks Miljøportal skal du først vælge hvilke datasæt, skabelonen skal indeholde og herefter beslutte om nogle af disse datasæt skal have opsat tekniske regler for buffer og distanceanalyse. Dette kan fx sendes som et Excel-ark.

Information du modtager fra API'et afhænger af dit valg af outputformat. Det kan være:

• PDF-rapport fra overlapsanalysen
• ZIP-fil der indeholder en JSON fil med overlapsanalysens resultater og PNG-billeder af overlappene.
• ZIP-fil der indeholder både PDF-rapport og overlapsanalysens resultater

API'et er udviklet til at understøtte system-til-system integration. Det vil sige, hvordan du ønsker at arbejde videre med resultaterne fra API'ets output (altså selve integrationen) er op til dig og er ikke noget vi supporterer. Dog er du altid velkommen til at kontakte supporten med spørgsmål til API'et og høre mere om hvilke muligheder og eventuelle ønsker til output du har: Indsend kontaktformular

Vi arbejder på også at understøtte en integration til andre GIS-programmer, så du kan arbejde videre med data fra overlapsanalysen direkte i dit eget GIS-system.