Hent koter for flere punkter

Terrænkoter for op til 50 punkter i ét kald — fx hjørnerne af en tegnet bygning og det nærmeste skelpunkt.

POSThttps://api.grundfast.dk/v1/dhm/kote:batch

Hvert punkt får samme svar som /v1/dhm/kote. Punkter på samme grund ligger inden for få meter af hinanden, så ét højderaster besvarer dem alle; det sparer opslag hos kilden, ikke penge.

Giv hvert punkt et id (fx "NV" eller "sokkel"), og det sendes retur på både svar og fejl, så du kan parre dem uden at stole på rækkefølgen. Punkter med samme koordinat (afrundet til 1e-6 grader) tælles én gang, og det første id beholdes — en lukket ring, der gentager sit første hjørne, koster ikke ekstra.

Alle koordinater valideres, før nogen af dem slås op: ét ugyldigt punkt giver en 400, der navngiver punktet. Et punkt, der ikke kunne besvares, havner i fejl — aldrig i punkter med en null, for inden for ét svar ville de to se ens ud, og kun den ene betyder, at modellen ikke har terræn dér.

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.

Afregning

Én enhed pr. unikt punkt, som ved enkeltopslag; kun besvarede punkter afregnes. Kræver ikke en bestemt plan.

Eksempel

curl -X POST "https://api.grundfast.dk/v1/dhm/kote:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"punkter":[{"lon":9.9147,"lat":56.031834,"id":"NV"},{"lon":9.91534,"lat":56.031834,"id":"NØ"}]}'

Svar · eksempel200json

{
  "punkter": [
    {
      "id": "NV",
      "punkt": {
        "lon": 9.9147,
        "lat": 56.031834
      },
      "epsg25832": [
        557000.03,
        6209999.99
      ],
      "terraen_m": 23.9,
      "overflade_m": 35.93,
      "system": "DVR90",
      "system_epsg": 5799,
      "oploesning_m": 0.4,
      "metode": "naermeste_celle",
      "usikkerhed_m": 0.05,
      "meta": {
        "kilde": "Dataforsyningen DHM via Grundfast",
        "grundfast_version": "0.1.0"
      }
    },
    {
      "id": "NØ",
      "punkt": {
        "lon": 9.91534,
        "lat": 56.031834
      },
      "epsg25832": [
        557039.91,
        6210000.52
      ],
      "terraen_m": 23.9,
      "overflade_m": 23.9,
      "system": "DVR90",
      "system_epsg": 5799,
      "oploesning_m": 0.4,
      "metode": "naermeste_celle",
      "usikkerhed_m": 0.05,
      "meta": {
        "kilde": "Dataforsyningen DHM via Grundfast",
        "grundfast_version": "0.1.0"
      }
    }
  ],
  "fejl": [],
  "forespurgt": 2,
  "besvaret": 2,
  "fejlet": 0,
  "meta": {
    "kilde": "Dataforsyningen DHM via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Request-body

JSON med Content-Type: application/json.

punkterobject[]bodypåkrævet: Mellem 1 og 50 punkter, hver { lon, lat, id? } i WGS84-decimalgrader.
punkter[].idstringbodyvalgfri: Din egen betegnelse for punktet, 1–64 tegn. Ekkoes i svaret og i fejl.

Felter i svaret

punkter[]DhmPunkt & { id }: Ét besvaret punkt i samme form som /v1/dhm/kote, plus dit id (eller null).
fejl[]{ id, punkt, error }: Punkter, der ikke kunne besvares. De optræder aldrig i punkter. error er upstream DHM error, når højdemodellen fejlede for punktet, eller en besked om, at kaldet løb tør for tid, før punktet blev hentet — begge kan prøves igen.
forespurgtinteger: Antal unikke punkter efter sammenlægning af dubletter.
besvaret / fejletinteger: Hvor mange der landede i henholdsvis punkter og fejl.

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	Body’en er ikke `{ punkter: [{ lon, lat, id? }] }`, har 0 eller over 50 punkter, eller et punkt ligger uden for Danmark. Fejlen navngiver punktet.
401	Nøglen mangler eller er ugyldig.
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
502	Ikke ét eneste punkt kunne besvares. Delvise fejl er en 200 med punkterne i `fejl`.
503	DHM-kilden 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 DHM, og hvad data kan bruges til, på produktsiden.

curl -X POST "https://api.grundfast.dk/v1/dhm/kote:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"punkter":[{"lon":9.9147,"lat":56.031834,"id":"NV"},{"lon":9.91534,"lat":56.031834,"id":"NØ"}]}'

Svar · eksempel200json

{
  "punkter": [
    {
      "id": "NV",
      "punkt": {
        "lon": 9.9147,
        "lat": 56.031834
      },
      "epsg25832": [
        557000.03,
        6209999.99
      ],
      "terraen_m": 23.9,
      "overflade_m": 35.93,
      "system": "DVR90",
      "system_epsg": 5799,
      "oploesning_m": 0.4,
      "metode": "naermeste_celle",
      "usikkerhed_m": 0.05,
      "meta": {
        "kilde": "Dataforsyningen DHM via Grundfast",
        "grundfast_version": "0.1.0"
      }
    },
    {
      "id": "NØ",
      "punkt": {
        "lon": 9.91534,
        "lat": 56.031834
      },
      "epsg25832": [
        557039.91,
        6210000.52
      ],
      "terraen_m": 23.9,
      "overflade_m": 23.9,
      "system": "DVR90",
      "system_epsg": 5799,
      "oploesning_m": 0.4,
      "metode": "naermeste_celle",
      "usikkerhed_m": 0.05,
      "meta": {
        "kilde": "Dataforsyningen DHM via Grundfast",
        "grundfast_version": "0.1.0"
      }
    }
  ],
  "fejl": [],
  "forespurgt": 2,
  "besvaret": 2,
  "fejlet": 0,
  "meta": {
    "kilde": "Dataforsyningen DHM via Grundfast",
    "grundfast_version": "0.1.0"
  }
}