Spring til indhold

Grundfast

Find områder for mange punkter

De administrative områder for op til 50 punkter i ét kald, med en fejl pr. punkt, kilden ikke svarede for.

POST/v1/dagi/reverse:batch

Batch-udgaven af /v1/dagi/reverse. Hvert punkt får præcis det svar, enkeltkaldet giver: region, kommune, sogn, retskreds, politikreds og opstillingskreds. Et punkt på havet er et svar med tom omraader, ikke en fejl.

Loftet er 50 punkter på alle planer. Hvert punkt er sit eget spørgsmål til DAGI’s polygoner hos kilden, så batchen er dimensioneret efter kilden og ikke efter planen. Længere lister sender du som et job med kind: "dagi".

Et punkt, kilden ikke svarede for, står i errors med enkeltkaldets status (502 eller 503) og faktureres ikke. Svarede kilden slet ikke for nogen af punkterne, svarer hele kaldet med den status.

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. Ligger ét punkt uden for Danmark, afvises hele kaldet med 400 og tæller som ét kald i kvoten.

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 blev besvaret.

Eksempel

curl -X POST "https://api.grundfast.dk/v1/dagi/reverse:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"punkter":[{"lon":12.5696,"lat":55.6757,"id":"a"},{"lon":10.2039,"lat":56.1527,"id":"b"}]}'
Svar · eksempel200
{
  "results": [
    {
      "id": "a",
      "punkt": { "lon": 12.5696, "lat": 55.6757 },
      "epsg25832": [724435.9176121107, 6175763.745249988],
      "antal": 6,
      "omraader": [
        { "tema": "region", "kode": "1084", "navn": "Region Hovedstaden" },
        { "tema": "kommune", "kode": "0101", "navn": "København" },
        { "tema": "sogn", "kode": "7002", "navn": "Helligånds" },
        { "tema": "retskreds", "kode": "1101", "navn": "Københavns Byret" },
        { "tema": "politikreds", "kode": "1470", "navn": "Københavns Politi" },
        { "tema": "opstillingskreds", "kode": null, "navn": "Indre By" }
      ]
    }
  ],
  "errors": [],
  "requested": 1,
  "succeeded": 1,
  "failed": 0,
  "meta": { "kilde": "Datafordeler DAGI via Grundfast", "grundfast_version": "0.1.0" }
}

Request-body

JSON med Content-Type: application/json.

punkterobject[]bodypåkrævet
1–50 punkter som { lon, lat, id? } i WGS84. id kommer med tilbage i svaret.

Felter i svaret

results[].omraaderobject[]
Områderne for punktet med tema, kode og navn — som i enkeltkaldet. Et manglende tema er uafklaret, ikke fraværende.
errors[]object[]
Punkter uden svar fra kilden, med punkt, error og status.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Body er ikke { punkter: [{ lon, lat, id? }] } med 1–50 punkter, eller et punkt ligger uden for Danmark.
401Nøglen mangler eller er ugyldig.
402Planen er under Pro.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502DAGI-tjenesten svarede ikke for nogen af punkterne.
503DAGI-geometrikilden er ikke konfigureret 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/dagi/reverse:batch

Bruges ofte sammen med

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