Description

A plugin to display UK Ordnance Survey OpenSpace maps with markers and tracks.

Important Notice

Ordnance Survey will be withdrawing the OpenSpace service in August 2021, having replaced it with their new OS Data Hub. This new service is much superior and there is a new OS DataHub Maps plugin available to use it. The new plugin uses the same shortcode and is compatible with the OpenSpace plugin, so you should not have to change your shortcodes. It contains several new features such as fullscreen view and elevation profiles. We recommend upgrading to the new service and plugin as soon as possible.

This plugin works using the [osmap] shortcode anywhere in your post, page or custom post type content. It allows maps with markers or GPX/KML files to be shown.

The following attributes can be passed:

• height="600" sets the height of the map div
• width="800" sets the width of the map div. Leave blank to use available width.
• scale="5" sets the initial zoom level
• color="red" or color="#ff0000" (colour is also acceptable) sets the colour of the track shown from a file.
• track="3" sets the width of the track shown from a file.
• gpx="http://www.example.com/myfile.gpx" specifies a gpx file to be displayed
• kml="http://www.example.com/myfile.kml" specifies a kml file to be displayed
• markers="NY1234512345;Marker 1|54.454198,-3.211527;Marker 2" a list of positions and (optionally) labels separated by | with a ; between the position and label. Positions can be 6, 8 or 10 figure grid references or decimal lat long. Labels, if present, must be simple text.
• markerfile="http://example.com/markers.txt" specifies a text file containing marker definitions, one per line. As above, position and label are separated by ;. In this case the label can include any text including HTML, should you wish to include links or other formatting.
• centre="54.454198,-3.211527" sets the map centre point, to override the default centre or if not using markers or track files

Scale uses the OS scale values which are essentially multipliers on 1:10000 scale, so 5 represents 1:50000 and 100 represents 1:1M. The available scale values are 1, 2, 2.5, 4, 5, 10, 20, 50, 100, 200, 500, 1000, 2500. These are also listed on the help tab when you are editing a post or page.

To upload a KML or GPX file just use the WordPress media uploader and then copy the address of the uploaded file into the shortcode.

Examples

• [osmap height="300" width="300" color="blue" gpx="http://www.example.co.uk/myfile.gpx"] displays a 300px by 300px window containing a blue track from the file specified.

• [osmap markers="NY2000008000;Wasdale"]shows a default size and zoom window with a marker placed and the popup text “Wasdale”