Spring til indhold

Grundfast

Hent et terrænprofil

Terrænet langs en ret linje mellem to punkter, med faldet over linjen i meter.

GET/v1/dhm/profil

Linjen samples for hver trin meter fra fra mod til, og begge endepunkter er altid med — også når linjen ikke går op i et helt antal trin. Den sidste station ligger så tættere på sin nabo; afstand_m viser det. Afstande måles i EPSG:25832, altså i rigtige meter.

fald_m er forskellen mellem højeste og laveste terrænkote på linjen — typisk faldet fra vej til skel, som en skrå højdegrænseplan efter BR18 § 177 regnes ud fra. Svaret angiver faldet, ikke om et projekt overholder reglerne; den vurdering er din og kommunens.

Linjen må højst være 2000 m lang og give højst 500 stationer; en længere linje afvises med en 400, der nævner længden og grænsen. Del en længere strækning op i flere profiler.

Hele linjen læses fra ét højderaster, ikke ét opslag pr. station. På linjer over ca. 240 m kan rasteret være læst med en grovere celle end 0,4 m; oploesning_m siger, hvilken.

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. returneret station — samme pris som at slå koterne op én ad gangen.

Eksempel

curl "https://api.grundfast.dk/v1/dhm/profil?fra=9.9147,56.031834&til=9.91534,56.031834&trin=10" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "fra": {
    "lon": 9.9147,
    "lat": 56.031834
  },
  "til": {
    "lon": 9.91534,
    "lat": 56.031834
  },
  "laengde_m": 39.88,
  "trin_m": 10,
  "punkter": [
    {
      "afstand_m": 0,
      "lon": 9.9147,
      "lat": 56.031834,
      "terraen_m": 23.9
    },
    {
      "afstand_m": 10,
      "lon": 9.9148605,
      "lat": 56.031834,
      "terraen_m": 24.55
    },
    {
      "afstand_m": 20,
      "lon": 9.9150209,
      "lat": 56.031834,
      "terraen_m": 24.52
    },
    {
      "afstand_m": 30,
      "lon": 9.9151814,
      "lat": 56.031834,
      "terraen_m": 24.31
    },
    {
      "afstand_m": 39.88,
      "lon": 9.91534,
      "lat": 56.031834,
      "terraen_m": 23.9
    }
  ],
  "terraen_min_m": 23.9,
  "terraen_maks_m": 24.55,
  "fald_m": 0.65,
  "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"
  }
}

Parametre

frastringquerypåkrævet
Linjens startpunkt som lon,lat i WGS84-decimalgrader.Eksempel: 9.9147,56.031834
tilstringquerypåkrævet
Linjens slutpunkt som lon,lat i WGS84-decimalgrader.Eksempel: 9.91534,56.031834
trinnumberqueryvalgfri
Afstanden mellem stationer i meter. Mindst 0,4 (modellens cellestørrelse), og stort nok til at profilet holder sig under 500 stationer.Standard:1Eksempel: 10

Felter i svaret

laengde_mnumber
Linjens længde i meter, målt i EPSG:25832.
punkter[]{ afstand_m, lon, lat, terraen_m }
Stationerne i rækkefølge fra fra. terraen_m er i meter DVR90, eller null hvor modellen ingen data har.
fald_mnumber | null
terraen_maks_m − terraen_min_m. null, når ingen station havde data.
trin_mnumber
Den stationsafstand, der blev brugt.
oploesning_mnumber
Den rastercelle, koterne er læst fra.

Statuskoder

StatusBetydning
200Svaret er leveret.
400fra eller til er ikke lon,lat eller ligger uden for Danmark, punkterne er ens, linjen er over 2000 m, trin er under 0,4, eller profilet ville få over 500 stationer.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Højdemodellen kunne ikke nås.
503DHM-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

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

GET /v1/dhm/profil?fra=9.9147%2C56.031834&til=9.91534%2C56.031834&trin=10

Bruges ofte sammen med

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