Global DCC API (1.0.0)

Download OpenAPI specification:Download

Authentication

This API uses Basic authentication. Available users are gdcc and sdm.

Rate limiting

There are currently no limits on how many requests and you can send to this API, but it can change later.

Version 0 endpoints

Binary

Calculate whatever native DCC understands

Authorizations:

Basic

query Parameters

roadNetId

required

string or null

Default: "DK"

Request Body schema: application/json

data	string or null <byte>
messageVersion	integer <int32>

Responses

Request samples

Payload

Content type

application/json

{"data": "string",
"messageVersion": 0
}

Response samples

200
404

Content type

application/json

{"data": "string",
"messageVersion": 0
}

Distance

Calculate distance

Authorizations:

Basic

query Parameters

roadNetId

required

string or null

Default: "DK"

Request Body schema: application/json

required	object (Coordinate)
required	Array of objects (Coordinate)
	(Circumstance (object or null))
	(CacheConfig (object or null))

Responses

Request samples

Payload

Content type

application/json

{"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
}
]
}
},
"cache": {"skipLookup": false,
"skipUpdate": false
}
}

Response samples

200
404

Content type

application/json

{"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
}
]
}
},
"answers": [{"length": 105,
"duration": 13,
"cost": 13,
"destination": {"latitude": 55.699679,
"longitude": 12.531683
}
}
]
}

Trace

Calculate trace

Authorizations:

Basic

query Parameters

roadNetId

required

string or null

Default: "DK"

Request Body schema: application/json

required	object (Coordinate)
required	object (Coordinate)
	(Circumstance (object or null))
	(CacheConfig (object or null))

Responses

Request samples

Payload

Content type

application/json

{"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
}
]
}
},
"cache": {"skipLookup": false,
"skipUpdate": false
}
}

Response samples

200
404

Content type

application/json

{"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
}
]
}
},
"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:

Basic

query Parameters

roadNetId

required

string or null

Default: "DK"

Request Body schema: application/json

required	Array of objects (CoordinatePair)
	(Circumstance (object or null))
	(CacheConfig (object or null))

Responses

Request samples

Payload

Content type

application/json

{"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
}
]
}
},
"cache": {"skipLookup": false,
"skipUpdate": false
}
}

Response samples

200
404

Content type

application/json

{"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
}
]
}
},
"apiRoadNetVersion": "string"
}

Available roadNets

Returns a list of all available roadNets. Returned roadNetId can be passed to other endpoints, like trace, distance, binary.

Authorizations:

Basic

Responses

Response samples

200

Content type

application/json

[{"roadNetId": "DK",
"description": "Denmark"
}
]