The Stau1 API consists of a set of REST API endpoints providing access to historic, incident-based traffic data in Germany as well as related road and location data. Most data and data structures are based on or derived from the TMC standard.
\nAny usage of API endpoints described in this documentation as well as the documentation itself is subject to TechSeed GmbH's General Terms, its API Terms & Conditions and Privacy Policy.
Stau1's Traffic Data Archive Search API allows retrieving historic traffic information reported for highways (Autobahnen) and other local roads types (Bundesstraßen, Landstraßen) in Germany.
The data pool consists of incident-based traffic events as reported and electronically transmitted to our database by local state government- and police agencies.
\n\nIMPORTANT DISCLAIMER: Although comprehensive and covering the majority of traffic events, Stau1 and its data sources are not liable for completeness and accuracy of traffic data collected.
\n
See Traffic Archive API Reference
\n\n
Whenever possible, the location of a traffic incident is allocated to a specific road and road section. The Road Data API provides respective Road Location Data for a given road or region.
\n\nThis API endpoint allows querying the traffic incident event code database and is helpful for decoding event codes provided by the Traffic Archive API.
\n\nTraffic and Road data can be filtered by State (Bundesland). Different German states are represented by Region IDs.
See List of Region IDs
Simple authentication is provided via a dedicated API key. Since API usage charges are dependent on the number of requests performed during a certain time period and are attributed to your API key, it is important that you don't expose your API key to the public in order to prevent misue of your account which may result in unexpected charges.
\n\n\nThe API key used in this documentation is for testing purposes only and limited to querying traffic incidents of July 1, 2019.
\n
In case an API request results in an error, the error is represented by an error object in the JSON response object.
\n\n
\nThis endpoint returns a list of traffic incidents (=Messages) reported during a certain period of time for selected roads, road segments, regions or a combination of all of those.
\n","urlObject":{"protocol":"https","path":["messages","search"],"host":["api","stau1","de"],"query":[{"description":{"content":"[required] Please replace with your own API key that is assigned to your Stau1 account.
\n","type":"text/plain"},"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE"},{"description":{"content":"[required] In combination with the end param, sets the time period of the search request. The selected time period must not exceed 24 hours. Date \nTime Format is YYYYMMDDhhmm.
\n","type":"text/plain"},"key":"start","value":"201907010700"},{"description":{"content":"[required] In combination with the start param, sets the time period of the search request. The selected time period must not exceed 24 hours. Date \nTime Format is YYYYMMDDhhmm.\nThe selected time period in this example ranges from July 1, 2019 7:00AM to 8:00AM.
\n","type":"text/plain"},"key":"end","value":"201907010800"},{"description":{"content":"[optional] Limits the search to a single or a comma separated list of road name(s) or even sub-sections of roads. In this example the search is limited to incidents on Autobahn A3 and A42. However, for Autobahn A3 only traffic incidents affecting the road's Location Points 50101.23 (=Kreuz Kaiserberg) and 50101.234 (Kreuz Oberhausen) or Location Points between those points are considered.
\nFormat: roadName[|locPoint1|locPoint2|direction]
\nOptional (if one of the following is set the remaining two need to be set as well):
\n[optional] roadids is identical with the roads parameter with the only difference that roads are identified by their roadId instead of their name. See Road Data API Documentation for details.
In this example the roadId 50101 represents Autobahn A3 whereas 7105 is Autobahn A42.
Parameters roadids and roads cannot be used in combination.
[optional] When used limits the search to one single or a comma separated list of road types:
\n[optional] Limits the search to traffic incidents located in a single or a comma separated list of regions. Each region ID represents a German state. In order to include all states in the research result simply remove this parameter entirely from your query.
Please refer to the Region Code Documentation to see which region ID is matching which state.
[optional] Limits the search to incidents located within a radius of 25 kilometers around the geo location defined by longitude,latitude values in this parameter. An additional radius parameter can be used to adjust the radius ranging from 1 to 100 kilometers.
The near parameter cannot be used in conjunction with regions.
[optional] Only valid in conjunction with near parameter. Values can range from 1 to 100, default value is 25. The radius is measured in kilometers.
\n","type":"text/plain"},"key":"radius","value":"10"},{"description":{"content":"[optional] If set to 1, the versions[] object of the API response includes an array of affected Road Location Points in messages[key].versions[].points[].
[optional] If set to 1, the messages[key].versions[] array not only contains the earliest version of a message but includes all versions sorted by their publishing date.
[optional] If set to 1 each message version in the versions[] array of the API response contains an events array which is encoding the traffic event in a standardized format as described in the Traffic Event API documentation.
[optional] Default value is 1. The search result is paginated. The amount of result sets per page is determined by the amtpp parameter which defaults to 25. The API response provides information about the amount of available pages in the stats.pages property.
[optional] The amount of search results which are returned per page / request. The default and maximum value is 25.
\n","type":"text/plain"},"key":"amtpp","value":"10"}],"variable":[]}},"response":[{"id":"3e4c5047-6fe3-4030-acad-110d6ca1b0c7","name":"Search Historic Traffic Data Example","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.stau1.de/messages/search?apikey=mbnKf6hhPsSMAGvLBKUIlosDmE&start=201907010700&end=201907010800&roads=A3|50101.23|50101.234|-1,A42®ions=260","protocol":"https","host":["api","stau1","de"],"path":["messages","search"],"query":[{"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE","description":"[required] API Key necessary to authorize requests. Replace with your personal API key issued to you by Stau1.\nThe API key in this sample request can only be used for querying traffic reports on July 1, 2019\n"},{"key":"start","value":"201907010700","description":"[required] In combination with the **end** param, sets the time period of the search request. The selected time period must not exceed 24 hours. Date \nTime Format is *YYYYMMDDHHMM*.\n\n"},{"key":"end","value":"201907010800","description":"[required] In combination with the **start** param, sets the time period of the search request. The selected time period must not exceed 24 hours. Date \nTime Format is *YYYYMMDDHHMM*.\nThe selected time period in this sample ranges from *July 1, 2019 7:00AM to 8:00AM*."},{"key":"roads","value":"A3|50101.23|50101.234|-1,A42","description":"[optional] Limits the search to a single or a comma separated list of road name(s) or even sub-sections of roads. In this example the search is limited to incidents on Autobahn *A3* and *A42*. However, for Autobahn *A3* only traffic incidents affecting the road's Location Points *50101.23* (=Kreuz Kaiserberg) and *50101.234* (Kreuz Oberhausen) or Location Points between those points are considered. \n\n**Format:** *roadName*[|*locPoint1*|*locPoint2*|*direction*] \n* *roadName*: e.g. *A1*, *B8* or *L145*\n \nOptional (if one of the following is set the remaining two need to be set as well):\n* *locPoint1*: The Road Location Id of *roadName* defining the start of the road section to be searched for traffic incidents.\n* *locPoint2*: The Road Location Id of *roadName* defining the end of the road section to be searched for traffic incidents.\n* *direction*: 0 = road is searched in both driving directions; 1 = road is searched in its ordinary driving direction only; -1 = road is searched in the opposite driving direction only.\n\n"},{"key":"regions","value":"260"},{"key":"","value":"","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 26 Nov 2019 01:07:25 GMT"},{"key":"Server","value":"Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips"},{"key":"X-Powered-By","value":"Express"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"21492"},{"key":"ETag","value":"W/\"53f4-PYo/bO8UOGbxP4u+pPWBpVGvNM0\""},{"key":"X-FRAME-OPTIONS","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": {\n \"params\": {\n \"start\": \"201907010700\",\n \"end\": \"201907010800\",\n \"roads\": [\n \"A3|50101.234|50101.23|-1\",\n \"A42\"\n ],\n \"roadIds\": [\n \n ],\n \"regions\": [\n 260\n ],\n \"flexGeo\": 0,\n \"age\": 24,\n \"history\": 0,\n \"locPoints\": 0,\n \"eventCodes\": 0,\n \"page\": 1,\n \"amtpp\": 20\n },\n \"stats\": {\n \"total\": 15,\n \"pages\": 1,\n \"version\": 1578013505649,\n \"page\": 1,\n \"sections\": [\n \n ],\n \"regions\": [\n 260\n ],\n \"amt\": 15,\n \"rect\": [\n [\n 52.44035,\n 7.250629713615012\n ],\n [\n 50.33895,\n 9.4346\n ]\n ],\n \"cacheId\": \"1b18bc9483e5475ff69f0c5f5ad43a3076935281\"\n },\n \"messages\": {\n \"6b2SW3ty5P\": {\n \"srcId\": \"DNWLMSNW98384-20190701T041700Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T04:25:10.231Z\",\n \"srcId\": \"DNWLMS-NW-98384-2019-07-01T04:17:00Z\",\n \"hashId\": \"2RaEhejsXc\",\n \"published\": \"2019-07-01T04:17:00.000Z\",\n \"pubStr\": \"Jul 1, 2019, 6:17 AM - 8:32 AM Uhr\",\n \"text\": {\n \"road\": \"A3\",\n \"segment\": \"Arnheim - Oberhausen\",\n \"section\": \"zwischen Kreuz Oberhausen und Oberhausen-Holten (11)\",\n \"events\": \"Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T04:17:00.000Z\",\n \"updated\": \"2019-07-01T06:20:14.617Z\",\n \"expires\": \"2019-07-01T06:32:15.712Z\",\n \"pubStr\": \"Jul 1, 2019, 6:17 AM - 8:32 AM Uhr\",\n \"road\": {\n \"roadId\": 50101,\n \"road\": \"A3\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"cyVHqRbHTv\": {\n \"srcId\": \"DNWLMSNW98397-20190701T043403Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T04:40:12.048Z\",\n \"srcId\": \"DNWLMS-NW-98397-2019-07-01T04:34:03Z\",\n \"hashId\": \"0MjOrZS6n3\",\n \"published\": \"2019-07-01T04:34:03.000Z\",\n \"pubStr\": \"Jul 1, 2019, 6:34 AM - 7:07 AM Uhr\",\n \"text\": {\n \"road\": \"A3\",\n \"segment\": \"Oberhausen - Köln\",\n \"section\": \"zwischen Oberhausen-Lirich (13) und Kreuz Kaiserberg (14)\",\n \"events\": \"1 km Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T04:34:03.000Z\",\n \"updated\": \"2019-07-01T04:55:12.531Z\",\n \"expires\": \"2019-07-01T05:07:14.995Z\",\n \"pubStr\": \"Jul 1, 2019, 6:34 AM - 7:07 AM Uhr\",\n \"road\": {\n \"roadId\": 50101,\n \"road\": \"A3\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"eMqWj6tLDW\": {\n \"srcId\": \"DNWLMSNW98399-20190701T043603Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T04:45:12.870Z\",\n \"srcId\": \"DNWLMS-NW-98399-2019-07-01T04:36:03Z\",\n \"hashId\": \"RaXSOoK4Pd\",\n \"published\": \"2019-07-01T04:36:03.000Z\",\n \"pubStr\": \"Jul 1, 2019, 6:36 AM - 7:09 AM Uhr\",\n \"text\": {\n \"road\": \"A3\",\n \"segment\": \"Arnheim - Oberhausen\",\n \"section\": \"zwischen Dinslaken-Süd (9) und Kreuz Oberhausen (10)\",\n \"events\": \"Gefahr durch ungesicherte Unfallstelle\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T04:36:03.000Z\",\n \"updated\": \"2019-07-01T04:55:12.033Z\",\n \"expires\": \"2019-07-01T05:09:57.000Z\",\n \"pubStr\": \"Jul 1, 2019, 6:36 AM - 7:09 AM Uhr\",\n \"road\": {\n \"roadId\": 50101,\n \"road\": \"A3\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"rI7A9mTS4S\": {\n \"srcId\": \"DNWLMSNW98467-20190701T052907Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:35:12.366Z\",\n \"srcId\": \"DNWLMS-NW-98467-2019-07-01T05:29:07Z\",\n \"hashId\": \"kIgLQwQ2iO\",\n \"published\": \"2019-07-01T05:29:07.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:29 AM - 7:52 AM Uhr\",\n \"text\": {\n \"road\": \"A3\",\n \"segment\": \"Oberhausen - Köln\",\n \"section\": \"zwischen Oberhausen-Lirich (13) und Kreuz Kaiserberg (14)\",\n \"events\": \"1 km Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:29:07.000Z\",\n \"updated\": \"2019-07-01T05:35:12.366Z\",\n \"expires\": \"2019-07-01T05:52:14.736Z\",\n \"pubStr\": \"Jul 1, 2019, 7:29 AM - 7:52 AM Uhr\",\n \"road\": {\n \"roadId\": 50101,\n \"road\": \"A3\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"X7ZhDBZANp\": {\n \"srcId\": \"DNWLMSNW98476-20190701T053634Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:45:10.463Z\",\n \"srcId\": \"DNWLMS-NW-98476-2019-07-01T05:36:34Z\",\n \"hashId\": \"Zwazs1gFg3\",\n \"published\": \"2019-07-01T05:36:34.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:36 AM - 8:12 AM Uhr\",\n \"text\": {\n \"road\": \"A3\",\n \"segment\": \"Oberhausen - Köln\",\n \"section\": \"zwischen Kreuz Kaiserberg (14) und Duisburg-Wedau (15)\",\n \"events\": \"2 km Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:36:34.000Z\",\n \"updated\": \"2019-07-01T06:00:12.807Z\",\n \"expires\": \"2019-07-01T06:12:15.764Z\",\n \"pubStr\": \"Jul 1, 2019, 7:36 AM - 8:12 AM Uhr\",\n \"road\": {\n \"roadId\": 50101,\n \"road\": \"A3\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"9yTpQ0qmyt\": {\n \"srcId\": \"DNWLMSNW98507-20190701T055933Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T06:05:11.825Z\",\n \"srcId\": \"DNWLMS-NW-98507-2019-07-01T05:59:33Z\",\n \"hashId\": \"UrszbCuLpg\",\n \"published\": \"2019-07-01T05:59:33.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:59 AM - 8:17 AM Uhr\",\n \"text\": {\n \"road\": \"A3\",\n \"segment\": \"Oberhausen - Köln\",\n \"section\": \"zwischen Oberhausen-Lirich (13) und Kreuz Kaiserberg (14)\",\n \"events\": \"1 km Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:59:33.000Z\",\n \"updated\": \"2019-07-01T06:05:11.825Z\",\n \"expires\": \"2019-07-01T06:17:16.524Z\",\n \"pubStr\": \"Jul 1, 2019, 7:59 AM - 8:17 AM Uhr\",\n \"road\": {\n \"roadId\": 50101,\n \"road\": \"A3\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"RudSOH73bE\": {\n \"srcId\": \"DNWLMSNW98412-20190701T045108Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:00:11.559Z\",\n \"srcId\": \"DNWLMS-NW-98412-2019-07-01T04:51:08Z\",\n \"hashId\": \"ebFIJb1OJM\",\n \"published\": \"2019-07-01T04:51:08.000Z\",\n \"pubStr\": \"Jul 1, 2019, 6:51 AM - 7:12 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Gelsenkirchen-Schalke (17) und Gelsenkirchen-Zentrum (16)\",\n \"events\": \"2 km Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T04:51:08.000Z\",\n \"updated\": \"2019-07-01T05:00:11.559Z\",\n \"expires\": \"2019-07-01T05:12:13.892Z\",\n \"pubStr\": \"Jul 1, 2019, 6:51 AM - 7:12 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"yBpmV8qWIf\": {\n \"srcId\": \"DNWLMSNW98430-20190701T050402Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:10:12.341Z\",\n \"srcId\": \"DNWLMS-NW-98430-2019-07-01T05:04:02Z\",\n \"hashId\": \"UxzHOOedGt\",\n \"published\": \"2019-07-01T05:04:02.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:04 AM - 7:37 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Gelsenkirchen-Schalke (17) und Gelsenkirchen-Zentrum (16)\",\n \"events\": \"Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:04:02.000Z\",\n \"updated\": \"2019-07-01T05:20:11.643Z\",\n \"expires\": \"2019-07-01T05:37:17.015Z\",\n \"pubStr\": \"Jul 1, 2019, 7:04 AM - 7:37 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"iMhcbV4Opp\": {\n \"srcId\": \"DNWLMSNW98432-20190701T050529Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": 1,\n \"inserted\": \"2019-07-01T05:10:15.410Z\",\n \"srcId\": \"DNWLMS-NW-98432-2019-07-01T05:05:29Z\",\n \"hashId\": \"uhqcy408AL\",\n \"published\": \"2019-07-01T05:05:29.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:05 AM - 7:54 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Kamp-Lintfort - Dortmund\",\n \"section\": \"zwischen Kreuz Kamp-Lintfort (1, 8) und Moers-Nord (2) brennender PKW\",\n \"events\": \"\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:05:29.000Z\",\n \"updated\": \"2019-07-01T05:40:14.878Z\",\n \"expires\": \"2019-07-01T05:54:38.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:05 AM - 7:54 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"rOwgOpyPAe\": {\n \"srcId\": \"DNWLMSNW98449-20190701T051707Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": 1,\n \"inserted\": \"2019-07-01T05:25:08.940Z\",\n \"srcId\": \"DNWLMS-NW-98449-2019-07-01T05:17:07Z\",\n \"hashId\": \"gqLoAWZiJD\",\n \"published\": \"2019-07-01T05:17:07.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:17 AM - 8:02 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Kamp-Lintfort - Dortmund\",\n \"section\": \"zwischen Moers-Nord (2) und Duisburg-Baerl (3)\",\n \"events\": \"Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:17:07.000Z\",\n \"updated\": \"2019-07-01T05:25:08.940Z\",\n \"expires\": \"2019-07-01T06:02:15.721Z\",\n \"pubStr\": \"Jul 1, 2019, 7:17 AM - 8:02 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"3TUmO4RSAb\": {\n \"srcId\": \"DNWLMSNW98465-20190701T052713Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:35:09.723Z\",\n \"srcId\": \"DNWLMS-NW-98465-2019-07-01T05:27:13Z\",\n \"hashId\": \"sbIBdTybW1\",\n \"published\": \"2019-07-01T05:27:13.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:27 AM - 7:47 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Kreuz Herne (21) und Herne-Crange (20)\",\n \"events\": \"2 km Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:27:13.000Z\",\n \"updated\": \"2019-07-01T05:35:09.723Z\",\n \"expires\": \"2019-07-01T05:47:16.455Z\",\n \"pubStr\": \"Jul 1, 2019, 7:27 AM - 7:47 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"ZJrnRufEuo\": {\n \"srcId\": \"DNWLMSNW98473-20190701T053534Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:40:12.082Z\",\n \"srcId\": \"DNWLMS-NW-98473-2019-07-01T05:35:34Z\",\n \"hashId\": \"w7ubEqspW5\",\n \"published\": \"2019-07-01T05:35:34.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:35 AM - 8:02 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Gelsenkirchen-Schalke (17) und Gelsenkirchen-Zentrum (16)\",\n \"events\": \"2 km Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:35:34.000Z\",\n \"updated\": \"2019-07-01T05:45:10.638Z\",\n \"expires\": \"2019-07-01T06:02:15.721Z\",\n \"pubStr\": \"Jul 1, 2019, 7:35 AM - 8:02 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"2StMdu8teW\": {\n \"srcId\": \"DNWLMSNW98474-20190701T053536Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:40:15.075Z\",\n \"srcId\": \"DNWLMS-NW-98474-2019-07-01T05:35:36Z\",\n \"hashId\": \"erRyNjjI97\",\n \"published\": \"2019-07-01T05:35:36.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:35 AM - 8:02 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Herne-Baukau (22) und Kreuz Herne (21)\",\n \"events\": \"1 km Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:35:36.000Z\",\n \"updated\": \"2019-07-01T05:40:15.075Z\",\n \"expires\": \"2019-07-01T06:02:15.721Z\",\n \"pubStr\": \"Jul 1, 2019, 7:35 AM - 8:02 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"5y4Gtm0ArQ\": {\n \"srcId\": \"DNWLMSNW98487-20190701T054831Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:55:10.122Z\",\n \"srcId\": \"DNWLMS-NW-98487-2019-07-01T05:48:31Z\",\n \"hashId\": \"jEHt8TRXNf\",\n \"published\": \"2019-07-01T05:48:31.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:48 AM - 8:27 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Kreuz Duisburg-Nord (6) und Duisburg-Beeck (5)\",\n \"events\": \"Stau\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:48:31.000Z\",\n \"updated\": \"2019-07-01T05:55:10.122Z\",\n \"expires\": \"2019-07-01T06:27:17.335Z\",\n \"pubStr\": \"Jul 1, 2019, 7:48 AM - 8:27 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"CkjzMTbFFP\": {\n \"srcId\": \"DNWLMSNW98502-20190701T055834Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T06:05:08.887Z\",\n \"srcId\": \"DNWLMS-NW-98502-2019-07-01T05:58:34Z\",\n \"hashId\": \"czR7OiZjgQ\",\n \"published\": \"2019-07-01T05:58:34.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:58 AM - 8:47 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Herne-Wanne (19) und Gelsenkirchen-Bismarck (18)\",\n \"events\": \"Gefahr durch ungesicherte Unfallstelle, linker Fahrstreifen blockiert\"\n },\n \"points\": [\n \n ],\n \"coords\": [\n \n ],\n \"events\": [\n \n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:58:34.000Z\",\n \"updated\": \"2019-07-01T06:35:08.733Z\",\n \"expires\": \"2019-07-01T06:47:36.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:58 AM - 8:47 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n }\n }\n }\n}"}],"_postman_id":"cbf69765-d66d-412a-bd7c-55b1e7633d72"},{"name":"Request Message Details","id":"d102d692-4c4b-4d7c-be6d-1ec23fa15718","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stau1.de/messages/search?apikey=mbnKf6hhPsSMAGvLBKUIlosDmE&msgid=XPLYv9Q8Fr&locpoints=1&history=1&eventcodes=1","description":"This endpoint returns all details of a single traffic incident specified in the msgid parameter. Individual message IDs can be obtained by performing a Search Historic Traffic Data API request first. They are represented by the unique key of each item in the returned Messages Object.
\nThe response format of the Request Message Details GET request is identical with that of the Search Historic Traffic Data API request and therfore also represented by the Messages Object.
\n","urlObject":{"protocol":"https","path":["messages","search"],"host":["api","stau1","de"],"query":[{"description":{"content":"[required] Please replace with your own API key that is assigned to your Stau1 account.
\n","type":"text/plain"},"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE"},{"description":{"content":"[required] The unique Id of the traffic incident for which details are requested.
\n","type":"text/plain"},"key":"msgid","value":"XPLYv9Q8Fr"},{"description":{"content":"[optional] If set to 1, the versions[] object of the API response includes an array of affected Road Location Points in messages[key].versions[].points[].
[optional] If set to 1, the versions[] array not only contains the earliest version of a message but includes all versions sorted by their publishing date.
[optional] If set to 1 each message version in the versions[] array of the API response contains an events array which is encoding the traffic event in a standardized format as described in the Traffic Event API documentation.
Stau1's Traffic Data Archive Search API allows retrieving historic traffic information reported for highways (Autobahnen) and other local roads types (Bundesstraßen, Landstraßen) in Germany. The data pool consists of incident-based traffic events as reported and electronically transmitted to our database by local state goverments agencies and the police.
In order for a traffic incident to become available on the Traffic Archive API its publishing date must be at least 12 hours old.
This endpoint returns an arry of Road Objects based on selected roads, road segments, regions or a combination of all of those. The following parameters can be used to modify the request:
\n","urlObject":{"protocol":"https","path":["roads","search"],"host":["api","stau1","de"],"query":[{"description":{"content":"[required] Please replace with your own API key that is assigned to your Stau1 account.
\n","type":"text/plain"},"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE"},{"description":{"content":"[optional] Limits the search to a single or a comma separated list of road name(s) or even sub-sections of roads. In this example road data is only obtained for Highway (Autobahn) A3 between and including Road Location Points 50101.23 (=Kreuz Kaiserberg) and 50101.234 (=Kreuz Oberhausen) .
\nFormat: roadName[|locPoint1|locPoint2|direction]
\nOptional (if one of the following is set the remaining two need to be set as well):
\n[optional] roadids is identical with the roads parameter with the only difference that roads are identified by their roadId instead of their name. See Road Object Documentation for details.
In this example the roadId 50101 represents Autobahn A3.
Parameters roadids and roads cannot be used in combination.
[optional] When used limits the search to one single or a comma separated list of road types:
\n[optional] Limits the search to roads located in a single or a comma separated list of regions. Each region ID represents a German state. In order to include all states in the research result simply remove this parameter entirely from your query.
Please refer to the Region Code Documentation to see which region ID is matching which state.
[optional] Limits the search to roads located within a radius of 25 kilometers around the geo location specified by the comma separated longitude,latitude values in this parameter. An additional radius parameter can be used to adjust the radius ranging from 1 to 100 kilometers.
The near parameter cannot be used in conjunction with regions.
[optional] Only valid in conjunction with near parameter. Values can range from 1 to 100, default value is 25. The radius is measured in kilometers.
\n","type":"text/plain"},"key":"radius","value":"10"},{"description":{"content":"[optional] If set to 1, the result set includes the IDs and names of the affected road segments for each road in roads[].segments[]. Road Segments (e.g. 'A3 Köin Richtung Oberhausen') are a higher-order category spanning over multiple Road Location Points (e.g. Highway exits).
[optional] If set to 1, the roads object of the API response includes an array of affected Road Location Points in roads[].points[].
[optional] Default value is 1. All search results are paginated. The amount of result sets per page is determined by the amtpp parameter which defaults to 10. The API response provides information about the amount of available pages in stats.pages.
[optional] The amount of search results which are displayed per page / request. The default and maximum value is 10.
\n","type":"text/plain"},"key":"amtpp","value":"10"}],"variable":[]}},"response":[{"id":"df4a864d-932d-4a58-94ce-fe44e815db5d","name":"Search Road Data Example","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.stau1.de/roads/search?apikey=mbnKf6hhPsSMAGvLBKUIlosDmE&roads=A3|50101.23|50101.234|-1&locsegments=1&locpoints=1&page=1&amtpp=10","protocol":"https","host":["api","stau1","de"],"path":["roads","search"],"query":[{"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE"},{"key":"roads","value":"A3|50101.23|50101.234|-1"},{"key":"roadids","value":"50101|50101.23|50101.234|-1","disabled":true},{"key":"locsegments","value":"1"},{"key":"locpoints","value":"1"},{"key":"page","value":"1"},{"key":"amtpp","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 01 Dec 2019 20:28:29 GMT"},{"key":"Server","value":"Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips"},{"key":"X-Powered-By","value":"Express"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"2258"},{"key":"ETag","value":"W/\"8d2-v/R4ybM12X9qPNWoWzB5ktdEjNQ\""},{"key":"X-FRAME-OPTIONS","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": {\n \"params\": {\n \"roads\": [\n \"A3|50101.23|50101.234|-1\"\n ],\n \"roadIds\": [\n \n ],\n \"locPoints\": 1,\n \"locSegments\": 1,\n \"page\": 1,\n \"amtpp\": 10,\n \"ldrReverse\": null,\n \"selectedNearRoadId\": null\n },\n \"stats\": {\n \"total\": 1,\n \"pages\": 1,\n \"page\": 1,\n \"amt\": 1,\n \"searchId\": \"a58Tw\"\n },\n \"roads\": [\n {\n \"roadId\": 50101,\n \"type\": \"L1.1\",\n \"road\": \"A3\",\n \"n1\": \"Arnheim\",\n \"n2\": \"Köln\",\n \"points\": [\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 10928,\n 10447,\n 11654\n ],\n \"locId\": 50101.234,\n \"srcLocId\": 10928,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Oberhausen\",\n \"roadName\": \"\",\n \"locCity\": 575,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7080,\n \"locPrev\": 10929,\n \"locNext\": 10927,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"10\",\n \"geoCoords\": [\n 6.8343,\n 51.5373\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 10927,\n 17510\n ],\n \"locId\": 50101.233,\n \"srcLocId\": 10927,\n \"type\": \"P1.3\",\n \"name\": \"Oberhausen-Holten\",\n \"roadName\": \"\",\n \"locCity\": 575,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7080,\n \"locPrev\": 10928,\n \"locNext\": 10926,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"11\",\n \"geoCoords\": [\n 6.81795,\n 51.51305\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11263,\n 10926\n ],\n \"locId\": 50101.232,\n \"srcLocId\": 10926,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Oberhausen-West\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 39798,\n \"locPrev\": 10927,\n \"locNext\": 10925,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"12\",\n \"geoCoords\": [\n 6.8148,\n 51.4874\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 50101.231,\n \"srcLocId\": 10925,\n \"type\": \"P1.3\",\n \"name\": \"Oberhausen-Lirich\",\n \"roadName\": \"\",\n \"locCity\": 575,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 39798,\n \"locPrev\": 10926,\n \"locNext\": 10924,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"13\",\n \"geoCoords\": [\n 6.8151,\n 51.47565\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 10924,\n 11222\n ],\n \"locId\": 50101.23,\n \"srcLocId\": 10924,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Kaiserberg\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 39798,\n \"locPrev\": 10925,\n \"locNext\": 10923,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"14\",\n \"geoCoords\": [\n 6.799,\n 51.44605\n ]\n }\n ],\n \"segments\": [\n {\n \"segmentId\": 7080,\n \"roadName\": \"\",\n \"n1\": \"Arnheim\",\n \"n2\": \"Oberhausen\",\n \"locPrev\": 0,\n \"locNext\": 39798,\n \"displayOrder\": 0\n },\n {\n \"segmentId\": 39798,\n \"roadName\": \"\",\n \"n1\": \"Oberhausen\",\n \"n2\": \"Köln\",\n \"locPrev\": 7080,\n \"locNext\": 7077,\n \"displayOrder\": 1\n }\n ],\n \"order\": 2,\n \"regions\": [\n 260\n ]\n }\n ]\n }\n}"}],"_postman_id":"69651e65-f503-43fe-9241-debfbcea7665"}],"id":"d4907fa4-8741-45ff-ae51-9fa53ee041bf","description":"The location of a traffic incident is - whenever possible - allocated to a specific road and road section. Since traffic data provided by the Stau1 API is based on a TMC derived data structure, information about the exact geo location of a traffic incident cannot be provided. Instead, the data that is provided to locate an incident is based on a defined list of Road Location Points like road junctions, highway exits and similar way points. An incident is then approximately being located at, or between two or more Road Location Points. For Germany Road Location Points are regularily updated and published in the \"Location Code List\" (LCL) by the Bundesanstalt für Straßenwesen.
Because most traffic messages provided by the Traffic Archive API contain Road Location Points to help locating the message geographically, the Road Data API offers a supplementary source for selectively querying Road Location Data for a given road or region.
Depending on the parameters used this endpoint returns a single or a list of Event Code Objects.
\n","urlObject":{"protocol":"https","path":["eventcodes","search"],"host":["api","stau1","de"],"query":[{"description":{"content":"[required] Please replace with your own API key that is assigned to your Stau1 account.
\n","type":"text/plain"},"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE"},{"description":{"content":"[optional] Limits the search to a single or a comma separated list of event IDs.
\n","type":"text/plain"},"key":"ids","value":"101"},{"description":{"content":"[optional] Can be used together with the ids parameter to retrieve event information of one or multiple specific traffic events. In this example information about the traffic event \"Stau\" is retrieved. This event is encoded by an id value of 101 and a cat valie of 1.
\n","type":"text/plain"},"key":"cats","value":"1"},{"description":{"content":"[optional] Limits the search to a single or comma separated list of event types. The following event types are available:
\n[optional] Default value is 1. The search result is paginated. The amount of result sets per page is determined by the amtpp parameter which defaults to 25. The API response provides information about the amount of available pages in the stats.pages property.
[optional] The amount of search results which are returned per page / request. The default and maximum value is 25.
\n","type":"text/plain"},"key":"amtpp","value":"25"}],"variable":[]}},"response":[{"id":"b5a73074-5a87-4f7b-94f8-73d196523cdc","name":"Search Event Codes Example","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.stau1.de/eventcodes/search?apikey=mbnKf6hhPsSMAGvLBKUIlosDmE&types=5","protocol":"https","host":["api","stau1","de"],"path":["eventcodes","search"],"query":[{"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE","description":"[required] Please replace with your own API key that is assigned to your Stau1 account."},{"key":"types","value":"5","description":"[optional] Limits the search to a single or comma separated list of event types. The following event types are available:\n* *1* = Dangerous Situation (Gefahr)\n* *2* = Traffic Accident (Unfall)\n* *3* = Road Closure (Sperrung)\n* *4* = Icy / splippery / unsafe road conditions (Glätte)\n* *5* = Traffic Congestion (Stau)\n* *6* = Increased Traffic (Staugefahr)\n* *7* = Partial Road Closue (Teilsperrung)\n* *8* = Road Work (Baustelle)\n* *9* = Informational Note (Information)\n* *10* = Cancellation Notice (Störungsaufhebung)\n"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 02 Jan 2020 22:27:09 GMT"},{"key":"Server","value":"Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips"},{"key":"X-Powered-By","value":"Express"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"239"},{"key":"ETag","value":"W/\"ef-4DvxuEq3HUY+N2HPnj5n/gikDSk\""},{"key":"X-FRAME-OPTIONS","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": {\n \"params\": {\n \"types\": [\n 5\n ],\n \"page\": 1,\n \"amtpp\": 25\n },\n \"stats\": {\n \"amt\": 11,\n \"page\": 1,\n \"pages\": 1,\n \"total\": 11\n },\n \"eventCodeList\": [\n {\n \"id\": 101,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"Stau\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 102,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"Stau\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 103,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"Stau\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 104,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"Stau\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 105,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"Stau\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 106,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"Stau\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 120,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"dichter Verkehr\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 129,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"Stau\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 133,\n \"subcode\": [\n {\n \"cat\": 1,\n \"text\": {\n \"de\": [\n \"lange Staus\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 245,\n \"subcode\": [\n {\n \"cat\": 50,\n \"text\": {\n \"de\": [\n \"Staulänge zunehmend\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n },\n {\n \"id\": 1625,\n \"subcode\": [\n {\n \"cat\": 20,\n \"text\": {\n \"de\": [\n \"Zeitverlust von bis zu 40 Minuten\"\n ]\n },\n \"type\": 5,\n \"exp\": false\n }\n ]\n }\n ]\n }\n}"}],"_postman_id":"7e780e97-89c5-4474-b02f-ad7bef54619d"}],"id":"f8308e55-31dd-4db1-8ba1-c326d0dd636e","description":"Traffic event information for a given traffic incident is returned by the Traffic Archive API in the messages[key].versions[].events[] array of the Messages Object. There, a single traffic event is encoded by an events[].id in combination with a events[].cat value. A given traffic event can only be uniquely identified by those two pieces of information.
The Event Code API helps matching traffic incident information provided by the Traffic Event Code API with corresponding text strings.
Inside of the Stau1 database individual States in Germany (=Bundesländer) are represented by a set of Region IDs which allows filtering traffic and road data by State. Region Data is not provided via an API endpoint. Instead please reference the following list for encoding and decoding different regions:
\n","event":[{"listen":"prerequest","script":{"id":"19f4a687-1725-4d26-82eb-b6b5c9fe7f28","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"13fdd62c-f954-4af4-8955-2ca6dc559824","type":"text/javascript","exec":[""]}}],"_postman_id":"4dc3f6dc-9443-4153-86ab-76ee13a953ed"},{"name":"API Response Objects","item":[{"name":"Messages Object","item":[{"name":"Messages Object Sample","id":"ec2d2d70-87d4-4764-b7da-1cc530895ec2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.stau1.de/messages/search?start=201907010700&end=201907010800&roads=A3&locpoints=1&history=1&eventcodes=1&amtpp=2&apikey=mbnKf6hhPsSMAGvLBKUIlosDmE","urlObject":{"protocol":"https","path":["messages","search"],"host":["api","stau1","de"],"query":[{"description":{"content":"Search for all incidents that were present between July 1, 2019 7AM and...
\n","type":"text/plain"},"key":"start","value":"201907010700"},{"description":{"content":"... July 1, 2019 8AM
\n","type":"text/plain"},"key":"end","value":"201907010800"},{"description":{"content":"Limit search to Autobahn A3.
\n","type":"text/plain"},"key":"roads","value":"A3"},{"disabled":true,"description":{"content":"[optional] roadids is identical with the roads parameter with the only difference that roads are identified by their roadId instead of their name. See Road Data API Documentation for details.
In this example the roadId 50101 represents Autobahn A3 whereas 7105 is Autobahn A42.
Parameters roadids and roads cannot be used in combination.
[optional] When used limits the search to one single or comma separated list of road types:
\n[optional] Limits the search to traffic incidents located in a single or a comma separated list of regions. Each region ID represents a German state. In order to include all states in the research result simply remove this parameter from your query.
Please refer to the Region Code Documentation to see which region ID is matching which state.
[optional] Limits the search to incidents located within a radius of 25 kilometers around the geo location defined by longitude,latitude values in this parameter. An additional radius parameter can be used to adjust the radius ranging from 1 to 100 kilometers.
The near parameter cannot be used in conjunction with regions.
[optional] Only valid in conjunction with near parameter. Values can range from 1 to 100, default value is 25. The radius is measured in kilometers.
\n","type":"text/plain"},"key":"radius","value":"10"},{"description":{"content":"Search result should contain Road Location Points for each message.
\n","type":"text/plain"},"key":"locpoints","value":"1"},{"description":{"content":"Request all available versions for each message.
\n","type":"text/plain"},"key":"history","value":"1"},{"description":{"content":"Request a detailed event list for each message version.
\n","type":"text/plain"},"key":"eventcodes","value":"1"},{"disabled":true,"key":"page","value":"1"},{"description":{"content":"Amount per page, Limits search to two messages.
\n","type":"text/plain"},"key":"amtpp","value":"2"},{"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE"}],"variable":[]}},"response":[{"id":"df184e74-2883-4bd8-b137-1468f6326f7d","name":"Messages Object Sample Request","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.stau1.de/messages/search?start=201907010700&end=201907010800&locpoints=1&history=1&eventcodes=1&page=1&amtpp=2&apikey=mbnKf6hhPsSMAGvLBKUIlosDmE&roads=A42","protocol":"https","host":["api","stau1","de"],"path":["messages","search"],"query":[{"key":"start","value":"201907010700","description":"[required] In combination with the **end** param, sets the time period of the search request. The selected time period must not exceed 24 hours. Date \nTime Format is *YYYYMMDDhhmm*.\n\n"},{"key":"end","value":"201907010800","description":"[required] In combination with the **start** param, sets the time period of the search request. The selected time period must not exceed 24 hours. Date \nTime Format is *YYYYMMDDhhmm*.\nThe selected time period in this example ranges from *July 1, 2019 7:00AM to 8:00AM*."},{"key":"roadids","value":"50101|50101.23|50101.234|-1,7105","description":"[optional] **roadids** is identical with the **roads** parameter with the only difference that roads are identified by their `roadId` instead of their name. See [Road Data API Documentation](#d4907fa4-8741-45ff-ae51-9fa53ee041bf) for details. \nIn this example the `roadId` *50101* represents Autobahn A3 whereas *7105* is Autobahn A42. \nParameters **roadids** and **roads** cannot be used in combination.","disabled":true},{"key":"roadtypes","value":"1,2","description":"[optional] When used limits the search to one single or comma separated list of road types: \n* *1* = Highways/Motorways (=Bundesautobahnen, e.g. *A3*)\n* *2* = State Roads (=Bundesstraßen, e.g. *B8*)\n* *3* = Country Roads (=Landstraßen, e.g. *L145*)\n* *4* = Other local roads\n","disabled":true},{"key":"regions","value":"260,261","description":"[optional] Limits the search to traffic incidents located in a single or a comma separated list of regions. Each region ID represents a German state. In order to include all states in the research result simply remove this parameter from your query. \nPlease refer to the [Region Code Documentation](#4dc3f6dc-9443-4153-86ab-76ee13a953ed) to see which region ID is matching which state.","disabled":true},{"key":"near","value":"6.9591,50.9410","description":"[optional] Limits the search to incidents located within a radius of 25 kilometers around the geo location defined by *longitude*,*latitude* values in this parameter. An additional **radius** parameter can be used to adjust the radius ranging from 1 to 100 kilometers. \nThe **near** parameter cannot be used in conjunction with **regions**.\n","disabled":true},{"key":"radius","value":"10","description":"[optional] Only valid in conjunction with **near** parameter. Values can range from 1 to 100, default value is 25. The radius is measured in kilometers.\n","disabled":true},{"key":"locpoints","value":"1"},{"key":"history","value":"1"},{"key":"eventcodes","value":"1"},{"key":"page","value":"1"},{"key":"amtpp","value":"2"},{"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE"},{"key":"roads","value":"A42"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 29 Nov 2019 23:58:04 GMT"},{"key":"Server","value":"Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips"},{"key":"X-Powered-By","value":"Express"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"45518"},{"key":"ETag","value":"W/\"b1ce-otGMlZC7yJj5L2zrpu+E/XB3M7U\""},{"key":"X-FRAME-OPTIONS","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"result\": {\n \"params\": {\n \"start\": \"201907010700\",\n \"end\": \"201907010800\",\n \"roads\": [\n \"A42\"\n ],\n \"roadIds\": [\n \n ],\n \"regions\": [\n \n ],\n \"flexGeo\": 0,\n \"age\": 24,\n \"history\": 1,\n \"locPoints\": 1,\n \"eventCodes\": 1,\n \"page\": 1,\n \"amtpp\": 2\n },\n \"stats\": {\n \"total\": 9,\n \"pages\": 5,\n \"version\": 1578015304878,\n \"page\": 1,\n \"sections\": [\n \n ],\n \"regions\": [\n 260\n ],\n \"amt\": 2,\n \"rect\": [\n [\n 52.44035,\n 7.250629713615012\n ],\n [\n 50.33895,\n 9.4346\n ]\n ],\n \"cacheId\": \"2cb73d1c83d220e7cf77633fe4850e6ba03ae839\"\n },\n \"messages\": {\n \"RudSOH73bE\": {\n \"srcId\": \"DNWLMSNW98412-20190701T045108Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:00:11.559Z\",\n \"srcId\": \"DNWLMS-NW-98412-2019-07-01T04:51:08Z\",\n \"hashId\": \"ebFIJb1OJM\",\n \"published\": \"2019-07-01T04:51:08.000Z\",\n \"pubStr\": \"Jul 1, 2019, 6:51 AM - 7:12 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Gelsenkirchen-Schalke (17) und Gelsenkirchen-Zentrum (16)\",\n \"events\": \"2 km Stau\"\n },\n \"points\": [\n {\n \"locId\": 7105.017,\n \"srcLocId\": 40000,\n \"type\": \"P1.3\",\n \"road\": \"A42\",\n \"name\": \"Gelsenkirchen-Schalke\",\n \"roadName\": \"\",\n \"locSection\": 7105,\n \"locPrev\": 11273,\n \"locNext\": 11271,\n \"locLeap\": 0,\n \"locIntersection\": [\n 47758,\n 47754,\n 40000\n ],\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"17\",\n \"geoCoords\": [\n 7.09525,\n 51.5343\n ]\n },\n {\n \"locId\": 7105.016,\n \"srcLocId\": 11271,\n \"type\": \"P1.3\",\n \"road\": \"A42\",\n \"name\": \"Gelsenkirchen-Zentrum\",\n \"roadName\": \"\",\n \"locSection\": 7105,\n \"locPrev\": 40000,\n \"locNext\": 11270,\n \"locLeap\": 0,\n \"locIntersection\": [\n 11271,\n 39463\n ],\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"16\",\n \"geoCoords\": [\n 7.07185,\n 51.52275\n ]\n }\n ],\n \"coords\": [\n \n ],\n \"events\": [\n {\n \"id\": 103,\n \"cat\": 1,\n \"quantType\": \"LEN\",\n \"quantValue\": 2,\n \"src\": \"xml\"\n }\n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T04:51:08.000Z\",\n \"updated\": \"2019-07-01T05:00:11.559Z\",\n \"expires\": \"2019-07-01T05:12:13.892Z\",\n \"pubStr\": \"Jul 1, 2019, 6:51 AM - 7:12 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n },\n \"yBpmV8qWIf\": {\n \"srcId\": \"DNWLMSNW98430-20190701T050402Z\",\n \"source\": \"viz\",\n \"region\": [\n 260\n ],\n \"versions\": [\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:10:12.341Z\",\n \"srcId\": \"DNWLMS-NW-98430-2019-07-01T05:04:02Z\",\n \"hashId\": \"UxzHOOedGt\",\n \"published\": \"2019-07-01T05:04:02.000Z\",\n \"pubStr\": \"Jul 1, 2019, 7:04 AM - 7:37 AM Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Gelsenkirchen-Schalke (17) und Gelsenkirchen-Zentrum (16)\",\n \"events\": \"Stau\"\n },\n \"points\": [\n {\n \"locId\": 7105.017,\n \"srcLocId\": 40000,\n \"type\": \"P1.3\",\n \"road\": \"A42\",\n \"name\": \"Gelsenkirchen-Schalke\",\n \"roadName\": \"\",\n \"locSection\": 7105,\n \"locPrev\": 11273,\n \"locNext\": 11271,\n \"locLeap\": 0,\n \"locIntersection\": [\n 47758,\n 47754,\n 40000\n ],\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"17\",\n \"geoCoords\": [\n 7.09525,\n 51.5343\n ]\n },\n {\n \"locId\": 7105.016,\n \"srcLocId\": 11271,\n \"type\": \"P1.3\",\n \"road\": \"A42\",\n \"name\": \"Gelsenkirchen-Zentrum\",\n \"roadName\": \"\",\n \"locSection\": 7105,\n \"locPrev\": 40000,\n \"locNext\": 11270,\n \"locLeap\": 0,\n \"locIntersection\": [\n 11271,\n 39463\n ],\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"16\",\n \"geoCoords\": [\n 7.07185,\n 51.52275\n ]\n }\n ],\n \"coords\": [\n \n ],\n \"events\": [\n {\n \"id\": 101,\n \"cat\": 1,\n \"quantType\": \"\",\n \"quantValue\": -1,\n \"src\": \"xml\"\n }\n ]\n },\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:15:10.989Z\",\n \"srcId\": \"DNWLMS-NW-98430-2019-07-01T05:09:34Z\",\n \"hashId\": \"X8YO8mzH1C\",\n \"published\": \"2019-07-01T05:09:34.000Z\",\n \"pubStr\": \"Jul 1, 2019, 07:09 Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Gelsenkirchen-Schalke (17) und Gelsenkirchen-Zentrum (16)\",\n \"events\": \"4 km Stau\"\n },\n \"points\": [\n {\n \"locId\": 7105.017,\n \"srcLocId\": 40000,\n \"type\": \"P1.3\",\n \"road\": \"A42\",\n \"name\": \"Gelsenkirchen-Schalke\",\n \"roadName\": \"\",\n \"locSection\": 7105,\n \"locPrev\": 11273,\n \"locNext\": 11271,\n \"locLeap\": 0,\n \"locIntersection\": [\n 47758,\n 47754,\n 40000\n ],\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"17\",\n \"geoCoords\": [\n 7.09525,\n 51.5343\n ]\n },\n {\n \"locId\": 7105.016,\n \"srcLocId\": 11271,\n \"type\": \"P1.3\",\n \"road\": \"A42\",\n \"name\": \"Gelsenkirchen-Zentrum\",\n \"roadName\": \"\",\n \"locSection\": 7105,\n \"locPrev\": 40000,\n \"locNext\": 11270,\n \"locLeap\": 0,\n \"locIntersection\": [\n 11271,\n 39463\n ],\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"16\",\n \"geoCoords\": [\n 7.07185,\n 51.52275\n ]\n }\n ],\n \"coords\": [\n \n ],\n \"events\": [\n {\n \"id\": 104,\n \"cat\": 1,\n \"quantType\": \"LEN\",\n \"quantValue\": 4,\n \"src\": \"xml\"\n }\n ]\n },\n {\n \"direction\": -1,\n \"inserted\": \"2019-07-01T05:20:11.643Z\",\n \"srcId\": \"DNWLMS-NW-98430-2019-07-01T05:14:27Z\",\n \"hashId\": \"70ltJsjV98\",\n \"published\": \"2019-07-01T05:14:27.000Z\",\n \"pubStr\": \"Jul 1, 2019, 07:14 Uhr\",\n \"text\": {\n \"road\": \"A42\",\n \"segment\": \"Dortmund - Kamp-Lintfort\",\n \"section\": \"zwischen Gelsenkirchen-Schalke (17) und Gelsenkirchen-Zentrum (16)\",\n \"events\": \"2 km Stau\"\n },\n \"points\": [\n {\n \"locId\": 7105.017,\n \"srcLocId\": 40000,\n \"type\": \"P1.3\",\n \"road\": \"A42\",\n \"name\": \"Gelsenkirchen-Schalke\",\n \"roadName\": \"\",\n \"locSection\": 7105,\n \"locPrev\": 11273,\n \"locNext\": 11271,\n \"locLeap\": 0,\n \"locIntersection\": [\n 47758,\n 47754,\n 40000\n ],\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"17\",\n \"geoCoords\": [\n 7.09525,\n 51.5343\n ]\n },\n {\n \"locId\": 7105.016,\n \"srcLocId\": 11271,\n \"type\": \"P1.3\",\n \"road\": \"A42\",\n \"name\": \"Gelsenkirchen-Zentrum\",\n \"roadName\": \"\",\n \"locSection\": 7105,\n \"locPrev\": 40000,\n \"locNext\": 11270,\n \"locLeap\": 0,\n \"locIntersection\": [\n 11271,\n 39463\n ],\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"16\",\n \"geoCoords\": [\n 7.07185,\n 51.52275\n ]\n }\n ],\n \"coords\": [\n \n ],\n \"events\": [\n {\n \"id\": 103,\n \"cat\": 1,\n \"quantType\": \"LEN\",\n \"quantValue\": 2,\n \"src\": \"xml\"\n }\n ]\n }\n ],\n \"status\": \"expired\",\n \"published\": \"2019-07-01T05:04:02.000Z\",\n \"updated\": \"2019-07-01T05:20:11.643Z\",\n \"expires\": \"2019-07-01T05:37:17.015Z\",\n \"pubStr\": \"Jul 1, 2019, 7:04 AM - 7:37 AM Uhr\",\n \"road\": {\n \"roadId\": 7105,\n \"road\": \"A42\",\n \"roadName\": \"\",\n \"type\": \"L1.1\"\n }\n }\n }\n }\n}"}],"_postman_id":"ec2d2d70-87d4-4764-b7da-1cc530895ec2"}],"id":"3ece002a-2809-420a-ba2f-69ab0af1a861","description":"The Messages Object is the main object returned by the Traffic Archiv API and contains a list of individual traffic incidents. Each of the object's items (=traffic incidents) can be accessed by a unique key which at the same time represent the unique ID of the traffic incident.
The sample request below returns a Messages Object that contains two traffic incidents:
messages[key] object{\n \"messages\": {\n \"xy6pdFtwRo\": { /* = unique key of first message */\n \"srcId\": \"DRPLMSRP128280-20190527T173324Z\",\n \"source\": \"viz\",\n \"road\": {\n /* Road Object */\n },\n \"region\": [262],\n \"versions\": [\n /* Array of one or more message version objects */\n ],\n \"status\": \"expired\",\n \"published\": \"2019-05-27T17:33:24.000Z\",\n \"updated\": \"2019-05-31T20:30:10.771Z\",\n \"expires\": \"2019-08-30T22:12:13.783Z\",\n \"pubStr\": \"May 27, 7:33 Uhr - Aug 31, 12:12 Uhr\"\n },\n \"9wFHgjSwOJ\": {\n /* Object of second message */\n }\n }\n}\n\n
\n
messages[key].versions array {\n \"hashId\": \"pj2kxh43eS\",\n \"published\": \"2019-05-27T17:33:24.000Z\",\n \"direction\": -1,\n \"text\": {\n \"road\": \"A3\",\n \"segment\": \"Köln - Frankfurt\",\n \"section\": \"zwischen Montabaur (40) und Diez (41)\",\n \"events\": \"Baustelle, bis 30.08.2019 23:59 Uhr\"\n },\n \"points\": [\n /* An array of Road Location Points */\n ],\n \"coords\": [\n /* An array of geo coordinates */\n ],\n \"events\": [\n /* An array of Message Events */\n ]\n },\nThis example returns road and road location data for Highway/Autobahn A42, exclusively for the lane leading from Dortmund to Kamp-Lintfort. For additional parameters please refer to the Road Data API documentation.
\n","urlObject":{"protocol":"https","path":["roads","search"],"host":["api","stau1","de"],"query":[{"description":{"content":"Please replace with your own API key that is assigned to your Stau1 account.
\n","type":"text/plain"},"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE"},{"description":{"content":"Limit the result to road data for Highway / Autobahn A42 for its negative driving direction which in case of A42 is Dortmund towards Kamp-Linfort.
\n","type":"text/plain"},"key":"roads","value":"A42|-1"},{"description":{"content":"Include Road Location Point data in the search result
\n","type":"text/plain"},"key":"locpoints","value":"1"},{"description":{"content":"Include a list all segments of this roads. In case of A42 only one segment exists
\n","type":"text/plain"},"key":"locsegments","value":"1"}],"variable":[]}},"response":[{"id":"6df0a38e-0847-4576-a36c-9b700a26245e","name":"Road Object Sample Request","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.stau1.de/roads/search?apikey=mbnKf6hhPsSMAGvLBKUIlosDmE&roads=A42|-1&locpoints=1&locsegments=1","protocol":"https","host":["api","stau1","de"],"path":["roads","search"],"query":[{"key":"apikey","value":"mbnKf6hhPsSMAGvLBKUIlosDmE","description":"[required] Please replace with your own API key that is assigned to your Stau1 account."},{"key":"roads","value":"A42|-1","description":"[optional] Limit the result to road data for Highway / Autobahn A42 for its negative driving direction which in case of A42 is Dortmund towards Kamp-Linfort."},{"key":"locpoints","value":"1","description":"[optional] Include Road Location Point data in the search result"},{"key":"locsegments","value":"1","description":"[optional] Include a list all segments of this roads. In case of A42 only one segment exists"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 02 Dec 2019 23:09:42 GMT"},{"key":"Server","value":"Apache/2.4.6 (CentOS) OpenSSL/1.0.2k-fips"},{"key":"X-Powered-By","value":"Express"},{"key":"Vary","value":"Origin"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"10199"},{"key":"ETag","value":"W/\"27d7-GlCfab3YkgiMOzavKRC1jlYCsTA\""},{"key":"X-FRAME-OPTIONS","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"\n{\n \"status\": \"success\",\n \"result\": {\n \"params\": {\n \"roads\": [\n \"A42|-1\"\n ],\n \"roadIds\": [\n \n ],\n \"locPoints\": 1,\n \"locSegments\": 1,\n \"page\": 1,\n \"amtpp\": 10\n },\n \"stats\": {\n \"total\": 1,\n \"pages\": 1,\n \"amt\": 1,\n \"searchId\": \"HXAOn\"\n },\n \"roads\": [\n {\n \"roadId\": 7105,\n \"type\": \"L1.1\",\n \"road\": \"A42\",\n \"n1\": \"Dortmund\",\n \"n2\": \"Kamp-Lintfort\",\n \"points\": [\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11283,\n 14728\n ],\n \"locId\": 7105.03,\n \"srcLocId\": 11283,\n \"type\": \"P1.3\",\n \"name\": \"Dortmund-Bodelschwingh\",\n \"roadName\": \"\",\n \"locCity\": 389,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 0,\n \"locNext\": 11282,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"27\",\n \"geoCoords\": [\n 7.3615,\n 51.56075\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11282,\n 11434\n ],\n \"locId\": 7105.029,\n \"srcLocId\": 11282,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Castrop-Rauxel-Ost\",\n \"roadName\": \"\",\n \"locCity\": 389,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11283,\n \"locNext\": 11281,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"27\",\n \"geoCoords\": [\n 7.35815,\n 51.56145\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11281,\n 21959\n ],\n \"locId\": 7105.028,\n \"srcLocId\": 11281,\n \"type\": \"P1.3\",\n \"name\": \"Castrop-Rauxel\",\n \"roadName\": \"\",\n \"locCity\": 614,\n \"locCityDistrict\": 1036,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11282,\n \"locNext\": 11280,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"26\",\n \"geoCoords\": [\n 7.31485,\n 51.5613\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.027,\n \"srcLocId\": 11280,\n \"type\": \"P1.3\",\n \"name\": \"Castrop-Rauxel-Bladenhorst\",\n \"roadName\": \"\",\n \"locCity\": 614,\n \"locCityDistrict\": 1036,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11281,\n \"locNext\": 39488,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"25\",\n \"geoCoords\": [\n 7.29235,\n 51.5587\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.026,\n \"srcLocId\": 39488,\n \"type\": \"P3.4\",\n \"name\": \"Rastplatz Lusebrink\",\n \"roadName\": \"\",\n \"locCity\": 614,\n \"locCityDistrict\": 1036,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11280,\n \"locNext\": 39487,\n \"locLeap\": 0,\n \"existsPos\": 0,\n \"existsNeg\": 1,\n \"exitNumber\": \"0\",\n \"geoCoords\": [\n 7.2755,\n 51.55865\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.024,\n \"srcLocId\": 11279,\n \"type\": \"P1.3\",\n \"name\": \"Herne-Börnig\",\n \"roadName\": \"\",\n \"locCity\": 463,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 39487,\n \"locNext\": 11278,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"24\",\n \"geoCoords\": [\n 7.26295,\n 51.5572\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.023,\n \"srcLocId\": 11278,\n \"type\": \"P1.3\",\n \"name\": \"Herne-Horsthausen\",\n \"roadName\": \"\",\n \"locCity\": 463,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11279,\n \"locNext\": 11277,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"23\",\n \"geoCoords\": [\n 7.2308,\n 51.5559\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11277,\n 39776\n ],\n \"locId\": 7105.022,\n \"srcLocId\": 11277,\n \"type\": \"P1.3\",\n \"name\": \"Herne-Baukau\",\n \"roadName\": \"\",\n \"locCity\": 463,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11278,\n \"locNext\": 11276,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"22\",\n \"geoCoords\": [\n 7.21225,\n 51.5484\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11295,\n 11276\n ],\n \"locId\": 7105.021,\n \"srcLocId\": 11276,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Herne\",\n \"roadName\": \"\",\n \"locCity\": 463,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11277,\n \"locNext\": 11275,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"21\",\n \"geoCoords\": [\n 7.1999,\n 51.5445\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11275,\n 21882\n ],\n \"locId\": 7105.02,\n \"srcLocId\": 11275,\n \"type\": \"P1.3\",\n \"name\": \"Herne-Crange\",\n \"roadName\": \"\",\n \"locCity\": 463,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11276,\n \"locNext\": 11274,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"20\",\n \"geoCoords\": [\n 7.16825,\n 51.54235\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.019,\n \"srcLocId\": 11274,\n \"type\": \"P1.3\",\n \"name\": \"Herne-Wanne\",\n \"roadName\": \"\",\n \"locCity\": 463,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11275,\n \"locNext\": 11273,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"19\",\n \"geoCoords\": [\n 7.1498,\n 51.5415\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.018,\n \"srcLocId\": 11273,\n \"type\": \"P1.3\",\n \"name\": \"Gelsenkirchen-Bismarck\",\n \"roadName\": \"\",\n \"locCity\": 426,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11274,\n \"locNext\": 40000,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"18\",\n \"geoCoords\": [\n 7.12685,\n 51.5377\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 47758,\n 47754,\n 40000\n ],\n \"locId\": 7105.017,\n \"srcLocId\": 40000,\n \"type\": \"P1.3\",\n \"name\": \"Gelsenkirchen-Schalke\",\n \"roadName\": \"\",\n \"locCity\": 426,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11273,\n \"locNext\": 11271,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"17\",\n \"geoCoords\": [\n 7.09525,\n 51.5343\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11271,\n 39463\n ],\n \"locId\": 7105.016,\n \"srcLocId\": 11271,\n \"type\": \"P1.3\",\n \"name\": \"Gelsenkirchen-Zentrum\",\n \"roadName\": \"\",\n \"locCity\": 426,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 40000,\n \"locNext\": 11270,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"16\",\n \"geoCoords\": [\n 7.07185,\n 51.52275\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 40224,\n 11270\n ],\n \"locId\": 7105.015,\n \"srcLocId\": 11270,\n \"type\": \"P1.3\",\n \"name\": \"Gelsenkirchen-Heßler\",\n \"roadName\": \"\",\n \"locCity\": 426,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11271,\n \"locNext\": 11269,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"15\",\n \"geoCoords\": [\n 7.04375,\n 51.5146\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.014,\n \"srcLocId\": 11269,\n \"type\": \"P1.3\",\n \"name\": \"Essen-Altenessen\",\n \"roadName\": \"\",\n \"locCity\": 408,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11270,\n \"locNext\": 11268,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"14\",\n \"geoCoords\": [\n 7.01365,\n 51.5081\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11268,\n 21854\n ],\n \"locId\": 7105.013,\n \"srcLocId\": 11268,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Essen-Nord\",\n \"roadName\": \"\",\n \"locCity\": 408,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11269,\n \"locNext\": 11267,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"13\",\n \"geoCoords\": [\n 6.9966,\n 51.50555\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 39779,\n 11267\n ],\n \"locId\": 7105.012,\n \"srcLocId\": 11267,\n \"type\": \"P1.3\",\n \"name\": \"Bottrop-Süd\",\n \"roadName\": \"\",\n \"locCity\": 354,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11268,\n \"locNext\": 11266,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"12\",\n \"geoCoords\": [\n 6.93535,\n 51.5045\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.011,\n \"srcLocId\": 11266,\n \"type\": \"P1.3\",\n \"name\": \"Oberhausen Neue Mitte\",\n \"roadName\": \"\",\n \"locCity\": 575,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11267,\n \"locNext\": 11265,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"11\",\n \"geoCoords\": [\n 6.8896,\n 51.49675\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11265,\n 21840\n ],\n \"locId\": 7105.01,\n \"srcLocId\": 11265,\n \"type\": \"P1.3\",\n \"name\": \"Oberhausen-Zentrum\",\n \"roadName\": \"\",\n \"locCity\": 575,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11266,\n \"locNext\": 11264,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"10\",\n \"geoCoords\": [\n 6.8638,\n 51.49635\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.009,\n \"srcLocId\": 11264,\n \"type\": \"P1.3\",\n \"name\": \"Oberhausen-Buschhausen\",\n \"roadName\": \"\",\n \"locCity\": 575,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11265,\n \"locNext\": 11263,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"9\",\n \"geoCoords\": [\n 6.8385,\n 51.49065\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11263,\n 10926\n ],\n \"locId\": 7105.008,\n \"srcLocId\": 11263,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Oberhausen-West\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11264,\n \"locNext\": 11262,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"8\",\n \"geoCoords\": [\n 6.8148,\n 51.4874\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 25261,\n 11262\n ],\n \"locId\": 7105.007,\n \"srcLocId\": 11262,\n \"type\": \"P1.3\",\n \"name\": \"Duisburg-Neumühl\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11263,\n \"locNext\": 11261,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"7\",\n \"geoCoords\": [\n 6.7941,\n 51.48475\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11840,\n 11261\n ],\n \"locId\": 7105.006,\n \"srcLocId\": 11261,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Duisburg-Nord\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11262,\n \"locNext\": 11260,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"6\",\n \"geoCoords\": [\n 6.77065,\n 51.48335\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 17508,\n 11260\n ],\n \"locId\": 7105.005,\n \"srcLocId\": 11260,\n \"type\": \"P1.3\",\n \"name\": \"Duisburg-Beeck\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11261,\n \"locNext\": 11259,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"5\",\n \"geoCoords\": [\n 6.7323,\n 51.481\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.004,\n \"srcLocId\": 11259,\n \"type\": \"P1.3\",\n \"name\": \"Duisburg-Beeckerwerth\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11260,\n \"locNext\": 40196,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"4\",\n \"geoCoords\": [\n 6.7039,\n 51.4787\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n \n ],\n \"locId\": 7105.003,\n \"srcLocId\": 40196,\n \"type\": \"P3.2\",\n \"name\": \" Rheinbrücke Beeckerwerth\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11259,\n \"locNext\": 11258,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"0\",\n \"geoCoords\": [\n 6.6806,\n 51.4809\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 11258,\n 17506\n ],\n \"locId\": 7105.002,\n \"srcLocId\": 11258,\n \"type\": \"P1.3\",\n \"name\": \"Duisburg-Baerl\",\n \"roadName\": \"\",\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 40196,\n \"locNext\": 11257,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"3\",\n \"geoCoords\": [\n 6.6708,\n 51.4816\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 14740,\n 11257\n ],\n \"locId\": 7105.001,\n \"srcLocId\": 11257,\n \"type\": \"P1.3\",\n \"name\": \"Moers-Nord\",\n \"roadName\": \"\",\n \"locCity\": 709,\n \"locCityDistrict\": 4396,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11258,\n \"locNext\": 11256,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"2\",\n \"geoCoords\": [\n 6.6328,\n 51.4938\n ]\n },\n {\n \"locState\": [\n 260\n ],\n \"locIntersection\": [\n 55794,\n 11793,\n 11256\n ],\n \"locId\": 7105,\n \"srcLocId\": 11256,\n \"type\": \"P1.1\",\n \"name\": \"Kreuz Kamp-Lintfort\",\n \"roadName\": \"\",\n \"locCity\": 709,\n \"locCityDistrict\": 4396,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11257,\n \"locNext\": 0,\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"1\",\n \"geoCoords\": [\n 6.57655,\n 51.48885\n ]\n }\n ],\n \"segments\": [\n {\n \"segmentId\": 7105,\n \"roadName\": \"\",\n \"n1\": \"Dortmund\",\n \"n2\": \"Kamp-Lintfort\",\n \"locPrev\": 0,\n \"locNext\": 0,\n \"displayOrder\": 0\n }\n ],\n \"order\": 34,\n \"regions\": [\n 260\n ]\n }\n ]\n }\n}"}],"_postman_id":"d9dcd710-d325-4629-b68b-fa89231a868a"}],"id":"e0ce43dd-236c-46de-b87d-d7fe91a32092","description":"The Road object is the main object returned by the Road Data API where - depending on the search paramters - one or multiple Road objects can be found in the result.roads[] array.
Individual traffic incidients returned by the Traffic Archive API also include road data. There, since by convention a traffic incident is assigned to one particular road, a single Road object can be found at result.messages[key].road.
Important child elements are points and segments which contain the road's Location Points and road segments respectively. When requested via a Traffic Archive API call, both of these elements are not part of the result.messages[key].road object but can instead be found in the result.messages[key].versions[] object. This is the case, because affected Road Location Points may vary for each version of a message.
\n
roads[] and road object{\n \"roadId\": 7105,\n \"type\": \"L1.1\",\n \"road\": \"A42\",\n \"n1\": \"Dortmund\",\n \"n2\": \"Kamp-Lintfort\",\n \"points\": [\n /* Array of Road Location Points */\n ],\n \"segments\": [\n /* Array of Road Segments */\n ],\n \"order\": 34,\n \"regions\": [\n 260\n ]\n}\n\n
Road Types provide in type
Traffic Incident event codes are returned by the Traffic Archive API in the messages[key].versions[].events[] array of the Messages Object and by the Event Code API. In both cases a specific event is defined by a unique combination of an id and a cat value.
\n
Traffic Incident event codes are returned by the Traffic Archive API in the messages[key].versions[].events[] array. The object has the folowing format:
{\n \"events\": [\n {\n \"id\": 101,\n \"cat\": 1,\n \"quantType\": \"\",\n \"quantValue\": -1\n }\n ]\n}\n\n
Traffic Incident event codes returned by the Event Code API have a different format. The following sample result demonstrates that a specific event can only be identified uniquely by combining id and cat values since two events are e.g. sharing an id of 203:
{\n \"eventCodeList\": [\n {\n \"id\": 203,\n \"subcode\": [\n {\n \"cat\": 3,\n \"text\": {\n \"de\": [\n \"Unfall mit mehreren Fahrzeugen\"\n ]\n },\n \"type\": 2,\n \"exp\": false\n },\n {\n \"cat\": 50,\n \"text\": {\n \"de\": [\n \"vorausgegangenes Ereignis\"\n ]\n },\n \"type\": 2,\n \"exp\": false\n }\n ]\n }\n ]\n}\n\n
Event types as provided in eventCodeList[].subcode[].type
Event Quantifiers as provided in in the messages[key].versions[].events[].quantType
The encoding of location data provided by the Stau1 API is based on the official \"Location Code List\" (LCL) which is also used by TMC Services. The complete list is regularily updated and published by the Bundesanstalt für Straßenwesen.
\n\n
points[] objectThe course of a road is described by a list of location points (e.g. intersections or highway exists). Road Location Points are contained in the messages[key].versions[].points[] object of the Traffic Archive API and within the roads[].points[] array of Road Data API. In both cases a location point object has the following format:
{\n \"srcLocId\": 11260,\n \"locId\": 7105.005,\n \"type\": \"P1.3\",\n \"name\": \"Duisburg-Beeck\",\n \"roadName\": \"\", \n \"locState\": [\n 260\n ],\n \"locCity\": 391,\n \"locCityDistrict\": 0,\n \"locCountry\": 1,\n \"locSection\": 7105,\n \"locPrev\": 11261,\n \"locNext\": 11259,\n \"locIntersection\": [\n 17508,\n 11260\n ],\n \"locLeap\": 0,\n \"existsPos\": 1,\n \"existsNeg\": 1,\n \"exitNumber\": \"5\",\n \"geoCoords\": [\n 6.7323,\n 51.481\n ]\n}\n\n
Location types as provided in type
Response to every request is sent in JSON format and API calls will respond with appropriate HTTP status codes for all requests.
Responses to successful API requests have the following format:
{\n \"status\": \"success\",\n \"result\": {\n /* a list of result objects and their children */\n }\n}\n
In case the API request results in an error, the error is represented by an error object in the JSON response. All error codes and their meaning are listed in the Error Codes table.
{\n \"status\":\"error\",\n \"error\":{\n \"code\":\"E0006\",\n \"message\":\"authorization failed\"\n }\n}\n
All response objects described in the sections below are children of the result object returned by any successful API request.