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.
https://api.grundfast.dk/v1/dagi/reverse:batchBatch-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"}]}'{
"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.idkommer med tilbage i svaret.
Felter i svaret
results[].omraaderobject[]- Områderne for punktet med
tema,kodeognavn— som i enkeltkaldet. Et manglende tema er uafklaret, ikke fraværende. errors[]object[]- Punkter uden svar fra kilden, med
punkt,errorogstatus.
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ø. |
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.
{
"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øgleBruges ofte sammen med
- GETFind områder for et punkt
/v1/dagi /reverse - POSTFind adresser for mange punkter
/v1/adgangsadresser /reverse:batch - POSTOpret et job
/v1/jobs
Læs mere om DAGI, og hvad data kan bruges til, på produktsiden.