Fra DAWA til Datafordeleren: Din guide til fremtidens adressedata

DAWA er ved at blive udfaset. Lær hvordan du flytter din adressedata-integration til Datafordeleren og udnytter fordelene ved GraphQL.

Er du en af de mange udviklere, der har brugt DAWA (Danmarks Adressers Web API) til at hente adressedata? Så er det tid til at spidse ører. DAWA er ved at blive udfaset, og fremtiden for danske grunddata ligger hos Datafordeleren. Men bare rolig, vi har lavet en guide, der hjælper dig med at komme godt i gang med den nye platform.

Hvorfor skifter vi fra DAWA til Datafordeleren?

I takt med moderniseringen af den offentlige data-infrastruktur i Danmark, samles adgangen til grunddata på én central platform: Datafordeleren. Målet er at skabe en mere ensartet, stabil og sikker adgang til data for både offentlige og private aktører. Det betyder, at specialiserede API'er som DAWA gradvist bliver erstattet af de mere fleksible og moderne tjenester på Datafordeleren.

Kom i gang med Datafordeleren: En 4-trins guide

At skifte fra DAWA til Datafordeleren kan virke som en stor mundfuld, men processen er heldigvis ligetil. Følg disse fire trin for at sikre en gnidningsfri overgang:

Trin 1: Opret en bruger og få adgang

Før du kan hente data fra Datafordeleren, skal du oprette en bruger. Den nye adgangsmodel er baseret på API-nøgler (API keys) eller OAuth, hvilket giver en mere sikker og fleksibel adgang end tidligere.

• Gå til Datafordelerens Administration og opret en konto med MitID Erhverv eller din e-mail.
• Opret et IT-system: Inde i administrationen skal du oprette et IT-system for hver af dine applikationer, der skal tilgå data.
• Generer en API-nøgle eller OAuth-klient: For hvert IT-system kan du generere en API-nøgle eller oprette en OAuth-klient til autentifikation.

Trin 2: Find dine adressedata (DAR)

Når du har styr på adgangen, er det tid til at finde de data, du skal bruge. Alle adressedata fra DAWA findes nu i Danmarks Adresseregister (DAR) på Datafordeleren.

• Gå til Dataoversigten for at få et komplet overblik over alle tilgængelige datasæt.
• Filtrer på "Adresser, veje og områder" for at se alle relevante registre.
• Vælg "Danmarks Adresseregister (DAR)" for at se de specificerede tjenester, der erstatter DAWA.

Trin 3: Vælg den rette tjeneste - Vi anbefaler GraphQL

Datafordeleren tilbyder flere måder at hente data på. Hvor DAWA primært var et REST API, giver Datafordeleren dig flere muligheder:

• GraphQL: Den mest moderne og fleksible metode. GraphQL lader dig specificere præcis de datafelter, du har brug for, hvilket minimerer datamængden og forbedrer svartiderne.
• Fildownload: Download komplette datasæt i formater som CSV, JSON og GML. Ideelt til offline-analyse eller import i egne systemer.
• Webservices (WFS, WMS): Geografiske webservices til brug i GIS-applikationer.
• Hændelser: Få besked i realtid, når der sker ændringer i adressedata.

For de fleste, der kommer fra DAWA, vil GraphQL være det oplagte valg. Det giver den samme fleksibilitet som et REST API, men med flere fordele.

Trin 4: Teknisk implementering - Eksempel med GraphQL

At hente data med GraphQL er enkelt. Du sender en POST-request til det relevante GraphQL-endepunkt med din query i body'en og din API-nøgle i headeren.

GraphQL-endepunkt for DAR: https://graphql.datafordeler.dk/DAR/v1

Her er et simpelt eksempel på, hvordan du kan hente en adresse med en curl kommando:

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: apikey DIT_API_KEY" \
-d '{
  "query": "{\n    DAR_Adresse(id_lokalid: \"a3d8c9e1-b930-46c2-a709-3435c1f0918b\" ) {\n      id_lokalid\n      adressebetegnelse\n    }\n  }"
}' \
https://graphql.datafordeler.dk/DAR/v1

Husk at erstatte DIT_API_KEY med din egen API-nøgle.

Support og yderligere ressourcer

Har du brug for hjælp til at komme i gang? Datafordeleren har en række ressourcer, der kan hjælpe dig videre:

• Vejledning til Datafordeleren: En komplet guide til alt fra brugeroprettelse til teknisk implementering.
• GraphQL Dokumentation: Dybdegående teknisk dokumentation for GraphQL-tjenesterne.
• Datafordeleren Support: Kontakt supporten på telefon 33 34 89 77.

Overgangen fra DAWA til Datafordeleren er et vigtigt skridt mod en mere moderne og sammenhængende data-infrastruktur i Danmark. Ved at følge denne guide er du godt på vej til at blive en del af fremtidens datalandskab.