NSW Bushwalking Maps

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== About ======

The mapping website at [[http://maps.ozultimate.com/]] was designed and built by Tom Brennan <website@ozultimate.com>.

For information on how to use the site, see the [[help|Help]] page.

With the exception of items noted below in the credits, code is licensed under the [[https://opensource.org/licenses/MIT|MIT license]], Copyright 2021 Tom Brennan.

Source files are available on [[https://github.com/tombrennan06/ozultimate-maps|Github]]

====== Credits ======

Map layers are (c) Department of Customer Service 2021. See [[https://www.spatial.nsw.gov.au/products_and_services/web_services|NSW Spatial Services - Web Services]] for more detail.

Interface uses the following libraries:
  * [[https://leafletjs.com/|Leaflet]] by Vladimir Agafonkin and others
  * [[https://github.com/ghybs/Leaflet.TileLayer.Fallback|Leaflet.TileLayer.Fallback]]
  * [[https://github.com/calvinmetcalf/leaflet-ajax|Leaflet AJAX]] by Calvin Metcalf
  * [[https://github.com/lizardtechblog/Leaflet.OpacityControls|Leaflet.OpacityControls]] - for the opacity slider, with some modifications
  * [[https://github.com/geoman-io/leaflet-geoman|Leaflet-Geoman]] - for adding markers, lines and polygons
    * previously used [[https://github.com/Leaflet/Leaflet.draw|Leaflet Draw]], but this does not appear to be being maintained
  * [[https://github.com/makinacorpus/Leaflet.FileLayer|Leaflet.FileLayer]] by Makina Corpus - for loading KML, GPX and GeoJSON files, including drag and drop on to the map canvas - modified to allow loading/editing of multigeometries
    * [[https://github.com/mapbox/togeojson|toGeoJSON]] - required by Leaflet.FileLayer
    * [[https://github.com/tmcw/geojson-flatten|geojson-flatten]] - by Tom Macwright, used by the modified Leaflet.FileLayer
  * Leaflet.Save - self authored, depends on
    * [[https://github.com/eligrey/FileSaver.js/|Filesaver.js]] by Eli Grey - helps to simplify the save functionality across different browsers
    * [[https://github.com/mapbox/tokml|tokml]] - allows saving back to KML
    * [[https://github.com/tyrasd/togpx|togpx]] - allows saving back to GPX
  * [[https://github.com/PowerPan/leaflet.mouseCoordinate|leaflet.mouseCoordinate]] - for displaying the co-ordinates in the lower right. I have created a modified version of this for the NSW maps
  * [[https://github.com/makinacorpus/Leaflet.GeometryUtil|Leaflet.GeometryUtil]] by Makina Corpus
  * [[https://jquery.com/|jQuery]] & [[https://jqueryui.com/|jQuery UI]]
  * [[http://touchpunch.furf.com/|jQuery Touch Punch]] for mobile UI improvements
  
Some icons are from [[http://fontawesome.io|Font Awesome]] by Dave Gandy

====== TODO======

  * Geographic name lookup
  * Ability to plot grid references from coordinates (see add points feature on [[http://topo.notto.be]]) 

====== Current Version ======

Help on the latest current version can be found under the [[help|Help]] page.

The current version can be found at [[http://maps.ozultimate.com/]].

====== Versions ======

The following versions are "live" in the sense that they will probably be improved by having any useful new features back populated where relevant. For example, some of the archive versions below can be made more useful by modifying some of the basic features. In short, the archive versions are more for learning, the ones in this section are for actual use. The reason for keeping a number of different versions in play is that for mobile in particular, more is not necessarily better. Functionality and data both cost bandwidth. Sometimes all you need is a basic topo map, without the bells and whistles.

These are the ones that I use at work, home or on mobile.

  * [[https://maps.ozultimate.com/topo/|Topo]] - Essentially the same as the Location one below. Single layer LPI topo map with user location on mobile (needs HTTPS).
  * [[https://maps.ozultimate.com/opacity/|Topo/Imagery]] - Similar to the Two Layer with Opacity one below - two layers (LPI Current Topo, LPI Imagery), with an opacity slider, but also 
    * supports the slider on mobile
    * has smooth opacity sliding rather than jerky
    * shows grid reference and map rather than full UTM (tap on mobile to show)
    * follows the user location on mobile (requires HTTPS)
  * [[https://maps.ozultimate.com/aus/|Australia]] - as per the main app, but with a topographic layer (1:100k) for Australia, and no aerial imagery.
  * [[https://maps.ozultimate.com/archive/tas/|Tasmania]] - as per the main app, but for Tasmania
====== Archive ======
The following versions of the mapping app are presented for others to use/learn from/steal etc. They are all licensed under the [[https://opensource.org/licenses/MIT|MIT License]]. They represent a progression of learning which may be useful for people.

  * [[http://maps.ozultimate.com/archive/01_basic_topo/|Basic Topo]] - this is close to the simplest version of a mapping app under Leaflet that's possible. It includes one layer, the LPI Current Topo layer, plus a pointer which displays co-ordinates. Not bad for mobile, since it's much lighter weight than subsequent versions, and only one layer. I made a change to the mouse co-ordinates code to allow a tap on the screen to cause the co-ordinates to change, as there's no mouse or "mouseover" on mobile!
    * [[https://maps.ozultimate.com/archive/01a_location/|Location]] - as above, but includes a location function that uses the GPS, and also uses the mouse co-ordinates code from Map Lookup below to find a 6 figure grid reference and map rather than full UTM. Probably needs to be accessed via HTTPS due to Chrome moving to secure location data. Ideally there would be a way of caching the topo tiles for offline use.
  * [[http://maps.ozultimate.com/archive/02_opacity/|Two Layer with Opacity]] - a good all purpose map. Two layers (LPI Current Topo, LPI Imagery), with an opacity slider to move between them. Great for finding passes and canyons.
    * [[http://maps.ozultimate.com/archive/02a_opacity_s1_s2/|Two Layer with Opacity (old/new series maps)]] - as above, but with the layers being the LPI Current Topo and the LPI Series 1 Topo. Good for comparing changes.
  * [[http://maps.ozultimate.com/archive/03_file_load/|Load GPX/KML/GeoJSON Files]] - as above, but with the ability to drag and drop GPX/KML/GeoJSON files on to the map (or open), and have them displayed as tracks and markers. The map will automatically zoom to the extent of the file. Waypoint names appear in a popup if you click on the marker.
  * [[http://maps.ozultimate.com/archive/04_data_creation/|Create/Edit data]] - similar to [[http://maps.ozultimate.com/archive/02_opacity/|Two Layer with Opacity]], but with the ability to create, edit, delete and save markers, lines and polygons using Leaflet.Draw and a plugin I wrote (Leaflet.Save). This allows saving to KML, GPX and GeoJSON, depending on what has been enabled. Polygons display their area when created or edited.
  * [[http://maps.ozultimate.com/archive/05_map_lookup/|Map Lookup]] - as above, but with an alteration to the mouse co-ordinates to include the NSW map name and 6-figure grid reference. The map name uses a grid based lookup, so is not 100% accurate, as there are some maps that don't exactly align with the relevant 1:25k, 1:50k or 1:100k grids.
  * [[http://maps.ozultimate.com/archive/06_permalink/|Permalink]] - as above, but with ability to save a link that can be shared. This includes the current zoom, map centre, and any objects that have been drawn on the map (but not including items loaded via the File Load above).
  * [[http://maps.ozultimate.com/archive/07_label_edit|Label Edit]] - as above, but with ability to add/edit labels on features. Also allows editing/saving of data loaded from GPX/KML/GeoJSON.
  * [[http://maps.ozultimate.com/archive/08_print|Print]] - basic topo map only, but enables a user selectable box to select a print area. When the save button is clicked, the tiles are downloaded and stitched together, and a PNG file exported. The resulting image usually needs some post-processing, as the contour lines print in a pale colour.