Version: 2018-07-10
Prerequisites: PmWiki 2.2.103 (PHP 7.4 compatible)
Status: Production
Questions answered by this recipe
How do I display on a PmWiki page part of a topographic map of New Zealand using the official LINZ's 1:50,000 / Topo50 and 1:250,000 / Topo250 maps, as well as 1:25,000 / Topo25 maps for some of the offshore islands?
Description
This recipe generates the markup for topomap.co.nz's ability to share and embed the map
Installation
Usage
Place the directive, as described below, in your PmWiki page.
You can specify a locale as a decimal WGS84 latitude and longitude (ll), in NZTM coordinates (nzne), as a Topo50 map reference (mapref), or specify a publicly accessible the URL of a gpx or kml file to overlay on the map (kml, gmx).
The scale of the map, but not the image, will automatically resize to the area covered by the kml / gpx data,
or you can optionally specify the map zoom factor and the image size (height and width) to control the area of the map shown.
You can specify bounds of an area, by latitude and longitude (llbs), or NZTM coordinates (nzbs).
The recipe will resize the map image based on the size of the rectangle defined by the bounds and the zoom scale factor.
You can optionally specify to show a pin marker (pin), and again optionally show a tool tip label for the marker (label).
The recipe provides a page variable {$NZTopoVersion} which contains the current version, and $NZTopo for a (:if enabled NZTopo:) recipe installation check.
Configuration
(:nztopo ll=latitude,longitude
llbs=latitude,longitude;latitude,longitude[;latitude,longitude...]
nzne=northing,easting
nzbs=northing,easting;northing,easting[;northing,easting...]
mapref=mapref
kml="url" gpx="url"
height=pixels width=pixels pin=1 label="string" zoom=number float=left|right clear=both|right|left:)
ll= -- centre point of the map as a decimal latitude,longitude
llbs= -- decimal latitude longitude bounds: latitude,longitude;latitude,longitude[;latitude,longitude...]
nzne= -- centre point of the map as an NZTM northing,easting
nzbs= -- NZTM bounds: northing,easting;northing,easting[;northing,easting...]
mapref= -- NZ Topo50 grid reference, AAxxxyyy, e.g. BN33991890
Only one of: ll; llbs; nzne; nzbs; mapref; can be specified.
Only one of: kml; gpx; can be specified
height= -- image height in pixels, default is 150
width= -- image width in pixels, default is 300
float= -- float image to left or right
clear= -- clear image to left, right, or both
raw= -- raw=1 for DropBox files
pin= -- show pin (1)
label= -- tool tip label for pin
zoom= -- scale factor for map (5 to 15), zoom is ignored when bounds parameters are supplied
config.php settings
You can change the default zoom factor by using the variable $NZTopoZoom in config.php. For example
$NZTopoZoom = 10; # set default zoom factor for NZTopo directive
By default clicking on the maps opens a full screen map in a new browser tab. You can change this as follows
$NZTopoNewwin = 0; # set open in new window flag for NZTopo directive
CSS
You can add CSS similar to this to local.css.
/* CSS for NZTopo recipe */
.nztopo {
margin: 0.5rem;
}
.nztopoframe {
border-radius: 0.5rem;
}
Notes
For the bounds llbs and nzbs parameters only two coordinates need to be supplied, but they take any number of coordinates.
If a user had a bunch of coordinates they're interested in they don't need to manually calculate the two corner points to pass in themselves.
Passing in all of them and allows the map work out what the bounding box is, e.g. they might have 10 waypoints from a tramp - they can just pass all 10 coordinates in and the map will adjust its bounds to make sure all 10 waypoint coordinates are visible.
Zoom 5 to 12 show the Topo250 map series and zoom 13 to 15 show the Topo50.
The API for specifying a gpx file differs from that for specifying a kml file.
See the recipe's code for the extra handling required to use the API with a kml file.
Web server
For this recipe to work your web server must be able to serve gpx and kml files.
You will need to add the media types
- kml =
application/vnd.google-earth.kml+xml
- gpx =
application/gpx+xml[3]
Change log / Release notes
2018-07-10 Don't generate zoom parameter when llbs or nzbs
2018-05-14 Call topomap with https
2018-05-12 Make PHP 7.2 compatible
2015-07-01 gpx and kml now work, improve code, production ready
2014-08-09 Make PHP 5.5 compatible
See also
Contributors
Special thanks to Gavin Harriss
Comments
See discussion at NZTopo-Talk?
