Skip to content

← API reference

Modelled sun hours on the plot

sun_hours11 fields11 of these fields open in the demo
Source
Approach horizon model on Kartverket DSM/DTM
Geography
The address point
Reported stale after
400 days
Access
Requires an API key granted this section
Contract version
1
In packages
outdoor_recreation

What this does not say

Quoted verbatim from the section’s warnings field, exactly as the API returns it. They are not translated: a translation would show something other than what your response actually contains.

  • Clear-sky geometric hours above the terrain and surface horizon at the address point; vegetation and future buildings are as captured in the surface model, and weather is not modelled.
  • Straight-line EPSG:25833 distances from the address point to the feature; not travel distance. Source features are imported as published, with their own accuracy and update cadence; updated_at is our import time.

Fields

3 of 11 fields are value fields — the ones that decide whether a record actually says anything. The rest are context: identifiers, codes and timestamps. Fields marked “open” return values to anonymous callers; the rest require a key.

FieldTypeRoleDemo
feature_idstring | nullcontextopen
labelstring | nullcontextopen
municipality_codestring | nullcontextopen
updated_atstring | nullcontextopen
sun_hours_jun21number | nullvalueopen
sun_hours_mar21number | nullvalueopen
sun_hours_dec21number | nullvalueopen
methodstring | nullcontextopen
near_gridstring | nullcontextopen
far_gridstring | nullcontextopen
horizon_profile_degarray<number> | nullcontextopen

Fetch this section

curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643?include=sun_hours"

# paginated, one section at a time
curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643/sections/sun_hours?limit=25"

Try it now

This is a real call against the public demo, from here. What appears below is what the API returned — not a sample.