Spring til indhold

Grundfast

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.

POST/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) slås op og tælles én gang, men svaret går til hvert id, du har sendt på den koordinat. Kun en række, der gentager både koordinat og id, fjernes som dublet. 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. Det afviste kald tæller som ét kald i kvoten.

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 faktureres ikke.

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. unik koordinat, der fik en adresse. Kvote-headerne tæller hver unik koordinat i listen.

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 · eksempel200
{
  "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 rækker i svaret: dine punkter, efter at rækker med samme koordinat og samme id er slået sammen. succeeded + failed giver det samme tal.

Statuskoder

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

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

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

POST /v1/adgangsadresser/reverse:batch

Bruges ofte sammen med

Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.