10 endpoints

Maps & spatial

Fetch observations and work with shapes: find the areas at a point or in a box, get boundaries, and see which areas border or overlap each other.

• Convert a coordinateConvert between WGS 84 and the supported UK national grids while keeping the transformation and any precision caveat visible.get/coordinates:convert
• Get observationsThe main way to fetch data. Ask for a measure, a period and the set of areas it was published on, and you get the values exactly as the publisher released them, with nothing converted or added up.get/data/{measure-id}
• Find areas in a boxGive a box of coordinates as west,south,east,north and get every area that meets it, each marked within the box or overlaps if it crosses the edge. It's the query a map makes as you pan around.get/areas:intersects
• Find areas at a pointWhich ward is this spot in? Give a longitude and latitude and get the area, or areas, of one geography that contain it.get/areas:contains
• Find areas for many pointsThe same lookup as Find areas at a point, for up to 100 points in one request. Handy for tagging a list of sites or addresses with their ward and council.post/areas:containsBatch
• Find the nearest areasGet the areas closest to a point, nearest first, with the distance to each. It answers the questions a containment lookup can't, like which ward is nearest a point just offshore.get/areas:near
• Get the shapes inside an areaGet the shapes of every area inside another, such as all the wards in a local authority, as one GeoJSON FeatureCollection. One request instead of hundreds.get/areas/{geography}/{release}/{code}/children/geometry
• List neighbouring areasFind the areas that share a border with this one, longest shared border first. Just what you need for "how does this ward compare with the ones around it?".get/areas/{geography}/{release}/{code}/neighbours
• Measure how two areas overlapSee how much two areas overlap, even across different geographies such as a constituency and a local authority, without downloading either shape. You get the shared area, each side's share of it and a plain relation like within or overlaps.get/areas/{geography}/{release}/{code}/overlap
• Get an area's shapeDownload one area's boundary as a GeoJSON Feature, in ordinary longitude and latitude (WGS 84). You get full detail by default; add tier for a lighter version.get/areas/{geography}/{release}/{code}/geometry