Ground motion and its trend from the European Ground Motion Service
Vertical ground velocity near the address in mm per year, and how it changed between the first and second half of the record, from the median displacement of European Ground Motion Service points. An estimate from radar reflectors, relative to EGMS's reference network, not a survey of the building or plot.
Status right now
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: none — not served through the API
Model and method
How fast is the ground near the address moving, and is that changing?
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
- Model
- Method
- Statistical method
- 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
- EGMS calibrated vertical displacement (Copernicus Land Monitoring Service)
Headline output fields
vertical_velocity_mm_per_year, velocity_change_mm_per_year, motion_class
Declared comparison basis
none yet: relative to EGMS's reference network, with no independent levelling to compare with
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.
EGMS (Copernicus Land Monitoring Service): the programme's "CC BY 4.0" is not on any primary page read; Land data policy conditions apply, scripted download and attribution wording for derived values are unresolved (SAT-1). Source terms for this earth-observation product are not settled: the SAT-1 evidence packet is a draft and no source-use decision is recorded (SAT-A2b). Customer redistribution of the derived value is unverified. Pending legal review.
API warnings
The API returns these notes in warnings.
- Estimate, not a survey or a geotechnical assessment: the Theil-Sen (median pairwise) slope of the median vertical displacement of EGMS measurement points near the address, in mm per year, and how that slope changed between the first and second half of the record (velocity_change_mm_per_year; negative: sinking faster than before). It does not say a building is damaged or will be.
- Method egms-theil-sen-v1. Needs at least 3 points, 12 epochs and 3 years of record, otherwise the record is abstained (too_few_points, too_few_epochs, record_too_short). motion_class: stable under 2 mm/yr, slow under 5, attention from 5 (Approach screening thresholds, not a standard). Radar sees stable reflectors only: no points near the address means no answer, not stable ground. Velocities are relative to EGMS's reference network. Distinct from ground_motion (NGU InSAR Norge) and ground_subsidence (building-level model): other source, other processing, so the figures need not agree.
- status is estimated or abstained. An abstained record says why in abstain_reason and carries no figure: too little evidence is not a zero. evidence_class model_estimate: a model answer over satellite statistics, not a measurement at the address. release_id, release_version and artifact_sha256 name the model release that computed the record; source_ids name the scenes, epochs or tiles behind it, scene_dates their acquisition dates, and usable_coverage the share of the window that was actually observed (null where the source has no such notion). Derived statistics only: no imagery, tile or quicklook is served or kept for serving.
- The licence and attribution for this source are not settled: the section is held for reviewed access until the source-use decisions are recorded (SAT-A2b), a record is served only while every decision behind it is current, and attribution is the wording the release states.
Provider-contract fields
3 of 29 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 |
|---|---|---|
| status | string | null | context |
| abstain_reason | string | null | context |
| evidence_class | string | null | context |
| warnings | array<string> | null | context |
| source_ids | array<string> | null | context |
| scene_dates | array<string> | null | context |
| acquired_from | date | null | context |
| acquired_to | date | null | context |
| usable_coverage | number | null | context |
| release_id | string | null | context |
| release_version | string | null | context |
| artifact_sha256 | string | null | context |
| model_version | string | null | context |
| inputs_digest | string | null | context |
| method_version | string | null | context |
| attribution | string | null | context |
| uncertainty | object | null | context |
| vertical_velocity_mm_per_year | number | null (mm/år) | value |
| velocity_change_mm_per_year | number | null (mm/år) | value |
| cumulative_displacement_mm | number | null | context |
| motion_class | string | null | value |
| direction | string | null | context |
| points_used | integer | null | context |
| epochs | integer | null | context |
| series_from | string | null | context |
| series_to | string | null | context |
| egms_release | string | null | context |
| point_ids_sha256 | string | null | context |
| computed_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 --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=egms_ground_motion'
# 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/egms_ground_motion?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.