ClubWiki:Using GMaps

This wiki site uses a MediaWiki extension called Maps. It's full syntax description can be found at its home site. Here we will just describe the basic features typically used for this site for simplicity for our users.

Basic use

The map is invoked by using the following basic structure

<display_map options and KML links>
(optional and multiple possible) pin locations
</display_map>

This site prefers that routes/trails are kept in the KMLs and the pins/markers are specified within the wiki markup on the page. By keeping the pins specified in the wiki markup, it is easier for users of this site to add/remove/modify them.

The specifics of each portion are explained below

Extension options

Available coding options are (full list here):

• center (location which can be coordinates or place name but place names slows page render; default is centered on all listed pins)
• width (assumes pixels by default but can also be ex, em, %; default is auto)
• height (assumes pixels by default but can also be ex, em, %; default is 350)
• zoom (the zoom level; 0 is the furthest away, 21 is the closest in; 15 is closest zoom for terrain)
• type ("terrain" or "roadmap", "hybrid", or "satellite"; default is "roadmap")
• controls (controls to place on the map, list any/all pan, zoom, type, scale, streetview)
• zoomstyle (not sure yet, but I think we want this for small vs. large maps)
• typestyle (not sure yet, but I think we want this for small vs. large maps)
• kmlrezoom (yes/no center on drawn kmls; default is no)
• gkml (list URLs to kmls separated by a comma)
• markercluster (automatically groups crowded pins and zooms on click; default no)
• icon (Default icon to use for all markers/pins - only can apparently use an image on this site without the "File:" prefix)

All attributes are optional. If it is not specified the above described default will be assumed.

So the final code to place just a map with no other features might be:

<display_map center="Warriors Path State Park, TN" zoom="12" width="50%" height="200" type="terrain" controls="scale,type">
</display_map>

Loading map...

{"type":"TERRAIN","minzoom":false,"maxzoom":false,"types":["ROADMAP","SATELLITE","HYBRID","TERRAIN"],"mappingservice":"googlemaps3","width":"50%","height":"200px","centre":{"text":"","title":"","link":"","lat":36.5095802000000020370862330310046672821044921875,"lon":-82.4827230318375796969121438451111316680908203125,"icon":""},"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"visitedicon":"","wmsoverlay":false,"zoom":12,"layers":[],"controls":["scale","type"],"zoomstyle":"DEFAULT","typestyle":"DEFAULT","autoinfowindows":false,"resizable":false,"kmlrezoom":false,"poi":true,"cluster":false,"clustergridsize":60,"clustermaxzoom":20,"clusterzoomonclick":true,"clusteraveragecenter":true,"clusterminsize":2,"imageoverlays":[],"kml":[],"gkml":[],"searchmarkers":"","fullscreen":false,"scrollwheelzoom":false,"locations":[]}

KML files

KMLs are now specified within the open command. Using the kml (not sure when this is used) or gkml (the one we seem to need to use) you can add URL(s) that point to KML files. Each URL should be separated by a comma.

<display_map gkml="https://tehcc.org/clubwiki/kml/Pinnacle_Mountain_Tower_Trail.kml,http://other.url/,...">
</display_map>

These files will be dynamically imported into the map each time the map is loaded. For now, any new KMLs must be emailed to the webmaster for uploading to the site. These are kept in the above referenced (tehcc.org/clubwiki/kml) folder. Another warning is to avoid spaces in the KML title as these will not properly link, so use underscores or hyphens to connect the words.

Pins

Pins are added by using the following syntax within the <display_map> tags. The different attributes of the pin are separated by tildes (~).

Location~Title~Details~Icon~Visited Icon?~Label~???
location ~ balloon title ~ balloon contents ~ Map Icon (wiki file) ~ Visited Map icon (wiki file) ~ label(shows next to pin at all times)~ something else?

Full coding showing two pins, the first with a linked title and regular text with a persistent label and the second with no linked title but regular text and a small image:

<display_map center="36.500667,-82.47797" type="terrain" zoom="15" width="715" height="350">
36.50013,-82.47760~[[WPSP Sinking Waters|Sinking Waters]]~Here is the location of the trail head~MarkerA.png~ ~This is where Putin Works
36.502891,-82.468700~Connection~Intersection to/from [[WPSP_Fall_Creek_Loop_Trail|Fall Creek Loop]]<br>[[Image:To D Backbone Trail.jpg|150px|Trail head sign]]
</display_map>

Loading map...

{"type":"TERRAIN","minzoom":false,"maxzoom":false,"types":["ROADMAP","SATELLITE","HYBRID","TERRAIN"],"mappingservice":"googlemaps3","width":"715px","height":"350px","centre":{"text":"","title":"","link":"","lat":36.50066699999999997316990629769861698150634765625,"lon":-82.477969999999999117790139280259609222412109375,"icon":""},"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"visitedicon":"","wmsoverlay":false,"zoom":15,"layers":[],"controls":["pan","zoom","type","scale","streetview","rotate"],"zoomstyle":"DEFAULT","typestyle":"DEFAULT","autoinfowindows":false,"resizable":false,"kmlrezoom":false,"poi":true,"cluster":false,"clustergridsize":60,"clustermaxzoom":20,"clusterzoomonclick":true,"clusteraveragecenter":true,"clusterminsize":2,"imageoverlays":[],"kml":[],"gkml":[],"searchmarkers":"","fullscreen":false,"scrollwheelzoom":false,"locations":[{"text":"\u003Cb\u003E\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003E\u003Ca href=\"/wiki/WPSP_Sinking_Waters\" class=\"mw-redirect\" title=\"WPSP Sinking Waters\"\u003ESinking Waters\u003C/a\u003E\n\u003C/p\u003E\u003C/div\u003E\u003C/b\u003E\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003EHere is the location of the trail head\n\u003C/p\u003E\u003C/div\u003E","title":"Sinking Waters\n","link":"","lat":36.5001299999999986312104738317430019378662109375,"lon":-82.47759999999999536157702095806598663330078125,"icon":"/clubwiki/images/MarkerA.png","inlineLabel":"This is where Putin Works\n"},{"text":"\u003Cb\u003E\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003EConnection\n\u003C/p\u003E\u003C/div\u003E\u003C/b\u003E\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003EIntersection to/from \u003Ca href=\"/wiki/WPSP_Fall_Creek_Loop_Trail\" class=\"mw-redirect\" title=\"WPSP Fall Creek Loop Trail\"\u003EFall Creek Loop\u003C/a\u003E\u003Cbr /\u003E\u003Ca href=\"/wiki/File:To_D_Backbone_Trail.jpg\" class=\"image\" title=\"Trail head sign\"\u003E\u003Cimg alt=\"Trail head sign\" src=\"/clubwiki/images/thumb/To_D_Backbone_Trail.jpg/150px-To_D_Backbone_Trail.jpg\" decoding=\"async\" width=\"150\" height=\"199\" srcset=\"/clubwiki/images/thumb/To_D_Backbone_Trail.jpg/225px-To_D_Backbone_Trail.jpg 1.5x, /clubwiki/images/To_D_Backbone_Trail.jpg 2x\" data-file-width=\"265\" data-file-height=\"351\" /\u003E\u003C/a\u003E\n\u003C/p\u003E\u003C/div\u003E","title":"Connection\n","link":"","lat":36.50289099999999820056473254226148128509521484375,"lon":-82.4686999999999983401721692644059658050537109375,"icon":""}]}

The above commands can be used many times within a single map to create the pins needed.

Pin icons

Icons can be changed by two methods, changing all undefined icons to a specified one or invoking the custom icon list used on this site and then specifying pin by pin which icon to display for the pin. Custom icons are referenced using an image on the wiki without the "File:" prefix (e.g. MarkerA.png)

Default Pin Icons

The default icon used for pins can be changed by adding an icon command in the extension options:

Add the icon address in quotes to the displat_map tag, using icon:

<display_map icon=MarkerG.png>
38.453857,-84.356461~Rick Grimes Shot
38.462857,-84.365461~Rick Grimes Shot
38.444857,-84.347461~Rick Grimes Shot
</display_map>

Loading map...

{"type":"ROADMAP","minzoom":false,"maxzoom":false,"types":["ROADMAP","SATELLITE","HYBRID","TERRAIN"],"mappingservice":"googlemaps3","width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"MarkerG.png","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"visitedicon":"","wmsoverlay":false,"zoom":false,"layers":[],"controls":["pan","zoom","type","scale","streetview","rotate"],"zoomstyle":"DEFAULT","typestyle":"DEFAULT","autoinfowindows":false,"resizable":false,"kmlrezoom":false,"poi":true,"cluster":false,"clustergridsize":60,"clustermaxzoom":20,"clusterzoomonclick":true,"clusteraveragecenter":true,"clusterminsize":2,"imageoverlays":[],"kml":[],"gkml":[],"searchmarkers":"","fullscreen":false,"scrollwheelzoom":false,"locations":[{"text":"\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003ERick Grimes Shot\n\u003C/p\u003E\u003C/div\u003E","title":"Rick Grimes Shot\n","link":"","lat":38.453856999999999288775143213570117950439453125,"lon":-84.356460999999995920006767846643924713134765625,"icon":"/clubwiki/images/MarkerG.png"},{"text":"\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003ERick Grimes Shot\n\u003C/p\u003E\u003C/div\u003E","title":"Rick Grimes Shot\n","link":"","lat":38.4628569999999996298356563784182071685791015625,"lon":-84.3654609999999962610672810114920139312744140625,"icon":"/clubwiki/images/MarkerG.png"},{"text":"\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003ERick Grimes Shot\n\u003C/p\u003E\u003C/div\u003E","title":"Rick Grimes Shot\n","link":"","lat":38.4448569999999989477146300487220287322998046875,"lon":-84.3474609999999955789462546817958354949951171875,"icon":"/clubwiki/images/MarkerG.png"}]}

Custom icons

Custom icons are defined as the fourth of the pin parameters. This site has a list of custom icons that can be used. See the #Icons reference to know which letters will invoke which icon

Full coding of a custom icon map:

<display_map width="auto" height="350">
36.50013,-82.47760~Fall Creek Falls~[[Image:WPSP Fall Creek Falls.jpg|150px|Fall Creek Falls]]~MarkerE.png
36.502632,-82.482759~Parking along Fall Creek Road~ ~MarkerA.png
36.502891,-82.468700~Intersection to/from [[WPSP_Fall_Creek_Loop_Trail|Fall Creek Loop]]~[[Image:To D Backbone Trail.jpg|150px|Trail head sign]]~MarkerG.png
</display_map>

Loading map...

{"type":"ROADMAP","minzoom":false,"maxzoom":false,"types":["ROADMAP","SATELLITE","HYBRID","TERRAIN"],"mappingservice":"googlemaps3","width":"auto","height":"350px","centre":false,"title":"","label":"","icon":"","lines":[],"polygons":[],"circles":[],"rectangles":[],"copycoords":false,"static":false,"visitedicon":"","wmsoverlay":false,"zoom":false,"layers":[],"controls":["pan","zoom","type","scale","streetview","rotate"],"zoomstyle":"DEFAULT","typestyle":"DEFAULT","autoinfowindows":false,"resizable":false,"kmlrezoom":false,"poi":true,"cluster":false,"clustergridsize":60,"clustermaxzoom":20,"clusterzoomonclick":true,"clusteraveragecenter":true,"clusterminsize":2,"imageoverlays":[],"kml":[],"gkml":[],"searchmarkers":"","fullscreen":false,"scrollwheelzoom":false,"locations":[{"text":"\u003Cb\u003E\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003EFall Creek Falls\n\u003C/p\u003E\u003C/div\u003E\u003C/b\u003E\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003E\u003Ca href=\"/wiki/File:WPSP_Fall_Creek_Falls.jpg\" class=\"image\" title=\"Fall Creek Falls\"\u003E\u003Cimg alt=\"Fall Creek Falls\" src=\"/clubwiki/images/thumb/WPSP_Fall_Creek_Falls.jpg/150px-WPSP_Fall_Creek_Falls.jpg\" decoding=\"async\" width=\"150\" height=\"114\" srcset=\"/clubwiki/images/thumb/WPSP_Fall_Creek_Falls.jpg/225px-WPSP_Fall_Creek_Falls.jpg 1.5x, /clubwiki/images/WPSP_Fall_Creek_Falls.jpg 2x\" data-file-width=\"251\" data-file-height=\"191\" /\u003E\u003C/a\u003E\n\u003C/p\u003E\u003C/div\u003E","title":"Fall Creek Falls\n","link":"","lat":36.5001299999999986312104738317430019378662109375,"lon":-82.47759999999999536157702095806598663330078125,"icon":"/clubwiki/images/MarkerE.png"},{"text":"\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003EParking along Fall Creek Road\n\u003C/p\u003E\u003C/div\u003E","title":"Parking along Fall Creek Road\n","link":"","lat":36.50263199999999841338649275712668895721435546875,"lon":-82.4827590000000014924808056093752384185791015625,"icon":"/clubwiki/images/MarkerA.png"},{"text":"\u003Cb\u003E\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003EIntersection to/from \u003Ca href=\"/wiki/WPSP_Fall_Creek_Loop_Trail\" class=\"mw-redirect\" title=\"WPSP Fall Creek Loop Trail\"\u003EFall Creek Loop\u003C/a\u003E\n\u003C/p\u003E\u003C/div\u003E\u003C/b\u003E\u003Cdiv class=\"mw-parser-output\"\u003E\u003Cp\u003E\u003Ca href=\"/wiki/File:To_D_Backbone_Trail.jpg\" class=\"image\" title=\"Trail head sign\"\u003E\u003Cimg alt=\"Trail head sign\" src=\"/clubwiki/images/thumb/To_D_Backbone_Trail.jpg/150px-To_D_Backbone_Trail.jpg\" decoding=\"async\" width=\"150\" height=\"199\" srcset=\"/clubwiki/images/thumb/To_D_Backbone_Trail.jpg/225px-To_D_Backbone_Trail.jpg 1.5x, /clubwiki/images/To_D_Backbone_Trail.jpg 2x\" data-file-width=\"265\" data-file-height=\"351\" /\u003E\u003C/a\u003E\n\u003C/p\u003E\u003C/div\u003E","title":"Intersection to/from Fall Creek Loop\n","link":"","lat":36.50289099999999820056473254226148128509521484375,"lon":-82.4686999999999983401721692644059658050537109375,"icon":"/clubwiki/images/MarkerG.png"}]}

Icons reference

Icons in use at this site

Filename	Icon	Meaning	Name used in icon lists
MarkerA.png		Parking	Parking
MarkerB.png		Picturesque location	Photo spot
MarkerC.png		Waterfall	Waterfall
MarkerD.png		Alternate for picturesque	Other photo spot
MarkerE.png		Overlook	Overlook
MarkerF.png		Shelter	Shelter
MarkerG.png		Trailhead/intersection/point of interest	Point of interest
MarkerH.png		Campground	Campground
MarkerI.png		Cave	Cave
MarkerJ.png		Water crossing - no bridge - rock-hopping	Water crossing
MarkerK.png		Bench	Bench
MarkerL.png		Trail bridge	Trail bridge
MarkerM.png		Cell Tower/Antenna	Comm tower
MarkerN.png		Cemetery	Cemetery
MarkerO.png		Playground	Playground
MarkerP.png		Summit Marker	Summit
MarkerQ.png		Toilet	Toilet
MarkerR.png		Tunnel	Tunnel
MarkerS.png		Picnic Area	Picnic spot
MarkerT.png		Trail intersection signpost	Trail sign
MarkerU.png		Trail road crossing	Road crossing
MarkerV.png		Old abandoned structure or foundation	Old structure
MarkerW.png		Horseback riding	Horseback
MarkerX.png		Alien capsule(?!)	Alien landing
MarkerY.png		Rest spot	Rest
Marker1.png		Skiing	Skiing
Marker2.png		Tower (fire tower - It was the best that could be found)	Tower
powerline.png		Power Line	Power line
treedown.png		Blowdowns on trail	Blowdown
Rangerstation.png		Park ranger station, HQ, or visitor's center	Rangerstation

The following sites have been useful for icons. The first are in the format typically used on this site for map pins. The second are shapes that can be made to appear like the first (for consistency)

• http://mapicons.nicolasmollet.com/
• https://www.iconsdb.com/

Examples

Review the markup for these pages for good examples of embedded Google Maps, using most or all of the features described above

• Warriors Path State Park - Shows multiple KML files in use
• Devil's Backbone - Multiple KML files and many pins showing pictures and more

Unexplored Features

Here's a list of new capabilities of the map extension that haven't been explored yet but sounds possibly useful for this site

• Drawing of lines, circles, and polygons on a map using coordinates within the tag - information here
• Polygons on hover over a defined area - information here
• Searching within markers (although their examples don't seem to work - information here
• Fusion tables(???)
• Map Editor to create lines, polygons, pin placements, etc.
• Dynamic tables and maps by searching created pages - See example here that maps and lists based on individual pages (I would really like this for both the master trails list and map but could also be a good way to handle parks with several trails)