Skip to content

Conditions

Overview

Conditions represent dynamic or situational information that affects tours or other spatial objects, such as closures, detours, notices, or current conditions. They are designed as standalone, reusable resources that can be linked to tours and other spatial entities.

Data Model Reference

The complete data model definition for a Condition is available here: Condition.

A Condition is based on schema.org/Condition and extended with domain-specific properties used across the discover.swiss ecosystem.

Condition as a Standalone Resource

Conditions are first-class objects and can be retrieved independently via the Condition API endpoint.

A full Condition object may include:

  • Identification
    • @id
    • identifier
  • Classification
    • type (always schema.org/Condition)
    • additionalType (e.g. Closure, Detour)
  • Spatial information
    • geo (point)
    • geoShape (line or polygon)
  • Context
    • category
    • tag
    • containedInPlace
  • Description
    • name
    • disambiguatingDescription
  • Metadata
    • lastModified
    • availableDataLanguage
    • license
    • dataGovernance (provider and source information)

Example: Condition Response (Partial)

The following example shows a partial Condition response. Some properties have been omitted for readability.

{
  "@id": "https://api.discover.swiss/info/v2/conditions/con_sx2_t97-cfhdbbg",
  "identifier": "con_sx2_t97-cfhdbbg",
  "type": "schema.org/Condition",
  "additionalType": "Detour",
  "name": "Geänderte Streckenführung, Sierre",
  "disambiguatingDescription": "Bitte beachten Sie die geänderte Streckenführung und folgen Sie der Signalisation vor Ort.",
  "geo": {
    "latitude": 46.27994,
    "longitude": 7.52335
  },
  "availableDataLanguage": ["de", "en", "fr", "it"],
  "license": "CC BY",
  "lastModified": "2025-10-15T21:11:19Z"
}

Conditions in SpatialCoverage

Conditions can appear in the spatialCoverage property of tours and other spatial objects when they are spatially relevant for that object. Relations are determined automatically from the available spatial data.

For details about relation types, relation behavior, and embedded reference semantics, see Spatial Coverage.

Retrieving Full Condition Details

For geometry, affected categories, and other full Condition properties, use the @id or identifier and request the Condition directly via the Condition API endpoint. Embedded references contain only a lightweight summary.

Condition Types (additionalType)

Conditions are classified using the additionalType property. Currently used types include:

  • Closure Full or partial closure of a route or area
  • Detour Changed route guidance or alternative routing
  • CurrentCondition Ongoing situational information (e.g. surface state)
  • Notice Informational notices without direct restrictions

Integrations should be resilient to new additional types in the future.

Data Sources and Provenance

Conditions are aggregated from trusted external providers and clearly attributed using dataGovernance.

Currently supported sources include:

  • SchweizMobil: Official ASTRA closures and route changes
  • OutdoorActive: OutdoorActive conditions and notices

Each Condition includes:

  • Source identifier
  • Provider metadata
  • License information
  • Last modification timestamp

This ensures transparency, traceability, and correct attribution.