{"_id":"55e9771139c5042d00912b3c","githubsync":"","user":"55c9b7b4e4927a0d0004a727","__v":10,"category":{"_id":"55e06ae66bad670d0081f25c","project":"55e06494a44fae0d002146aa","pages":["55e06b2358c5460d0076aa0f","55e06b33a44fae0d002146c5","55e06b4058c5460d0076aa11","55f9624d3bb4bb0d0022d188","56277cafe2ce610d004e3ebc","56277cb83a4c6b0d00c4555f","56277cc444c87f0d00fe6480","56277ccee2ce610d004e3ebe"],"version":"55e06495a44fae0d002146ad","__v":8,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-28T14:06:30.305Z","from_sync":false,"order":14,"slug":"os-routes-coming-soon","title":"OS Routes (Beta)"},"version":{"_id":"55e06495a44fae0d002146ad","project":"55e06494a44fae0d002146aa","__v":54,"createdAt":"2015-08-28T13:39:33.907Z","releaseDate":"2015-08-28T13:39:33.907Z","categories":["55e06496a44fae0d002146ae","55e06997a44fae0d002146c2","55e06a6958c5460d0076aa0c","55e06ae66bad670d0081f25c","55e06cc1a44fae0d002146cb","55e06ddda44fae0d002146cd","55e95f261fd7e82300ef359f","55e95fe47fc27b2d00d32cfa","55e96eef358d923700be984d","55e96ef6358d923700be984e","55e96efda7ca823900ad547e","55e96f04a7ca823900ad547f","55e970cc358d923700be9853","55e973f4358d923700be9858","55e973f9a7ca823900ad548c","55e977bf358d923700be985d","55e9780f8b72bb3700b1d5bd","55e97815a7ca823900ad5493","55e9781c358d923700be985f","55e97821461e2a390050f23b","55f963c23bb4bb0d0022d18c","5624c67406e8040d005ed6b2","5624dcf25a86b423009462e8","5625f229d0f87e190014c4ed","5627819fe2ce610d004e3ec8","562781b23a4c6b0d00c4556b","5627837166c62617009d17e2","5627851efcbbc621004ebff1","5627860044c87f0d00fe6491","562e3c6d54a5be0d00070c3e","564c955aae6cb82100dc137a","5652e22abbe7110d00dba748","5652f25523d4262d00b21c58","5652fdad51e4e81900bf2452","5652fdcbb60abb1700bafadc","5654494f65bec717007e0293","565da11a77f0090d005818ff","565f063f413e06170093de18","565f06fb413e06170093de21","56dd6773efaca42900e5f58e","56dd68630c3bb41700b0b037","56dd7d24d5419f170075dfb3","56dd9448c117291700015b60","56dd9454c117291700015b61","577a6f8b9748b80e00ef3f45","577a6f969748b80e00ef3f46","577bba7f6e5f301900fada99","57a9cc8e5b1ace0e00de743f","58aab134c50c33250046b8f8","58aab146aecc3e2500573d4c","58aab1628f862f250076f92e","58aab1938f862f250076f92f","58aab3e5aecc3e2500573d56","58aab3f2aecc3e2500573d57"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"parentDoc":null,"project":"55e06494a44fae0d002146aa","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-04T10:48:49.637Z","link_external":false,"link_url":"","sync_unique":"","hidden":true,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"This API is not in active development and this documentation is intended for use at OS supported hackathons only. Please note that no access can be gained to this Beta API outside of OS experimental use.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What does the OS Routes API do?\"\n}\n[/block]\nThe OS Routes API lets users plot a route from A to B, or A to B to C, and get turn-by-turn directions for roads via car. In National Parks, we can deliver turn-by-turn directions for pedestrians and bicycles. There’s also the option to request either the shortest route or the quickest route.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"You can:\",\n  \"body\": \"* Request A to B and A to B via C turn-by-turn routing\\n* Get timings for cars, bicycles and pedestrians\\n* Avoid specific hazards\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"You can't:\",\n  \"body\": \"* Look for routes outside Great Britain\\n* Choose routing options other than ‘shortest’ or ‘fastest’\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"How does it do that?\"\n}\n[/block]\nThis is a RESTful API, returning queries in either GPX or JSON. The API uses information from OS MasterMap Integrated Transport Network Layer (ITN) for vehicular routing and the Detailed Path Network (DPN) for pedestrian routing through the National Parks.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"WGS84 (EPSG:4326)\",\n  \"body\": \"A standard, earth-centred coordinate system\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"British National Grid (BNG)\",\n  \"body\": \"X coordinates in BNG are also commonly referred to as Eastings, while Y coordinates are also known as Northings.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Which data source(s) does the API use?\"\n}\n[/block]\n### Integrated Transport Network (ITN) Layer\nOS MasterMap ITN Layer is a topologically structured link-and-node network representing the Roads Network of Great Britain, from motorways to pedestrianised streets. It includes the following:\n* road classifications;\n* road names; \n* forms of road;\n* motorway junctions; \n* references to the intersecting polygons from OS MasterMap Topography Layer.\nAs an optional theme, we can deliver factors that may influence the choice of route – this is described as RRI (Road Routing Information) – and this extends the functionality of the Roads Network. \nWe aim to update the Roads Network after each update of OS MasterMap Topography Layer. The RRI is updated within six months of change occurring in the real-world wherever possible. \nA road is defined as a metalled way driveable by an ordinary vehicle such as a family car (and metalling is defined as the systematic application of material to assist the passage of a vehicle). \nPublic and private roads are included and the accessibility of any road section is indicated. Features are provided with attributions that provide extra detail, such as the length of a road section, junction names and the type of road. Attribution on RRI is divided into three types of category known as qualifiers:\n* environmental qualifiers provide information on the physical entities on a given part of a network – such as a level crossing – that a driver may wish to avoid;\n* vehicular qualifiers provide information on the types of vehicle that may or may not be driven on a given part of the network, such as a stretch of road with access for buses only; and\n* date/time qualifiers provide information on when a driver may wish (or be directed) to use or avoid a given part of the network, such as seasonal road closure.\nThe network lines are in geometric sympathy with the topographic detail that’s available in OS MasterMap Topography Layer, and they’re also aligned to the aerial photographs in our OS MasterMap Imagery Layer.\n\n### OS Detailed Path Network (DPN)\nThe Detailed Path Network (DPN) is a digital representation of the roads, tracks and paths in the National Parks of Great Britain that people may use to enjoy the great outdoors. \nWhile the DPN is indicative of the right of access, it’s not a legally definitive source of access information about Public Rights of Way. However, key features comprise: \n* Height data\n* A connected link and node network \n* Description of the type of route – road, track or path\n* National and Local Cycle Routes  \n* Named long distance routes\n* Names of roads, tracks and paths\n* Information on Rights of Way (England and Wales only)\n* Routes within Access Land (England and Wales only)","excerpt":"","slug":"os-routes-overview","type":"basic","title":"Overview"}
This API is not in active development and this documentation is intended for use at OS supported hackathons only. Please note that no access can be gained to this Beta API outside of OS experimental use. [block:api-header] { "type": "basic", "title": "What does the OS Routes API do?" } [/block] The OS Routes API lets users plot a route from A to B, or A to B to C, and get turn-by-turn directions for roads via car. In National Parks, we can deliver turn-by-turn directions for pedestrians and bicycles. There’s also the option to request either the shortest route or the quickest route. [block:callout] { "type": "success", "title": "You can:", "body": "* Request A to B and A to B via C turn-by-turn routing\n* Get timings for cars, bicycles and pedestrians\n* Avoid specific hazards" } [/block] [block:callout] { "type": "danger", "title": "You can't:", "body": "* Look for routes outside Great Britain\n* Choose routing options other than ‘shortest’ or ‘fastest’" } [/block] [block:api-header] { "type": "basic", "title": "How does it do that?" } [/block] This is a RESTful API, returning queries in either GPX or JSON. The API uses information from OS MasterMap Integrated Transport Network Layer (ITN) for vehicular routing and the Detailed Path Network (DPN) for pedestrian routing through the National Parks. [block:callout] { "type": "info", "title": "WGS84 (EPSG:4326)", "body": "A standard, earth-centred coordinate system" } [/block] [block:callout] { "type": "info", "title": "British National Grid (BNG)", "body": "X coordinates in BNG are also commonly referred to as Eastings, while Y coordinates are also known as Northings." } [/block] [block:api-header] { "type": "basic", "title": "Which data source(s) does the API use?" } [/block] ### Integrated Transport Network (ITN) Layer OS MasterMap ITN Layer is a topologically structured link-and-node network representing the Roads Network of Great Britain, from motorways to pedestrianised streets. It includes the following: * road classifications; * road names; * forms of road; * motorway junctions; * references to the intersecting polygons from OS MasterMap Topography Layer. As an optional theme, we can deliver factors that may influence the choice of route – this is described as RRI (Road Routing Information) – and this extends the functionality of the Roads Network. We aim to update the Roads Network after each update of OS MasterMap Topography Layer. The RRI is updated within six months of change occurring in the real-world wherever possible. A road is defined as a metalled way driveable by an ordinary vehicle such as a family car (and metalling is defined as the systematic application of material to assist the passage of a vehicle). Public and private roads are included and the accessibility of any road section is indicated. Features are provided with attributions that provide extra detail, such as the length of a road section, junction names and the type of road. Attribution on RRI is divided into three types of category known as qualifiers: * environmental qualifiers provide information on the physical entities on a given part of a network – such as a level crossing – that a driver may wish to avoid; * vehicular qualifiers provide information on the types of vehicle that may or may not be driven on a given part of the network, such as a stretch of road with access for buses only; and * date/time qualifiers provide information on when a driver may wish (or be directed) to use or avoid a given part of the network, such as seasonal road closure. The network lines are in geometric sympathy with the topographic detail that’s available in OS MasterMap Topography Layer, and they’re also aligned to the aerial photographs in our OS MasterMap Imagery Layer. ### OS Detailed Path Network (DPN) The Detailed Path Network (DPN) is a digital representation of the roads, tracks and paths in the National Parks of Great Britain that people may use to enjoy the great outdoors. While the DPN is indicative of the right of access, it’s not a legally definitive source of access information about Public Rights of Way. However, key features comprise: * Height data * A connected link and node network * Description of the type of route – road, track or path * National and Local Cycle Routes * Named long distance routes * Names of roads, tracks and paths * Information on Rights of Way (England and Wales only) * Routes within Access Land (England and Wales only)