Spring til indhold

Grundfast

Søg og filtrér enhedsadresser

En side enhedsadresser med etage og dør, der opfylder alle filtre, som JSON eller GeoJSON.

GET/v1/adresser

Erstatter DAWA’s /adresser?…-liste: adresser på enhedsniveau, dvs. en adgangsadresse plus etage og dør. Filtrene er de samme som på /v1/adgangsadresser, plus adgangsadresseid, etage og doer. Mindst ét forankrende filter er påkrævet; etage, doer og husnr indsnævrer, men er ikke nok alene.

Hver enhed har sin egen UUID (adresse_id) og adgangsadressens (adgangsadresse_id). Vej, postnummer, BFE og koordinat er adgangsadressens. Listen er i læserækkefølge: vej, husnummer, etage (kælder, stuen, 1, 2 …) og dør.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald pr. side.

Eksempel

curl "https://api.grundfast.dk/v1/adresser?postnr=8000&cirkel=10.2107,56.1572,150" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "antal": 2,
  "side": 1,
  "per_side": 100,
  "srid": 4326,
  "adresser": [
    {
      "betegnelse": "Vestergade 10, st. th, 8000 Aarhus C",
      "adresse_id": "0a3f50a3-1e3c-32b8-e044-0003ba298018",
      "adgangsadresse_id": "0a3f507b-4a0a-32b8-e044-0003ba298018",
      "etage": "st",
      "doer": "th",
      "vejnavn": "Vestergade",
      "husnr": "10",
      "postnr": "8000",
      "postnrnavn": "Aarhus C",
      "kommunekode": "0751",
      "bfe_nummer": 1234567,
      "koordinat": { "lon": 10.2047, "lat": 56.1566 },
      "koordinater": [10.2047, 56.1566]
    },
    {
      "betegnelse": "Vestergade 10, 1. th, 8000 Aarhus C",
      "adresse_id": "0a3f50a3-1e3d-32b8-e044-0003ba298018",
      "adgangsadresse_id": "0a3f507b-4a0a-32b8-e044-0003ba298018",
      "etage": "1",
      "doer": "th",
      "vejnavn": "Vestergade",
      "husnr": "10",
      "postnr": "8000",
      "postnrnavn": "Aarhus C",
      "kommunekode": "0751",
      "bfe_nummer": 1234567,
      "koordinat": { "lon": 10.2047, "lat": 56.1566 },
      "koordinater": [10.2047, 56.1566]
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Parametre

qstringqueryvalgfri
Fritekst, mindst 2 tegn. Rangeres med præfiks-hit først og derefter stavefejlstolerant lighed.
postnrstringqueryvalgfri
Firecifret postnummer.Eksempel: 8000
kommunekodestringqueryvalgfri
Kommunekode, 1–4 cifre (101 læses som 0101).
vejnavnstringqueryvalgfri
Præcist vejnavn, uden forskel på store og små bogstaver.
husnrstringqueryvalgfri
Præcist husnummer, fx 12B. Indsnævrer, men er ikke nok alene.
adgangsadresseidstring (UUID)queryvalgfri
Alle enheder på én adgangsadresse.
etagestringqueryvalgfri
Etage, fx st, 1 eller kl. Indsnævrer, men er ikke nok alene.
doerstringqueryvalgfri
Dør, fx th, tv eller mf. Indsnævrer, men er ikke nok alene.
cirkelstringqueryvalgfri
DAWA-formatet x,y,radius: alle adresser inden for radius meter (højst 10.000) af punktet, i srid.Eksempel: 10.2107,56.1572,150
polygonstringqueryvalgfri
DAWA-formatet: et JSON-array af ringe i srid, fx [[[x1,y1],[x2,y2],[x3,y3],[x1,y1]]]. Højst 1.000 hjørner, og den omskrevne kasse må højst spænde 0,3° bredde og 0,5° længde.
sridstringqueryvalgfri
Koordinatsystemet for både cirkel/polygon og svarets koordinater: 4326 (WGS84) eller 25832 (UTM32N).Standard:4326Værdier:432625832
formatstringqueryvalgfri
geojson giver en FeatureCollection med ét punkt pr. adresse; ved srid=25832 med crs sat.Standard:jsonVærdier:jsongeojson
per_sideintegerqueryvalgfri
Sidestørrelse, højst 1.000.Standard:100
sideintegerqueryvalgfri
Sidenummer fra 1. side × per_side må højst være 50.000 — indsnævr filteret i stedet.Standard:1

Felter i svaret

adresser[].adresse_idstring (UUID)
Enhedens UUID — slås op på /v1/adresse/{uuid}.
adresser[].etagestring | null
Etagen; null for en enhed uden etage, fx et parcelhus.
adresser[].doerstring | null
Døren; null for en enhed uden dør.
adresser[].koordinater[number, number] | null
Adgangspunktet i det srid, du bad om.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Intet forankrende filter, et filter i forkert format, både cirkel og polygon, en cirkel eller polygon over grænserne, et punkt uden for Danmark, eller en for dyb side.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
503Enhedsindekset (etage og dør) er ikke indlæst i dette miljø endnu, eller der er bedt om et rumligt filter i et miljø uden PostGIS.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/adresser?postnr=8000&cirkel=10.2107%2C56.1572%2C150

Bruges ofte sammen med

Læs mere om DAWA-kompatibel, og hvad data kan bruges til, på produktsiden.