Guidance

Publish your geographies as data

This guidance sets out how to structure and publish geographical data.

It details what data should be provided and how it should be made available online.

A geography can be any area, location, site or boundary you have created and these two images show what the data looks like.

Boundary

An example of shape data shown on a map - in this case it is the boundary of a conservation area

See complete record for this conservation area record.

Point

An example of point data shown on a map - in this case it is the location of a listed building

See complete record for the listed building record shown as a point.

You can publish your geography data as GeoJSON, ESRI shapefiles, KML or CSV containing the geometry as WKT.

Each record must contain a boundary, polygon or site point.

Publishing as GeoJSON, shapefiles or KML

GeoJson, a shapefile or KML consists of data for the shape or point, and a number of attributes containing data about the geography.

Each record should include the following attributes:

name

The name of the area or boundary which your organisation uses. This will be used as the name that users see and refer to, for example, Rawcliffe.

documentation-url

If available, a link to the documentation which contains the authoritative boundary. This may be the appraisal document, or separate PDF containing the map and “red line” boundary. A URL is a permanent link that doesn’t change.

legislation

Policy or relevant legislation related to the geographical data or area, such as conservation areas.

organisation

Use the code for the organisation that created the area or boundary. This is usually made up of letters and sometimes numbers. This will allow machines to link the data to the publishing organisation; for example, NFK is the code for Norfolk County Council.

You can use the list of organisations to help you find your organisation code.

reference

A unique number or code used to identify the geographical area. The code should be unique within your organisation, for example, CA01.

If a reference code has been used to refer to a different location in the past, you should add something to the reference to make it unique and meaningful to your organisation.

For example, if E07000137 has been used in the past to refer to another area, add letters such as LKQ, numbers or a combination that makes sense to you. This will make a new reference for the new location and in this case you would have the reference E07000137-LKQ.

If you have inherited locations defined by old organisations you could prefix the references with the organisation code. For example, WYO-E07000137 and AYL-E07000137.

notes

Supplementary information related to the geographical data.

entry-date

The date you created or updated the data record in your GIS system or in the CSV. Where possible, use the format YYYY-MM-DD for dates, for example, 2021-02-26.

start-date

The date the geographical data was first created. Use the format YYYY-MM-DD for dates where possible, for example, 1991-06-12.

end-date

The date the geographical area no longer existed due to a change like a boundary change. Where possible, use the format YYYY-MM-DD for dates. This date can be in the future if the date it will stop being a location or boundary is known, for example, 2025-10-11.

Publish in CSV format

If you prefer to publish your geography data in CSV format, you need to include all of the fields mentioned above as well as one of the following for each record:

Geometry

WKT representing the shape/boundary/area will also look like the Vulcan Village image above.

Point

Point data represents a particular item for example, listed buildings, points of interest or specific features like schools.The example below for Lovemead House, shows what point data for a listed building looks like. Point data is based on a pair of coordinates.

Lovemead House shown as a point on a map