v1

latestOpenAPI 3.0.02026-07-13104.4 KB

Returns latitude and longitude for the given easting and northing.

Takes an OSGB36 easting and northing (British National Grid) and returns the geographically equivalent WGS84 latitude and longitude.

A successful request returns the following fields:

  • status - this will be ok
  • easting - the easting provided in the request
  • northing - the northing provided in the request
  • latitude - the latitude of the converted coordinates
  • longitude - the longitude of the converted coordinates

An unsuccessful request returns the following fields:

  • status - this will be error
  • error - an error message
get/bng2latlong/{easting}/{northing}

Path parameters

eastinginteger required

An OSGB36 (British National Grid) easting.

northinginteger required

An OSGB36 (British National Grid) northing.

Response

A JSON object containing the original easting and northing, and the converted latitude and longitude.

status'ok' | 'error'
errorstring
eastinginteger
northinginteger
latitudenumber
longitudenumber

Example response

{
  "error": "Both <easting> and <northing> must be provided, must be positive integers, and must be within range.",
  "easting": 326897,
  "northing": 673919,
  "latitude": 55.95271,
  "longitude": -3.17227
}
All 1 operations