#OS Places API Demos

This repo contains working examples of how to use the Ordnance Survey Places API, a RESTful API based on OS AddressBase Premium datasets. The API returns queries to the service in either XML or JSON, and through a 'find' resource enables rapid searches of AddressBase Premium to drill down and isolate ambiguous addressing details. The 'match' resource is for more granular matching and cleansing of existing address databases. Neither features needs any database management of AddressBase Premium. 'Postcode' searches need the area and district integers as a minimum. There are JQuery examples using getJSON and examples using typeahead.js. Additionally Leaflet and Openlayers examples are provided to facilliate the Geosearch resources.

Register for an API key of OS Places API here.

Full documentation for the OS Places API can be found here, while service terms for OS Places API can be found here.

##About OS Places API

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 one place may have more than one name: an official name, such as Cardiff (English) and then another name, Caerdydd (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.

##License

These demos are released under the Apache 2.0 License.