Storm-surge freeboard at the address (model)
storm_surge_freeboard39 fieldsNot in the demo
Available with: bought bundle or agreed plan (all fields) · Pricing
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.
- Estimate, not Kartverket's storm-surge map (stormflo aktsomhetskart) and not a flood assessment of the plot: a modelled still-water margin from public height and sea-level data.
- freeboard_<T>y_<year>_m = ground height at the address point (Kartverket Høydedata, NN2000; ground_height_source says which terrain model answered, dtm1 where the 1 m model covers it) minus the still-water level of the T-year storm surge in that year. Negative means the water stands above the ground. Return levels today and land uplift come from Kartverket's tide API, sampled once per 2 km of coast (the API answers per tide zone, so neighbouring buildings share one answer). The 2100 level adds Kartverket's projected relative change between its 200-year polygons today and in 2100 at the nearest stretch of coast (relative_sea_level_change_2100_m; uplift is already in it, absolute_sea_level_rise_2100_m adds it back for transparency). 2050 interpolates that change linearly from 2020 (reference_year), which overstates an accelerating rise slightly, so 2050 errs low. The same change is applied to the 20- and 1000-year levels.
- Still water only: waves, wind set-up, river flow and rain are not included, and the address point is not the lowest door or the basement. first_reaching_scenario reads today, 2050, 2100 in turn and within each year the 20-, 200- and 1000-year event; null means none of the nine reaches the ground, or the inputs are missing (scenarios_evaluated says how many could be computed). A future scenario is null, not today's value, when the sea-level change is unknown.
- Only addresses within 500 m of Kartverket's largest storm-surge extent are scored; inland addresses have no row. in_storm_surge_200y_present_polygon and polygon_agrees are null outside Kartverket's model coverage. The validation block is agreement with Kartverket's own 200-year polygons over all scored addresses: both use terrain heights and similar levels, so it checks consistency, not truth on the ground.
- Licence: Kartverket tide API and Høydedata, CC BY 4.0; Stormflo og havnivå polygons, NLOD. Attribution: Kartverket. Model: Approach.
Fields
6 of 39 fields are value fields — the ones that decide whether a record actually says anything. The rest are context: identifiers, codes and timestamps.
| Field | Type | Role |
|---|---|---|
| method | string | null | context |
| method_version | string | null | context |
| ground_height_m_nn2000 | number | null | context |
| ground_height_source | string | null | context |
| tide_location_code | string | null | context |
| tide_fetched_at | timestamp | null | context |
| land_uplift_cm_per_year | number | null (årstall) | context |
| return_level_20y_m_nn2000 | number | null | context |
| return_level_200y_m_nn2000 | number | null | context |
| return_level_1000y_m_nn2000 | number | null | context |
| highest_observed_m_nn2000 | number | null | context |
| relative_sea_level_change_2100_m | number | null | context |
| absolute_sea_level_rise_2100_m | number | null | context |
| sea_level_polygons_updated_at | timestamp | null | context |
| reference_year | integer | null (årstall) | context |
| freeboard_20y_present_m | number | null | value |
| freeboard_200y_present_m | number | null | value |
| freeboard_1000y_present_m | number | null | value |
| freeboard_20y_2050_m | number | null | context |
| freeboard_200y_2050_m | number | null | value |
| freeboard_1000y_2050_m | number | null | context |
| freeboard_20y_2100_m | number | null | context |
| freeboard_200y_2100_m | number | null | value |
| freeboard_1000y_2100_m | number | null | context |
| still_water_level_20y_present_m_nn2000 | number | null | context |
| still_water_level_200y_present_m_nn2000 | number | null | context |
| still_water_level_1000y_present_m_nn2000 | number | null | context |
| still_water_level_20y_2050_m_nn2000 | number | null | context |
| still_water_level_200y_2050_m_nn2000 | number | null | context |
| still_water_level_1000y_2050_m_nn2000 | number | null | context |
| still_water_level_20y_2100_m_nn2000 | number | null | context |
| still_water_level_200y_2100_m_nn2000 | number | null | context |
| still_water_level_1000y_2100_m_nn2000 | number | null | context |
| first_reaching_scenario | string | null | value |
| scenarios_evaluated | integer | null | context |
| in_storm_surge_200y_present_polygon | boolean | null | context |
| polygon_agrees | boolean | null | context |
| validation | object | null | context |
| updated_at | timestamp | null | context |
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 --fail-with-body --silent --show-error \ -H "X-API-Key: $APPROACH_API_KEY" \ 'https://api.approach.no/api/v1/addresses/285717643?include=storm_surge_freeboard' # paginated, one section at a time curl --fail-with-body --silent --show-error \ -H "X-API-Key: $APPROACH_API_KEY" \ 'https://api.approach.no/api/v1/addresses/285717643/sections/storm_surge_freeboard?limit=25'
Why it cannot be tried here
This section is not part of the public demo projection. That is a licensing and privacy decision, not a sign the data is missing: it is served to customers granted the section.