{"_id":"55e970357f564237001d5b75","category":{"_id":"55e06a6958c5460d0076aa0c","project":"55e06494a44fae0d002146aa","version":"55e06495a44fae0d002146ad","pages":["55e06a956bad670d0081f25a","55e970158b72bb3700b1d5a4","55e973aca7ca823900ad5488","55e973d2461e2a390050f233","55e973e9a7ca823900ad548a","5628c1bc2c0fd9190067d9ad","5649c5b24fa1460d00780b19"],"__v":7,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-08-28T14:04:25.321Z","from_sync":false,"order":10,"slug":"os-names","title":"OS Names"},"project":"55e06494a44fae0d002146aa","user":"55c9b7b4e4927a0d0004a727","__v":16,"githubsync":"","parentDoc":null,"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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-04T10:19:33.318Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"What does the OS Names API do?\"\n}\n[/block]\nOS Names provides a fast lookup service on a large scale, but at the moment it doesn’t let users search for individual, detailed addresses (See [OS Places](doc:os-places-overview)). \nIt’s an exceptionally reliable way of supporting the discovery or identification and visualisation of a named place; geocoding; routing and navigation, and linking diverse information such as statistics or descriptions. The API can locate a feature using just its name, or it can find the closest location to a given point.\n[block:callout]\n{\n  \"type\": \"success\",\n  \"title\": \"You can:\",\n  \"body\": \"* Search for areas, cities and roads\\n* Search for postcodes\\n* Search for named woodlands and forests\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"You can't:\",\n  \"body\": \"* Search for specific addresses (e.g. 21 Croxton Road)\\n* Bulk-search for addresses\\n* Make more than 250,000 calls a month\"\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, which returns queries to the service in either XML or JSON. The service offers two resources: ‘find’ and ‘nearest’. Find is a string-based lookup service, while nearest uses a pair of BNG coordinates to return the nearest features.\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###OS Open Names\nOS Open Names is a geographic directory containing basic information about identifiable places. Those places are divided into themes, but the name of the place is the key property we use in queries. \n\nWithin OS Open Names, place names aren’t unique. Extra location details are provided to help users refine their queries and accurately identify the named place they’re interested in. These details include postcode district, populated place, district/borough, county/unitary authority, European region and country.\n\nWe also recognise that a place may have more than one name: one, such as Cardiff (in English) and then another, Caerdydd (in Welsh).\n\nOur specification will extend the Infrastructure for Spatial Information in the European Community (INSPIRE) Geographical Names theme to ensure it’s compliant with European open data initiatives.","excerpt":"","slug":"os-names-overview","type":"basic","title":"Overview"}
[block:api-header] { "type": "basic", "title": "What does the OS Names API do?" } [/block] OS Names provides a fast lookup service on a large scale, but at the moment it doesn’t let users search for individual, detailed addresses (See [OS Places](doc:os-places-overview)). It’s an exceptionally reliable way of supporting the discovery or identification and visualisation of a named place; geocoding; routing and navigation, and linking diverse information such as statistics or descriptions. The API can locate a feature using just its name, or it can find the closest location to a given point. [block:callout] { "type": "success", "title": "You can:", "body": "* Search for areas, cities and roads\n* Search for postcodes\n* Search for named woodlands and forests" } [/block] [block:callout] { "type": "danger", "title": "You can't:", "body": "* Search for specific addresses (e.g. 21 Croxton Road)\n* Bulk-search for addresses\n* Make more than 250,000 calls a month" } [/block] [block:api-header] { "type": "basic", "title": "How does it do that?" } [/block] This is a RESTful API, which returns queries to the service in either XML or JSON. The service offers two resources: ‘find’ and ‘nearest’. Find is a string-based lookup service, while nearest uses a pair of BNG coordinates to return the nearest features. [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] ###OS Open Names OS Open Names is a geographic directory containing basic information about identifiable places. Those places are divided into themes, but the name of the place is the key property we use in queries. Within OS Open Names, place names aren’t unique. Extra location details are provided to help users refine their queries and accurately identify the named place they’re interested in. These details include postcode district, populated place, district/borough, county/unitary authority, European region and country. We also recognise that a place may have more than one name: one, such as Cardiff (in English) and then another, Caerdydd (in Welsh). Our specification will extend the Infrastructure for Spatial Information in the European Community (INSPIRE) Geographical Names theme to ensure it’s compliant with European open data initiatives.