Skip to content

Instantly share code, notes, and snippets.

@psd
Created August 16, 2021 16:08
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save psd/10270839cc6fb2f2c7aaed01dcd61f70 to your computer and use it in GitHub Desktop.
Save psd/10270839cc6fb2f2c7aaed01dcd61f70 to your computer and use it in GitHub Desktop.

>>>>> gd2md-html alert: ERRORs: 0; WARNINGs: 0; ALERTS: 3.

  • See top comment block for details on ERRORs and WARNINGs.
  • In the converted Markdown or HTML, search for inline alerts that start with >>>>> gd2md-html alert: for specific instances that need correction.

Links to alert messages:

alert1 alert2 alert3

>>>>> PLEASE check and correct alert issues and delete this message and the inline alerts.


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

>>>>> gd2md-html alert: inline image link here (to images/image1.png). Store image on your image server and adjust path/filename/extension if necessary.
(Back to top)(Next alert)
>>>>>

alt_text

See complete record for this conservation area record.

Point

>>>>> gd2md-html alert: inline image link here (to images/image2.png). Store image on your image server and adjust path/filename/extension if necessary.
(Back to top)(Next alert)
>>>>>

alt_text

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.

>>>>> gd2md-html alert: inline image link here (to images/image3.png). Store image on your image server and adjust path/filename/extension if necessary.
(Back to top)(Next alert)
>>>>>

alt_text

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment