Global DCC API (1.0.0)
Download OpenAPI specification:Download
There are currently no limits on how many requests and you can send to this API, but it can change later.
Binary
Calculate whatever native DCC understands
Authorizations:
query Parameters
roadNetId required | string or null Default: "DK" |
Request Body schema: application/jsonrequired
data | string or null <byte> The raw binary representation of a request |
messageVersion | integer <int32> The spc message version of the data in the request |
Responses
Request samples
- Payload
{- "data": "string",
- "messageVersion": 0
}
Response samples
- 200
- 404
{- "data": "string",
- "messageVersion": 0
}
Binary2
Calculate whatever native DCC understands, sending and receiving raw binary data. The version of the reply isstored in an integer in the first four bytes of the reply stream
Authorizations:
query Parameters
roadNetId required | string or null Default: "DK" |
version | integer <int32> |
Request Body schema: multipart/form-data
data | string or null <binary> |
Responses
Response samples
- 404
{- "type": "string",
- "title": "string",
- "status": 0,
- "detail": "string",
- "instance": "string",
- "property1": null,
- "property2": null
}
Distance
Calculate distance
Authorizations:
query Parameters
roadNetId required | string or null Default: "DK" |
Request Body schema: application/jsonrequired
(Coordinate (object or null)) A required source for the calculation | |
Array of objects or null (Coordinate) The destinations for the calculation | |
(Circumstance (object or null)) The circumstances of the calculations, optional | |
(CacheConfig (object or null)) Configure cache handling |
Responses
Request samples
- Payload
{- "source": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "destinations": [
- {
- "latitude": 55.699679,
- "longitude": 12.531683
}
], - "circumstance": {
- "optCriterion": 1,
- "calcDirection": 0,
- "velocityProfile": {
- "roadConfigs": [
- {
- "velocity": 80,
- "snapInAllowed": true,
- "snapInAddDistance": true,
- "roadTypeIsDivided": true
}
], - "linkToLinkCosts": [
- {
- "cost": 0,
- "extraPenalty": 0
}
]
}, - "vehicleAttributes": {
- "height": 0,
- "illegals": 0,
- "length": 0,
- "axisPressure": 0,
- "weight": 0
}, - "vehicleRestrictionUsage": {
- "ignoreOnewayRestrictions": false,
- "ignoreTurnAndUturnRestrictions": false,
- "ignoreDividers": false
}, - "snapLimits": {
- "snapRadius": 1000,
- "addSnapInDist": false
}
}, - "cache": {
- "skipLookup": false,
- "skipUpdate": false
}
}
Response samples
- 200
- 404
{- "backendRoadNetVersion": "string",
- "apiRoadNetVersion": "string",
- "source": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "circumstance": {
- "optCriterion": 1,
- "calcDirection": 0,
- "velocityProfile": {
- "roadConfigs": [
- {
- "velocity": 80,
- "snapInAllowed": true,
- "snapInAddDistance": true,
- "roadTypeIsDivided": true
}
], - "linkToLinkCosts": [
- {
- "cost": 0,
- "extraPenalty": 0
}
]
}, - "vehicleAttributes": {
- "height": 0,
- "illegals": 0,
- "length": 0,
- "axisPressure": 0,
- "weight": 0
}, - "vehicleRestrictionUsage": {
- "ignoreOnewayRestrictions": false,
- "ignoreTurnAndUturnRestrictions": false,
- "ignoreDividers": false
}, - "snapLimits": {
- "snapRadius": 1000,
- "addSnapInDist": false
}
}, - "answers": [
- {
- "length": 105,
- "duration": 13,
- "cost": 13,
- "destination": {
- "latitude": 55.699679,
- "longitude": 12.531683
}
}
]
}
Trace
Calculate trace
Authorizations:
query Parameters
roadNetId required | string or null Default: "DK" |
Request Body schema: application/jsonrequired
(Coordinate (object or null)) A required source for the calculation | |
(Coordinate (object or null)) The destination for the calculation | |
(Circumstance (object or null)) The circumstances of the calculations, optional | |
(CacheConfig (object or null)) Configure cache handling |
Responses
Request samples
- Payload
{- "source": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "destination": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "circumstance": {
- "optCriterion": 1,
- "calcDirection": 0,
- "velocityProfile": {
- "roadConfigs": [
- {
- "velocity": 80,
- "snapInAllowed": true,
- "snapInAddDistance": true,
- "roadTypeIsDivided": true
}
], - "linkToLinkCosts": [
- {
- "cost": 0,
- "extraPenalty": 0
}
]
}, - "vehicleAttributes": {
- "height": 0,
- "illegals": 0,
- "length": 0,
- "axisPressure": 0,
- "weight": 0
}, - "vehicleRestrictionUsage": {
- "ignoreOnewayRestrictions": false,
- "ignoreTurnAndUturnRestrictions": false,
- "ignoreDividers": false
}, - "snapLimits": {
- "snapRadius": 1000,
- "addSnapInDist": false
}
}, - "cache": {
- "skipLookup": false,
- "skipUpdate": false
}
}
Response samples
- 200
- 404
{- "backendRoadNetVersion": "string",
- "apiRoadNetVersion": "string",
- "source": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "circumstance": {
- "optCriterion": 1,
- "calcDirection": 0,
- "velocityProfile": {
- "roadConfigs": [
- {
- "velocity": 80,
- "snapInAllowed": true,
- "snapInAddDistance": true,
- "roadTypeIsDivided": true
}
], - "linkToLinkCosts": [
- {
- "cost": 0,
- "extraPenalty": 0
}
]
}, - "vehicleAttributes": {
- "height": 0,
- "illegals": 0,
- "length": 0,
- "axisPressure": 0,
- "weight": 0
}, - "vehicleRestrictionUsage": {
- "ignoreOnewayRestrictions": false,
- "ignoreTurnAndUturnRestrictions": false,
- "ignoreDividers": false
}, - "snapLimits": {
- "snapRadius": 1000,
- "addSnapInDist": false
}
}, - "answer": {
- "length": 105,
- "duration": 13,
- "cost": 13,
- "destination": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "trace": [
- {
- "latitude": 55.699679,
- "longitude": 12.531683
}
]
}
}
Traces
Calculate multiple traces
Authorizations:
query Parameters
roadNetId required | string or null Default: "DK" |
Request Body schema: application/jsonrequired
Array of objects or null (CoordinatePair) A required source for the calculation | |
(Circumstance (object or null)) The circumstances of the calculations, optional | |
(CacheConfig (object or null)) Configure cache handling |
Responses
Request samples
- Payload
{- "coordinatePairs": [
- {
- "source": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "destination": {
- "latitude": 55.699679,
- "longitude": 12.531683
}
}
], - "circumstance": {
- "optCriterion": 1,
- "calcDirection": 0,
- "velocityProfile": {
- "roadConfigs": [
- {
- "velocity": 80,
- "snapInAllowed": true,
- "snapInAddDistance": true,
- "roadTypeIsDivided": true
}
], - "linkToLinkCosts": [
- {
- "cost": 0,
- "extraPenalty": 0
}
]
}, - "vehicleAttributes": {
- "height": 0,
- "illegals": 0,
- "length": 0,
- "axisPressure": 0,
- "weight": 0
}, - "vehicleRestrictionUsage": {
- "ignoreOnewayRestrictions": false,
- "ignoreTurnAndUturnRestrictions": false,
- "ignoreDividers": false
}, - "snapLimits": {
- "snapRadius": 1000,
- "addSnapInDist": false
}
}, - "cache": {
- "skipLookup": false,
- "skipUpdate": false
}
}
Response samples
- 200
- 404
{- "traces": [
- {
- "source": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "answer": {
- "length": 105,
- "duration": 13,
- "cost": 13,
- "destination": {
- "latitude": 55.699679,
- "longitude": 12.531683
}, - "trace": [
- {
- "latitude": 55.699679,
- "longitude": 12.531683
}
]
}, - "backendRoadNetVersion": "string"
}
], - "circumstance": {
- "optCriterion": 1,
- "calcDirection": 0,
- "velocityProfile": {
- "roadConfigs": [
- {
- "velocity": 80,
- "snapInAllowed": true,
- "snapInAddDistance": true,
- "roadTypeIsDivided": true
}
], - "linkToLinkCosts": [
- {
- "cost": 0,
- "extraPenalty": 0
}
]
}, - "vehicleAttributes": {
- "height": 0,
- "illegals": 0,
- "length": 0,
- "axisPressure": 0,
- "weight": 0
}, - "vehicleRestrictionUsage": {
- "ignoreOnewayRestrictions": false,
- "ignoreTurnAndUturnRestrictions": false,
- "ignoreDividers": false
}, - "snapLimits": {
- "snapRadius": 1000,
- "addSnapInDist": false
}
}, - "apiRoadNetVersion": "string"
}