{"openapi":"3.0.1","info":{"title":"Traffic messages API","description":"REST api to retrieve traffic messages.  \n  \n  \n**For internal use**. Changes may occur at any time.","version":"1.0.0"},"servers":[{"url":"/","description":"Default Server URL"}],"paths":{"/traffic-information/messages":{"get":{"tags":["Traffic Messages endpoint (v1)","Traffic Messages endpoint (v2)"],"summary":"Get traffic messages.","description":"Returns a list of traffic messages.","operationId":"getTrafficMessages","parameters":[{"name":"X-System-ID","in":"header","description":"Short name of client system. External systems should use the 'ext-' prefix","required":true,"schema":{"type":"string"},"example":"ext-system-name"},{"name":"include","in":"query","description":"Comma separated list that specifies extra elements that should be to returned for each message (by default they are not returned).","required":false,"schema":{"type":"array","items":{"type":"string","enum":["geometry","simpleGeometry","roadlink","alternativeRoute"]}},"example":"geometry"},{"name":"trafficImpact","in":"query","description":"Filter on traffic impact. Comma-separated list. Filter messages matching any of the supplied traffic impacts. Default no filtering is done.","required":false,"schema":{"type":"array","items":{"type":"string","description":"Enum for traffic impact.","enum":["very_large","large","small","unknown","none"]}},"example":"large"},{"name":"countyNumber","in":"query","description":"Filter on county number. Comma-separated list. Filter messages matching any of the supplied county numbers. Default no filtering is done.","required":false,"schema":{"type":"array","items":{"type":"integer","format":"int32"}},"example":50},{"name":"roadNumber","in":"query","description":"Filter on road number and/or road category. <br/>Possible values for road category: <ul><li>'E' (Europaveg)</li><li>'R' (Riksveg)</li><li>'F' (Fylkesveg)</li><li>'K' (Kommunal veg)</li></ul>Comma-separated list. <br/>Filter messages matching any of the supplied road numbers and/or road categories. Default no filtering is done.","required":false,"schema":{"type":"array","items":{"type":"string"}},"example":"E6"},{"name":"isOnPass","in":"query","description":"Filter messages on a known mountain pass or not. Default no filtering is done.","required":false,"schema":{"type":"boolean"}},{"name":"isAtNight","in":"query","description":"Filter messages active at night or not. Night is defined from 22:00 until 06:00. True means any messages active at night is returned. False means any messages active at day is returned. A message can be returned for both. Default no filtering is done.","required":false,"schema":{"type":"boolean"}},{"name":"fromDate","in":"query","description":"Filter if message is valid after this date. Matches against startTime and estimatedEndTime","required":false,"schema":{"type":"string","format":"date-time"},"example":"2023-03-28T10:00:00+02:00"},{"name":"toDate","in":"query","description":"Filter if message is valid before this date. Matches against startTime and estimatedEndTime","required":false,"schema":{"type":"string","format":"date-time"},"example":"2023-03-28T10:00:00+02:00"},{"name":"messageState","in":"query","description":"Filter on state of traffic message. Default messages that are active now and active later are returned (ie. not those that are recently closed)","required":false,"schema":{"type":"array","items":{"type":"string","description":"Enum for different message states.","enum":["recently_closed","active_now","active_later"]}}},{"name":"trafficManagement","in":"query","description":"Filter on traffic management type derived from traffic status and type of regulations. Default are all traffic messages, and filter values are not exhaustive for all statuses and regulations","required":false,"schema":{"type":"array","items":{"type":"string","description":"Enum for traffic management type derived from traffic status and type of regulations.","enum":["roadClosed","roadClosedForWinter","regulation","convoyService","riskOfRoadClosed","riskOfConvoyService","roadOpen"]}}},{"name":"trafficEventCategory","in":"query","description":"Filter on category of traffic message events","required":false,"schema":{"type":"array","items":{"type":"string","description":"Enum for traffic event categories, may indicate planned roadwork or other events","enum":["warning","roadworks","ferryService","weightRestriction","other"]}}},{"name":"sort","in":"query","description":"Sort traffic messages on last updated or traffic impact. Default sorted on road type and number","required":false,"schema":{"type":"string","description":"Enum for sorting parameters.","enum":["lastUpdated","trafficImpact"]}},{"name":"lang","in":"query","description":"Language. Supported values are 'no' (Norsk bokmål), 'nn' (Norsk nynorsk) or 'en' (Engelsk). Default if not specified is 'no'.","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","schema":{"type":"string","enum":["application/vnd.svv.v2+json;charset","application/vnd.svv.v2+geo+json;charset","application/vnd.svv.v1+json;charset","application/vnd.svv.v1+geo+json;charset"]}},{"name":"isActiveNow","in":"query","description":"Filter messages active now or not. Default no filtering is done.","required":false,"schema":{"type":"boolean"}},{"name":"hasVehiclesCharacteristics","in":"query","description":"Filter messages with vehicles characteristics or not. Default no filtering is done","required":false,"schema":{"type":"boolean"}},{"name":"hasAxlWeightRestriction","in":"query","description":"Filter messages with axl weight restrictions or not. Default no filtering is done","required":false,"schema":{"type":"boolean"}},{"name":"type","in":"query","description":"Filter what type of traffic message is returned. Default no filtering is done.","required":false,"schema":{"type":"array","items":{"type":"string","description":"Enum for type of traffic message.","enum":["RoadClosed","RoadClosedForWinter","ConvoyDriving","RiskOfRoadClosed","RiskOfRoadConvoy","Warning","RoadWork","GeneralWarning"]}}}],"responses":{"200":{"description":"Successful operation","content":{"application/vnd.svv.v2+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/TrafficMessageCollection"}},"application/vnd.svv.v2+geo+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/FeatureCollection"}},"application/vnd.svv.v1+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/TrafficMessageCollection"}},"application/vnd.svv.v1+geo+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/FeatureCollection"}}}},"400":{"description":"Bad request"},"404":{"description":"Not found"},"503":{"description":"Not available"}},"deprecated":true},"post":{"tags":["Traffic Messages endpoint (v2)"],"summary":"Get traffic messages within a polygon.","description":"Returns a list of traffic messages whose geometry intersects the supplied polygon. The polygon must be a valid GeoJSON Polygon in WGS84 (EPSG:4326).","operationId":"getTrafficMessagesForPolygon","parameters":[{"name":"X-System-ID","in":"header","description":"Short name of client system","required":true,"schema":{"type":"string"},"example":"SYSTEM-KORTNAVN"},{"name":"lang","in":"query","description":"Language. Supported values are 'no' (Norsk bokmål), 'nn' (Norsk nynorsk) or 'en' (Engelsk). Default if not specified is 'no'.","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","schema":{"type":"string","enum":["application/vnd.svv.v2+json;charset"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polygon"}}},"required":true},"responses":{"200":{"description":"Successful operation","content":{"application/vnd.svv.v2+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/TrafficMessageCollection"}}}},"400":{"description":"Bad request - missing or invalid polygon body"},"404":{"description":"Not found"},"503":{"description":"Not available"}}}},"/traffic-information/messages/by-ids":{"post":{"tags":["Traffic Messages endpoint (v2)"],"summary":"Get specific traffic messages for supplied message ids.","description":"Returns a list of traffic messages.","operationId":"getTrafficMessagesFromIdsV2","parameters":[{"name":"X-System-ID","in":"header","description":"Short name of client system","required":true,"schema":{"type":"string"},"example":"SYSTEM-KORTNAVN"},{"name":"include","in":"query","description":"Comma separated list that specifies extra elements that should be to returned for each message (by default they are not returned).","required":false,"schema":{"type":"array","items":{"type":"string","enum":["geometry","simpleGeometry","roadlink","alternativeRoute"]}},"example":"geometry"},{"name":"lang","in":"query","description":"Language. Supported values are 'no' (Norsk bokmål), 'nn' (Norsk nynorsk) or 'en' (Engelsk). Default if not specified is 'no'.","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","schema":{"type":"string","enum":["application/vnd.svv.v2+json;charset"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrafficMessageRequestDto"}}},"required":true},"responses":{"200":{"description":"Successful operation","content":{"application/vnd.svv.v2+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/TrafficMessageCollection"}},"application/vnd.svv.v2+geo+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/FeatureCollection"}}}},"400":{"description":"Bad request"},"404":{"description":"Not found"},"503":{"description":"Not available"}}}},"/traffic-information/messages/{messageIds}":{"get":{"tags":["Traffic Messages endpoint (v1)","Traffic Messages endpoint (v2)"],"summary":"Get specific traffic messages for supplied message ids.","description":"Returns a list of traffic messages.","operationId":"getTrafficMessagesFromIds","parameters":[{"name":"X-System-ID","in":"header","description":"Short name of client system","required":true,"schema":{"type":"string"},"example":"SYSTEM-KORTNAVN"},{"name":"messageIds","in":"path","description":"List of traffic message ids","required":true,"schema":{"type":"array","items":{"type":"string"}},"example":"NPRA_HBT_13-02-2023.2125,NPRA_HBT_24-03-2023.2889"},{"name":"viewTime","in":"query","description":"List of timestamps matching traffic message ids, indicating the date and time to calculate the status for the traffic message","required":false,"schema":{"type":"array","items":{"type":"string","format":"date-time"}},"example":"2025-10-28T10:14:00+02:00"},{"name":"include","in":"query","description":"Comma separated list that specifies extra elements that should be to returned for each message (by default they are not returned).","required":false,"schema":{"type":"array","items":{"type":"string","enum":["geometry","simpleGeometry","roadlink","alternativeRoute"]}},"example":"geometry"},{"name":"lang","in":"query","description":"Language. Supported values are 'no' (Norsk bokmål), 'nn' (Norsk nynorsk) or 'en' (Engelsk). Default if not specified is 'no'.","required":false,"schema":{"type":"string"}},{"name":"Accept","in":"header","schema":{"type":"string","enum":["application/vnd.svv.v2+json;charset","application/vnd.svv.v2+geo+json;charset","application/vnd.svv.v1+json;charset","application/vnd.svv.v1+geo+json;charset"]}}],"responses":{"200":{"description":"Successful operation","content":{"application/vnd.svv.v2+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/TrafficMessageCollection"}},"application/vnd.svv.v2+geo+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/FeatureCollection"}},"application/vnd.svv.v1+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/TrafficMessageCollection"}},"application/vnd.svv.v1+geo+json;charset=utf-8":{"schema":{"$ref":"#/components/schemas/FeatureCollection"}}}},"400":{"description":"Bad request"},"404":{"description":"Not found"},"503":{"description":"Not available"}},"deprecated":true}}},"components":{"schemas":{"Polygon":{"required":["coordinates","type"],"type":"object","allOf":[{"$ref":"#/components/schemas/Geometry"},{"type":"object","properties":{"type":{"type":"string","description":"Polygon"},"coordinates":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"number","description":"Coordinates in WGS 84 format","format":"double"}}}}}}]},"AlternativeRoute":{"required":["description"],"type":"object","properties":{"description":{"type":"string"},"geometry":{"$ref":"#/components/schemas/Geometry"}},"description":"Alternative route for a traffic message"},"County":{"required":["code","name"],"type":"object","properties":{"name":{"type":"string"},"code":{"type":"integer","format":"int32"},"bbox":{"type":"array","items":{"type":"number","format":"double"}}},"description":"County area with name, code and optional bounding box"},"Geometry":{"required":["type"],"type":"object","properties":{"type":{"type":"string"}},"discriminator":{"propertyName":"type"},"oneOf":[{"$ref":"#/components/schemas/Point"},{"$ref":"#/components/schemas/LineString"},{"$ref":"#/components/schemas/Polygon"},{"$ref":"#/components/schemas/MultiPoint"},{"$ref":"#/components/schemas/MultiLineString"},{"$ref":"#/components/schemas/MultiPolygon"}]},"Icon":{"required":["mapMarkerIcon"],"type":"object","properties":{"mapMarkerIcon":{"type":"string","description":"Enum for map marker icons.","example":"RoadClosed","enum":["RoadClosed","RoadClosedForWinter","ConvoyDriving","RiskOfRoadClosed","RiskOfRoadConvoy","Warning","RoadWork","GeneralWarning"]},"position":{"$ref":"#/components/schemas/Geometry"}},"description":"Icon and its position for the traffic message"},"LineString":{"required":["coordinates","type"],"type":"object","allOf":[{"$ref":"#/components/schemas/Geometry"},{"type":"object","properties":{"type":{"type":"string","description":"LineString"},"coordinates":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"number","description":"Coordinates in WGS 84 format","format":"double"}}}}}]},"Location":{"required":["isInTunnel","isOnBridge","isOnPass"],"type":"object","properties":{"geometry":{"$ref":"#/components/schemas/Geometry"},"isOnPass":{"type":"boolean","description":"Indicating if message is on a known mountain pass (\"fjellovergang\") or not","example":false},"isOnBridge":{"type":"boolean","description":"Indicating if message is on a known bridge or not","example":false},"isInTunnel":{"type":"boolean","description":"Indicating if message is in a known tunnel or not","example":false},"roadLinkReference":{"$ref":"#/components/schemas/RoadLinkReference"},"counties":{"type":"array","description":"List of counties affected","items":{"$ref":"#/components/schemas/County"}},"municipalities":{"type":"array","description":"List of municipalities affected","items":{"$ref":"#/components/schemas/Municipality"}},"roads":{"type":"array","description":"List of roads affected.","items":{"$ref":"#/components/schemas/Road"}}},"description":"Location information for the traffic message"},"LocationDescriptionDetails":{"required":["fromLocation","simpleLocationDescription"],"type":"object","properties":{"fromLocation":{"$ref":"#/components/schemas/LocationDetails"},"toLocation":{"$ref":"#/components/schemas/LocationDetails"},"direction":{"type":"string","description":"The direction for the traffic message if given in description of location"},"simpleLocationDescription":{"type":"string","description":"The direction for the traffic message if given in description of location"}},"description":"Details of the start and end location from the description of location"},"LocationDetails":{"required":["name"],"type":"object","properties":{"road":{"type":"string","description":"Road name from the description of location"},"junction":{"type":"string","description":"Junction number for exit or entry road from the description of location"},"ramp":{"type":"string","description":"Ramp for exit or entry road from the description of location"},"name":{"type":"string","description":"Name of the place from the description of location"},"municipality":{"type":"string","description":"Municipality from the description of location"},"county":{"type":"string","description":"County from the description of location"}},"description":"Details of a specific location, such as road, junction, ramp, etc."},"Metadata":{"required":["overallDataStatus","pagination"],"type":"object","properties":{"overallDataStatus":{"type":"string","enum":["OK","ALL_EXPIRED","SOME_EXPIRED"]},"pagination":{"$ref":"#/components/schemas/Pagination"}},"description":"Meta information describing the data collection"},"MultiLineString":{"required":["coordinates","type"],"type":"object","allOf":[{"$ref":"#/components/schemas/Geometry"},{"type":"object","properties":{"type":{"type":"string","description":"MultiLineString"},"coordinates":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"number","description":"Coordinates in WGS 84 format","format":"double"}}}}}}]},"MultiPoint":{"required":["coordinates","type"],"type":"object","allOf":[{"$ref":"#/components/schemas/Geometry"},{"type":"object","properties":{"type":{"type":"string","description":"MultiPoint"},"coordinates":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"number","description":"Coordinates in WGS 84 format","format":"double"}}}}}]},"MultiPolygon":{"required":["coordinates","type"],"type":"object","allOf":[{"$ref":"#/components/schemas/Geometry"},{"type":"object","properties":{"type":{"type":"string","description":"MultiPolygon"},"coordinates":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"number","description":"Coordinates in WGS 84 format","format":"double"}}}}}}}]},"Municipality":{"required":["code","name"],"type":"object","properties":{"name":{"type":"string"},"code":{"type":"integer","format":"int32"},"bbox":{"type":"array","description":"GeoJSON bounding box containing municipality.","items":{"type":"number","description":"GeoJSON bounding box containing municipality.","format":"double"}}},"description":"Municipality area with name, code and optional bounding box"},"NextTrafficStatus":{"required":["nextChangeTime","trafficStatus"],"type":"object","properties":{"trafficStatus":{"type":"string","description":"Enum for type of traffic status.","example":"RoadClosed","enum":["RoadClosed","Regulation","RoadOpen"]},"nextChangeTime":{"pattern":"yyyy-MM-dd'T'HH:mm:ssXXX","type":"string","description":"Next known change time for traffic status (ISO-8601 format)","format":"date-time","example":"2023-03-27T10:00:00+02:00"}},"description":"Next known change in traffic status for the traffic message","example":"RoadOpen"},"Pagination":{"required":["matchedElements","totalElements"],"type":"object","properties":{"totalElements":{"type":"integer","format":"int32"},"matchedElements":{"type":"integer","format":"int32"}},"description":"Pagination information for collections"},"Point":{"required":["coordinates","type"],"type":"object","allOf":[{"$ref":"#/components/schemas/Geometry"},{"type":"object","properties":{"type":{"type":"string","description":"Point"},"coordinates":{"type":"array","description":"Coordinates in WGS 84 format","items":{"type":"number","description":"Coordinates in WGS 84 format","format":"double"}}}}]},"Road":{"required":["name","number"],"type":"object","properties":{"name":{"type":"string","description":"Road name"},"number":{"type":"string","description":"Road number"},"category":{"type":"string","description":"Road category/road system reference name. Possible values: <ul><li>'E' (Europaveg)</li><li>'R' (Riksveg)</li><li>'F' (Fylkesveg)</li><li>'K' (Kommunal veg)</li><li>'P' (Privat veg)</li><li>'S' (Skogsveg)</li></ul>"},"bbox":{"type":"array","description":"GeoJSON bounding box containing road.","items":{"type":"number","description":"GeoJSON bounding box containing road.","format":"double"}},"geometry":{"$ref":"#/components/schemas/Geometry"}},"description":"Road with name, number, category, bounding box and geometry"},"RoadLinkLineMeasure":{"required":["direction","from","id","to"],"type":"object","properties":{"id":{"type":"integer","description":"Road link reference id","format":"int64","example":249541},"from":{"type":"number","description":"Road link line from measure","format":"double","example":0.7635778188705444},"to":{"type":"number","description":"Road link line to measure","format":"double","example":0.7961083650588989},"direction":{"type":"string","description":"Enum for road link directions.","example":"AGAINST","enum":["BOTH","WITH","AGAINST"]}},"description":"Road link line measure"},"RoadLinkLineReference":{"required":["category","measures","source","sourceDate","type"],"type":"object","allOf":[{"$ref":"#/components/schemas/RoadLinkReference"},{"type":"object","properties":{"source":{"type":"string","description":"Enum for road link source.","example":"NVDB","enum":["NVDB"]},"sourceDate":{"pattern":"yyyy-MM-dd","type":"string","description":"Source date (in ISO-8601 format)","format":"date","example":"2023-03-27"},"type":{"type":"string","description":"Enum for road link types.","example":"LINE","enum":["POINT","LINE"]},"category":{"type":"string","description":"Enum for road link categories.","example":"ROADWAY","enum":["ROADWAY","OVERVIEW"]},"measures":{"type":"array","description":"Road link line measure","items":{"$ref":"#/components/schemas/RoadLinkLineMeasure"}}}}]},"RoadLinkPointMeasure":{"required":["direction","id","measure"],"type":"object","properties":{"id":{"type":"integer","description":"Road link reference id","format":"int64","example":249541},"measure":{"type":"number","description":"Road link point measure","format":"double","example":0.7961083650588989},"direction":{"type":"string","description":"Enum for road link directions.","example":"AGAINST","enum":["BOTH","WITH","AGAINST"]}},"description":"Road link point measure"},"RoadLinkPointReference":{"required":["category","measure","source","sourceDate","type"],"type":"object","allOf":[{"$ref":"#/components/schemas/RoadLinkReference"},{"type":"object","properties":{"source":{"type":"string","description":"Enum for road link source.","example":"NVDB","enum":["NVDB"]},"sourceDate":{"pattern":"yyyy-MM-dd","type":"string","description":"Road link source date (in ISO-8601 format)","format":"date","example":"2023-03-27"},"type":{"type":"string","description":"Enum for road link types.","example":"POINT","enum":["POINT","LINE"]},"category":{"type":"string","description":"Enum for road link categories.","example":"ROADWAY","enum":["ROADWAY","OVERVIEW"]},"measure":{"$ref":"#/components/schemas/RoadLinkPointMeasure"}}}]},"RoadLinkReference":{"type":"object","description":"Road link reference","oneOf":[{"$ref":"#/components/schemas/RoadLinkPointReference"},{"$ref":"#/components/schemas/RoadLinkLineReference"}]},"TimePeriod":{"required":["endTimeOfPeriod","startTimeOfPeriod"],"type":"object","properties":{"startTimeOfPeriod":{"pattern":"HH:mm:ssXXX","type":"string","description":"Start time of period","example":"07:00:00+02:00"},"endTimeOfPeriod":{"pattern":"HH:mm:ssXXX","type":"string","description":"End time of period","example":"15:00:00+02:00"}},"description":"Time period within a day when the message is valid"},"TrafficEvent":{"required":["trafficEventDescription","trafficEventType"],"type":"object","properties":{"trafficEventDescription":{"type":"string","description":"Description of the traffic event"},"trafficEventType":{"type":"string","description":"Enum for traffic event types","enum":["weightRestrictionInOperation","majorEvent","resurfacingWork","maintenanceWork","vehicleRecovery","mobileRoadworks","seriousFire","vehicleOnFire","bridgeSwingInOperation","animalsOnTheRoad","riskOfAnimalsOnTheRoad","riskOfIce","riskOfSlippery","riskOfSnowAndIceDebris","riskOfLandslips","riskOfAvalanches","riskOfRockfalls","riskOfSurfaceWater","riskOfSlipperyRoad","surfaceWater","vehicleCarryingHazardousMaterials","loadCapacityChanged","serviceDelays","serviceSuspended","temporaryChangesToTimetables","flooding","controlledAvalanche","blackIce","objectOnTheRoad","slipperyRoad","slippery","peopleOnRoadway","ice","snowAndIceDebris","landslips","vehicleOnWrongCarriageway","denseFog","looseSnow","militaryConvoy","overnightClosures","oilOnRoad","clearanceWork","flashFloods","rescueAndRecoveryWork","visibilityReduced","freezingRain","dangerousSlowMovingVehicle","damagedRoadSurface","notWorking","snowOnTheRoad","snowDrifts","avalanches","slushOnRoad","specialPermitTransport","roadSurfaceInPoorCondition","blastingWork","brokenDownVehicle","transportOfVip","rockfalls","strongWinds","roadsideDrains","blowingDust","pollution","cyclistsOnRoadway","accident","fallenTrees","badWeather","roadworks","closedPermanentlyForTheWinter","exercise","accidentInvestigationWork","other","unknown"]}},"description":"Traffic event that is the reason for the traffic message"},"TrafficMessage":{"required":["activityStatus","dataFetchStatus","descriptionOfLocation","descriptionOfTrafficMessage","hasAlternativeRoute","hasVehiclesCharacteristics","hasWeightRestriction","icon","id","isActiveNow","isAtNight","isDayTime","location","locationDescriptionDetails","priorityScore","startTime","trafficEvent","trafficImpact","trafficStatus","type","updatedTime"],"type":"object","properties":{"dataFetchStatus":{"type":"string","description":"Data fetch status","example":"NPRA_HBT_13-02-2023.2125","enum":["ok","expired"]},"publicationTime":{"pattern":"yyyy-MM-dd'T'HH:mm:ssXXX","type":"string","description":"Datex publication time (ISO-8601 format)","format":"date-time","example":"2023-12-01T07:12:01+02:00"},"id":{"type":"string","description":"Unique ID identifying traffic message","example":"NPRA_HBT_13-02-2023.2125"},"type":{"type":"string","description":"Enum for type of traffic message.","example":"RoadClosed","enum":["RoadClosed","RoadClosedForWinter","ConvoyDriving","RiskOfRoadClosed","RiskOfRoadConvoy","Warning","RoadWork","GeneralWarning"]},"icon":{"$ref":"#/components/schemas/Icon"},"descriptionOfLocation":{"type":"string","description":"Description of the location.","example":"E6 Saltfjellet i Rana/Saltdal, Nordland"},"locationDescriptionDetails":{"$ref":"#/components/schemas/LocationDescriptionDetails"},"descriptionOfTrafficMessage":{"type":"string","description":"Description of the traffic message.","example":"Vegarbeid, vegen er stengt."},"validPeriodText":{"type":"string","description":"Validity period in text format","example":"Gjelder mellom 07:00 og 18:00 mandag, tirsdag og onsdag fra 13.05.2025 til 21.05.2025, gjelder mellom 15.05.2025 07:00 og 22.05.2025 15:00."},"publicCommentDescription":{"type":"string","description":"Public comment for the traffic message. Contains additional information to road users","example":"Utrykningskjøretøy kan passere."},"activityStatus":{"type":"string","description":"Enum for type of activity status.","enum":["active","inactive","future","overdue","closed"]},"isActiveNow":{"type":"boolean","description":"Indicating if message is currently active or not","example":false},"isAtNight":{"type":"boolean","description":"Indicating if message involves night or not","example":false},"isDayTime":{"type":"boolean","description":"Indicating if message involves day time or not","example":false},"trafficImpact":{"type":"string","description":"Enum for traffic impact.","example":"large","enum":["very_large","large","small","unknown","none"]},"trafficStatus":{"type":"string","description":"Enum for type of traffic status.","example":"RoadOpen","enum":["RoadClosed","Regulation","RoadOpen"]},"nextTrafficStatus":{"$ref":"#/components/schemas/NextTrafficStatus"},"trafficEvent":{"$ref":"#/components/schemas/TrafficEvent"},"trafficRegulations":{"type":"array","description":"List of traffic regulations that affect the traffic status","items":{"$ref":"#/components/schemas/TrafficRegulation"}},"startTime":{"pattern":"yyyy-MM-dd'T'HH:mm:ssXXX","type":"string","description":"Start time (ISO-8601 format)","format":"date-time","example":"2023-03-27T10:00:00+02:00"},"estimatedEndTime":{"pattern":"yyyy-MM-dd'T'HH:mm:ssXXX","type":"string","description":"Estimated end time (ISO-8601 format)","format":"date-time","example":"2023-03-31T10:00:00+02:00"},"updatedTime":{"pattern":"yyyy-MM-dd'T'HH:mm:ssXXX","type":"string","description":"Last updated time (ISO-8601 format)","format":"date-time","example":"2023-03-31T11:42:12+02:00"},"hasWeightRestriction":{"type":"boolean","description":"Boolean indicating if a weight restriction is in operation"},"hasAlternativeRoute":{"type":"boolean","description":"Boolean indicating if traffic message has alternative route(s)."},"hasVehiclesCharacteristics":{"type":"boolean","description":"Boolean indicating if traffic message has vehicles characteristics."},"location":{"$ref":"#/components/schemas/Location"},"validityPeriods":{"type":"array","description":"The period(s) for which a traffic message is valid","items":{"$ref":"#/components/schemas/ValidityPeriod"}},"alternativeRoute":{"type":"array","description":"The alternative route(s) for a traffic message","items":{"$ref":"#/components/schemas/AlternativeRoute"}},"closedTime":{"pattern":"yyyy-MM-dd'T'HH:mm:ssXXX","type":"string","description":"Closed time (ISO-8601 format). Field set by recently closed logic.","format":"date-time","example":"2023-09-19T11:42:12+02:00"},"externalIdentifier":{"type":"string","description":"External identifier for this message","example":"APV202211485"},"priorityScore":{"type":"integer","description":"Estimated priority score for this message","format":"int32","example":1600}},"description":"Model for traffic message DTO."},"TrafficMessageCollection":{"required":["metadata","trafficMessages"],"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/Metadata"},"trafficMessages":{"type":"array","items":{"$ref":"#/components/schemas/TrafficMessage"}}},"description":"Collection of traffic messages"},"TrafficRegulation":{"required":["description","type"],"type":"object","properties":{"description":{"type":"string","description":"Description of the traffic regulation that affects the traffic flow","example":"Omkjøring er skiltet"},"type":{"type":"string","description":"Enum for traffic regulation types","enum":["contraflow","followDiversionSigns","intermittentShortTermClosures","delaysIntermittentShortTermClosures","lanesDeviated","oneNarrowLanes","moreNarrowLanes","oneLaneClosures","moreLaneClosures","delays","longDelays","veryLongDelays","riskOfDelays","riskOfLongDelays","riskOfVeryLongDelays","noOvertaking","onlyTravelIfAbsolutelyNecessary","passableWithCare","advisorySpeedRestrictionInOperation","speedRestrictionInOperation","temporaryTrafficLights","trafficBeingManuallyDirected","useSnowChains","riskOfConvoyService","riskOfRoadClosed","convoyService","roadClosed","useOfSpecifiedLanesOrCarriagewaysAllowed"]},"trafficStatus":{"type":"string","description":"Enum for type of traffic status.","example":"RoadClosed","enum":["RoadClosed","Regulation","RoadOpen"]},"vehicleRestrictions":{"type":"array","description":"Vehicle restrictions that the regulation applies to","items":{"$ref":"#/components/schemas/VehicleRestriction"}}},"description":"Traffic regulation that affects the traffic flow"},"ValidityPeriod":{"required":["endOfPeriod","startOfPeriod"],"type":"object","properties":{"startOfPeriod":{"pattern":"yyyy-MM-dd'T'HH:mm:ssXXX","type":"string","description":"Start of period (ISO-8601 format)","format":"date-time","example":"2023-03-27T10:00:00+02:00"},"endOfPeriod":{"pattern":"yyyy-MM-dd'T'HH:mm:ssXXX","type":"string","description":"End of period (ISO-8601 format)","format":"date-time","example":"2023-03-31T10:00:00+02:00"},"applicableDays":{"type":"array","description":"List of day(s) in the week the message is valid","example":["monday","tuesday"],"items":{"type":"string","description":"Enum for day of week.","example":"[\"monday\",\"tuesday\"]","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]}},"timeOfDay":{"type":"array","description":"List of time period(s) the message is valid","items":{"$ref":"#/components/schemas/TimePeriod"}}},"description":"Period for which a traffic message is valid"},"VehicleRestriction":{"required":["description"],"type":"object","properties":{"description":{"type":"string","description":"Description of the vehicle characteristics that this regulation applies to","example":"over 3,5 tonn"}},"description":"Restriction for a specific vehicle group, e.g. weight, type, etc."},"TrafficMessageRequestDto":{"required":["messageIds","viewTimes"],"type":"object","properties":{"messageIds":{"type":"array","items":{"type":"string"}},"viewTimes":{"type":"array","items":{"type":"string","format":"date-time"}}},"description":"List of timestamps matching traffic message ids, indicating the date and time to calculate the status for the traffic message"},"Feature":{"required":["type"],"type":"object","properties":{"type":{"type":"string"},"geometry":{"$ref":"#/components/schemas/Geometry"},"properties":{"$ref":"#/components/schemas/TrafficMessage"}},"description":"GeoJson 'Feature' object"},"FeatureCollection":{"required":["features","metadata","type"],"type":"object","properties":{"metadata":{"$ref":"#/components/schemas/Metadata"},"type":{"type":"string"},"features":{"type":"array","description":"List of features","items":{"$ref":"#/components/schemas/Feature"}}},"description":"GeoJson 'FeatureCollection' object"}}}}