Spring til indhold

Grundfast

Søg og filtrér adgangsadresser

En side adgangsadresser, der opfylder alle filtre — fritekst, postnummer, vej, cirkel eller polygon — som JSON eller GeoJSON.

GET/v1/adgangsadresser

Erstatter DAWA’s /adgangsadresser?…-liste. Alle filtre skal være opfyldt, og mindst ét forankrende filter er påkrævet: q, postnr, kommunekode, vejnavn, cirkel eller polygon. husnr indsnævrer, men er ikke nok alene.

cirkel og polygon tager DAWA’s format, og srid gælder både for dem og for svaret: med srid=25832 sender du UTM32N-meter ind og får koordinater som [x, y] tilbage. koordinat er altid WGS84 { lon, lat }, uanset srid. Med format=geojson er svaret en FeatureCollection.

Svaret er { antal, side, per_side, srid, adgangsadresser } i stedet for et bart array. Listen pagineres med per_side (standard 100, højst 1.000) og side.

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/adgangsadresser?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": 25832,
  "adgangsadresser": [
    {
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "bfe_nummer": 6033528,
      "vejnavn": "Rådhuspladsen",
      "husnr": "1",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5695777, "lat": 55.6756275 },
      "koordinater": [724434.93, 6175755.61]
    },
    {
      "betegnelse": "Vester Voldgade 72, 1552 København V",
      "adgangsadresse_id": "74806df4-97a9-4c0c-a6cb-df07b5429e07",
      "bfe_nummer": 6033528,
      "vejnavn": "Vester Voldgade",
      "husnr": "72",
      "postnr": "1552",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5700489, "lat": 55.6757814 },
      "koordinater": [724463.66, 6175774.25]
    }
  ],
  "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.
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

adgangsadresser[].koordinater[number, number] | null
Adgangspunktet i det srid, du bad om: [lon, lat] for 4326, [x, y] i meter for 25832.
adgangsadresser[].bfe_nummerinteger | null
BFE på det jordstykke, adgangspunktet ligger på — nøglen videre til BBR og Matriklen.
antalinteger
Antal adresser på denne side. Er det lig per_side, kan der være flere på næste side.

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.
503Indekset er ikke slået til eller endnu ikke indlæst, 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/adgangsadresser?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.