Skip to content

← All sections

Modelled sun hours on the plot

Modelled clear-sky sun hours at the address point on 21 June, 21 March and 21 December, from the terrain and surface horizon. An estimate from geometry, not measured sunshine, and weather is not included.

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

Read about this data source →

Status right now

State
Within budget
Combined section status is within the age and schedule budget. Check the separate data timestamp for data freshness.
Last loaded
22 Nov 2026
Data freshness evidence
Not measured yet
Unverified: only collection time is known.
Newest record
not measured

Measured 22 Nov 2026. This is about the section as a whole, not one address: an address outside coverage still gets “not covered”, never “no”.

Available with: trial key (open fields) · bundle or agreed plan, subject to field policy and source grants · Pricing

Model and method

How many hours of direct sun does the address get through the year?

This is model metadata from the contract. Results are estimates, not observed source facts. Declared maturity and reference comparison do not establish that the current model release is approved or available to the customer.

Result type
Calculation
Method
Geometric calculation
Declared maturity
Experimental
Reference comparison
No qualified comparison declared
Contract version
1
Model artifact and runtime version
Not established by this catalogue description
Inputs, headline fields and comparison basis

Declared inputs

  • DSM and DTM (Kartverket)

Headline output fields

sun_hours_jun21, sun_hours_mar21, sun_hours_dec21

Declared comparison basis

none yet: clear-sky horizon model

Input names are not a complete training dataset or revision-pinned lineage. Read the caveats and response metadata for what a particular result is based on.

Source terms and reuse

These are declarations from the catalogue contract, not a new rights approval. Customer access, source agreements and privacy need separate assessment. A licence label does not establish coverage or reviewed content.

Declared licence or terms
unverified
Declared redistribution
Not established
Catalogue basis
Unverified
Attribution and note

Shown from the contract in its original language.

Computed by Approach; the terms of its inputs named in source apply and have not been reviewed together.

API warnings

The API returns these notes in warnings.

  • Estimate, not measured sunshine: 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.
  • Sensitive to where the point stands: the observer is 1.6 m above the surface model at the address point, which can be a roof, and a 10° sector is decided by single 4 m cells. Moving the point 2.2 m changed the 21 June hours by 2.4 h on average over 30 addresses (6 Oct 2026); read the figure as the character of the plot, not to the hour.
  • Computed nightly in rotation through the kommuner (method horizon-36az-noaa-v2 from 6 Oct 2026; a national pass takes about four nights). An address without a row is not_found with reason not_yet_computed: unknown, not no sun. method horizon-36az-noaa-v1 rows are older per-address windows and are rescored in turn.
  • 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.

Provider-contract 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” also occur in the demo projection, which may have different field definitions. Other fields require the appropriate field policy and source access, not just 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

Send the key in the X-API-Key header. The section can be fetched with the rest of the address, or on its own with pagination.

curl --disable --fail-with-body --silent --show-error --connect-timeout 10 --max-time 30 \
  -H "X-API-Key: ${APPROACH_API_KEY:?APPROACH_API_KEY is not set}" \
  'https://api.approach.no/api/v1/addresses/285717643?include=sun_hours'

# paginated, one section at a time
curl --disable --fail-with-body --silent --show-error --connect-timeout 10 --max-time 30 \
  -H "X-API-Key: ${APPROACH_API_KEY:?APPROACH_API_KEY is not set}" \
  '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.