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.

POSThttps://api.grundfast.dk/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 koster ikke noget. Svarede kilden slet ikke for nogen af punkterne, svarer hele kaldet med den status.

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 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 · eksempel200json

{
  "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

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

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 · eksempel200json

{
  "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" }
}