Skip to content

Spatial Coverage

Overview

spatialCoverage contains embedded references to objects that are spatially relevant for another object. In the Infocenter it is mainly used on tours to expose conditions, protected areas, or similar spatial context that affects or overlaps the tour route.

For example, a Tour can include related entries in its spatialCoverage property when their geometry is relevant for the tour geometry.

Relation Types

The currently documented relation types are:

  • Condition: dynamic or situational information such as closures, detours, route changes, notices, or current conditions.
  • ProtectedArea: protected zones or areas whose rules may be relevant for the route.

Entries are returned as PlaceSimplex objects. A simplex object contains only the fields needed to identify and display the related object, for example @id, identifier, type, additionalType, and name.

How Relations Are Determined

Relations in spatialCoverage are derived automatically from the available spatial data. The system evaluates whether conditions, protected areas, or other spatial objects are relevant for the host object, for example because they intersect, overlap, or otherwise match the route or area geometry.

Example: Tour Spatial Coverage

The following example shows a partial spatialCoverage response on a tour:

"spatialCoverage": [
  {
    "@id": "https://api.discover.swiss/info/v2/conditions/con_sx2_s1t-cfhdgeb",
    "identifier": "con_sx2_s1t-cfhdgeb",
    "type": "schema.org/Condition",
    "additionalType": "Closure",
    "name": "Umleitung, Domat/Ems"
  },
  {
    "@id": "https://api.discover.swiss/info/v2/conditions/con_sx2_t97-cfhdgeb",
    "identifier": "con_sx2_t97-cfhdgeb",
    "type": "schema.org/Condition",
    "additionalType": "Detour",
    "name": "Umleitung, Domat/Ems"
  },
  {
    "@id": "https://api.discover.swiss/info/v2/protectedAreas/pra_t95_ctarccbq-hcbh-ebrs-qgre-bjqftqisfcct",
    "identifier": "pra_t95_ctarccbq-hcbh-ebrs-qgre-bjqftqisfcct",
    "type": "schema.org/ProtectedArea",
    "additionalType": "FloraProtectionArea",
    "name": "Calmut"
  }
]

Retrieving Full Details

Objects embedded in spatialCoverage are references, not complete objects. Full details are available by using the @id or identifier and requesting the referenced object directly:

Embedded entries are intentionally lightweight summaries of the relation. They do not represent the full geometry, rules, metadata, or provenance information of the referenced object.