Find adresser for mange punkter

Den nærmeste adgangsadresse til hvert punkt i en liste, i ét kald, med en fejl pr. punkt uden adresse.

POSThttps://api.grundfast.dk/v1/adgangsadresser/reverse:batch

Batch-udgaven af /v1/adgangsadresser/reverse til fx en liste af GPS-punkter eller målerplaceringer. Hvert punkt får den ene nærmeste adgangsadresse med afstand_m og bfe_nummer. Punkter sendes i WGS84 som lon/lat.

Punkter med samme koordinat (afrundet til ca. 10 cm) tælles én gang. Alle punkter tjekkes, før noget slås op: ligger ét uden for Danmark, afvises hele kaldet med 400, så en fejl i inputtet ikke gemmer sig i et ellers pænt svar.

Giv hvert punkt et id, så kan du parre svarene med dine egne rækker — det kommer med både i results og i errors. Et punkt uden adresse inden for radius står i errors med status 404 og koster ikke noget.

Antallet pr. kald følger planen: 50 på Pro, 100 på Scale og 150 på Enterprise. En længere liste afvises med 402, der nævner den plan, der tager den — eller send listen som et job.

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.

Kræver Pro-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

Én enhed pr. punkt, der fik en adresse.

Eksempel

curl -X POST "https://api.grundfast.dk/v1/adgangsadresser/reverse:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"punkter":[{"lon":12.5696,"lat":55.6757,"id":"maaler-1"},{"lon":10.2039,"lat":56.1527,"id":"maaler-2"}],"radius":200}'

Svar · eksempel200json

{
  "results": [
    {
      "id": "maaler-1",
      "punkt": { "lon": 12.5696, "lat": 55.6757 },
      "adresse": {
        "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 },
        "afstand_m": 8
      }
    },
    {
      "id": "maaler-2",
      "punkt": { "lon": 10.2039, "lat": 56.1527 },
      "adresse": {
        "betegnelse": "Park Allé 3, 8000 Aarhus C",
        "adgangsadresse_id": "0a3f5096-b10f-32b8-e044-0003ba298018",
        "bfe_nummer": 5623561,
        "vejnavn": "Park Allé",
        "husnr": "3",
        "postnr": "8000",
        "postnrnavn": "Aarhus C",
        "kommunekode": "0751",
        "koordinat": { "lon": 10.2040785, "lat": 56.1525951 },
        "afstand_m": 16
      }
    }
  ],
  "errors": [],
  "requested": 2,
  "succeeded": 2,
  "failed": 0,
  "radius": 200,
  "meta": { "kilde": "Datafordeler DAR via Grundfast", "grundfast_version": "0.1.0" }
}

Request-body

JSON med Content-Type: application/json.

punkterobject[]bodypåkrævet: Punkter som { lon, lat, id? } i WGS84. id er din egen nøgle (højst 64 tegn) og kommer med tilbage.
radiusintegerbodyvalgfri: Søgeradius i meter for alle punkter, 1–1000.Standard:200

Felter i svaret

results[].adresseobject: Den nærmeste adgangsadresse med afstand_m, adgangsadresse_id og bfe_nummer — samme form som i enkeltkaldet.
errors[]object[]: Punkter uden adresse inden for radius, med punkt, error og status: 404.
requestedinteger: Antal unikke punkter efter dubletfjernelse.

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	Body er ikke `{ punkter: [{ lon, lat, id? }] }`, et punkt ligger uden for Danmark, eller listen er længere, end nogen plan tager pr. kald.
401	Nøglen mangler eller er ugyldig.
402	Planen er under Pro, eller listen er længere end din plans loft pr. kald. Svaret nævner den plan, der tager den.
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
503	Adresseindekset er ikke slået til eller endnu ikke indlæst i dette miljø.

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

Bruges ofte sammen med

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

curl -X POST "https://api.grundfast.dk/v1/adgangsadresser/reverse:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"punkter":[{"lon":12.5696,"lat":55.6757,"id":"maaler-1"},{"lon":10.2039,"lat":56.1527,"id":"maaler-2"}],"radius":200}'

Svar · eksempel200json

{
  "results": [
    {
      "id": "maaler-1",
      "punkt": { "lon": 12.5696, "lat": 55.6757 },
      "adresse": {
        "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 },
        "afstand_m": 8
      }
    },
    {
      "id": "maaler-2",
      "punkt": { "lon": 10.2039, "lat": 56.1527 },
      "adresse": {
        "betegnelse": "Park Allé 3, 8000 Aarhus C",
        "adgangsadresse_id": "0a3f5096-b10f-32b8-e044-0003ba298018",
        "bfe_nummer": 5623561,
        "vejnavn": "Park Allé",
        "husnr": "3",
        "postnr": "8000",
        "postnrnavn": "Aarhus C",
        "kommunekode": "0751",
        "koordinat": { "lon": 10.2040785, "lat": 56.1525951 },
        "afstand_m": 16
      }
    }
  ],
  "errors": [],
  "requested": 2,
  "succeeded": 2,
  "failed": 0,
  "radius": 200,
  "meta": { "kilde": "Datafordeler DAR via Grundfast", "grundfast_version": "0.1.0" }
}