Mapping data and geographic information from Ordnance Survey

TOID^® look-up prototype

Welcome to the OS OpenData TOID look-up prototype for OS MasterMap^® Topography Layer.

Every OS MasterMap feature has a unique identifier known as a TOID. All features in OS MasterMap Topography Layer (such as buildings, roads, woodland and water bodies) have been assigned TOIDs which are persistent throughout the life of that feature. TOIDs hold no intelligence and are allocated sequentially as updates are applied to the database.

All TOIDs consist of 13 or 16-digits, with a prefix of 'osgb' e.g. 'osgb1000000323207755'. Some systems store 13-digit TOID with three leading zeros to give a consistent 16-digit length to the numeric part.

By attaching one or more TOIDs to your own data you can easily share and link it with other TOID-based datasets. You can find out more about TOIDs here: http://www.ordnancesurvey.co.uk/oswebsite/products/osmastermap/faqs/general005.html

This prototype offers the following services:

Check the validity of a TOID. If you have a TOID in a dataset, the service can be used to check whether or not that TOID exists within the current OS MasterMap Topography Layer.
Query for a TOID at a given location. If you send the service a pair of British National Grid coordinates or a pair of latitude and longitude values (reference system ETRS89), it will send you back the TOID or TOIDs for that given point.

This beta release contains data for Great Britain. It is designed to be used to inform our development of a production version. Please send your thoughts on the service to openspace@ordnancesurvey.co.uk with TOID service in the subject line.

Instructions:

Validate TOID service: There are two ways of using this service.

Use the validate TOID service directly. To do this, copy "http://opentoids.ordnancesurvey.co.uk/toidservice/toid/TOID value" into a browser window. Replace 'TOID value' with the TOID you would like to validate, entering 'osgb' in lower case and omitting leading zeros in the numeric part of the TOID (e.g. 'osgb1000000323207755'). This service will return a JSON file with 'true' if the TOID is valid and 'false' if the TOID is invalid. If the TOID format supplied is incorrect, the service will return an HTML 404 response.
Use the form provided at Validate TOID to input a TOID. This will display the results on the page.

Location service:

The Location service can be used by either supplying eastings and northing or latitude and longitude.

Eastings/Northings: There are two ways of using this service.

Use the location service directly. To do this, copy "http://opentoids.ordnancesurvey.co.uk/toidservice/location?eastingnorthing=x,y" into a browser window. Replace 'x' and 'y' with the coordinates of the point you would like checked (e.g. 299500,319500). This service will return a JSON file with a list of TOIDs present at the given point – and if no TOIDS are found, it will return an empty array i.e beyond the extent of data coverage. If the point geometry format supplied is incorrect, the service will return an HTML 404 response. The coordinate entered will be resolved to the closest 5 metre grid location and the TOID, or TOIDs, for that grid location returned as the answer to your query.
Use the form provided at Location service to input eastings and northings of a point. This will display the results on the page.

Latitude/Longitude: There are two ways of using this service.

Use the location service directly. To do this, copy "http://opentoids.ordnancesurvey.co.uk/toidservice/location?latlong=lat,long" into a browser window. Replace 'lat' and 'long' with the values of the point you would like checked (e.g. 53.22573,-4.14359). Please note that Latitude/Longitude should be written as decimal of a degree. This service will return a JSON file with a list of TOIDs present at the given point – and if no TOIDS are found, it will return an empty array i.e beyond the extent of data coverage. If the point geometry format supplied is incorrect, the service will return an HTML 404 response. The coordinate entered will be resolved to the closest 5 metre grid location and the TOID, or TOIDs, for that grid location returned as the answer to your query.
Use the form provided at Location service to input latitude and longitude of a point. This will display the results on the page.