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.
https://api.grundfast.dk/v1/adgangsadresser/reverse:batchBatch-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}'{
"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.ider 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_idogbfe_nummer— samme form som i enkeltkaldet. errors[]object[]- Punkter uden adresse inden for
radius, medpunkt,errorogstatus: 404. requestedinteger- Antal rækker i svaret: dine punkter, efter at rækker med samme koordinat og samme
ider slået sammen.succeeded+failedgiver det samme tal.
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ø. |
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 nærmeste adresse
/v1/adgangsadresser /reverse - POSTVask mange adresser
/v1/datavask /adgangsadresser:batch - POSTOpret et job
/v1/jobs
Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.