Seasonal closures

The avoid[feature]=seasonalClosure parameter enables the user to calculate routes that avoid seasonal closures.

Seasonal closures are a specific type of restriction where the time period of the closure encoded in the HERE map is approximate. Due to this approximate nature, the default behavior of the Routing API is to ignore these types of restrictions in the map data. Instead, the Routing API relies on traffic data to provide accurate and up to date closure information at these locations.

Routes that pass through seasonal closures contain info level notices that inform users that the route may be going through a closure. It is up to users to verify the open/closed status of the road or ferry.

Examples of seasonal closure notices

User requested avoid seasonal closures and route goes through an active seasonal closure

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.3890,12.4981&'\
'destination=52.3882,12.4982&'\
'via=52.38867,12.498142!passThrough=true&'\
'transportMode=truck&'\
'avoid[features]=seasonalClosure&'\
'departureTime=2025-02-01T12:00:00&'\
'apiKey=YOUR_API_KEY'

"notices":[
  {
    "title":"Violated avoid seasonal closure.",
    "code":"violatedAvoidSeasonalClosure",
    "severity":"critical",
    "details":[
      {
        "type":"restriction",
        "cause":"Route violates seasonal closure.",
        "timeDependent":true,
        "restrictedTimes":"+(M1){M3}(M11){M2}"
      }
    ]
  }
]

User didn't request avoid seasonal closures and route passes through seasonal closure

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'origin=52.3890,12.4981&'\
'destination=52.3882,12.4982&'\
'transportMode=truck&'\
'departureTime=any&'\
'apiKey=YOUR_API_KEY'

"notices": [
  {
    "title": "Route goes through seasonal closure.",
    "code": "seasonalClosure",
    "severity": "info",
    "details": [
      {
        "type": "restriction",
        "cause": "Route goes through a seasonal closure.",
        "timeDependent": true
      }
    ]
  }
]

Updated last month