Description

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

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. Examples are available at ButNoIdea.co.uk and mudandroutes.

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”