/OS-Open-Names

OS Open Names demos and code snippets

Primary LanguageJavaScriptApache License 2.0Apache-2.0

OS Names API Demos

This repo contains working examples of how to use the Ordnance Survey Open Names API, a RESTful API based on the OS Open Names dataset. The API returns queries to the service in either XML or JSON, and offers two resources: 'find' and 'nearest'. 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 Open Names API here

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

###About OS Open Names 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