Editing ClubWiki:Using GMaps

This wiki site uses a MediaWiki extension called Google Maps. It's full syntax description can be found at its [http://www.mediawiki.org/wiki/Extension:Google_Maps/Syntax home site]. Here we will just describe the basic features typically used for this site for simplicity for our users

== Basic use ==
The Google map is invoked by using the following basic structure
<pre>
<googlemap options>
(optional and multiple possible) KML file locations
(optional and multiple possible) pin locations
</googlemap>
</pre>

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:

* version (needs to be 0.9 to use multiline captions for pins to include more information or picture)
* width (in pixels; default is 740)
* height (in pixels; default is 600)
* lat (the center latitude on the map)
* lon (the center longitude on the map)
* zoom (the zoom level; 0 is the furthest away, 21 is the closest in; 15 is closest zoom for terrain)
* type ("normal" or "map", "hybrid", or "satellite"; default is "hybrid")
* controls (''small'' creates +/- zoom buttons, ''medium'' has zoom buttons and pan buttons, ''large'' has pan buttons with a sliding scale for zoom, and ''none'' has no buttons)
* selector (show the map/hybrid/satellite selector? ''yes'' (default) and ''no''.)
* scale (show the distance scale? ''yes'' and ''no'' (default).)
* overview (show the inset navigation map? ''yes'' and ''no'' (default).)
* icons (web address if the marker icon is customized. With "{label}" where the name of the icon will be inserted; defaults to "<nowiki>http://maps.google.com/mapfiles/marker{label}.png</nowiki>")
* icon (web address if the marker icon is not specified; the default icon is [http://maps.google.com/mapfiles/marker.png http://maps.google.com/mapfiles/marker.png])
* units ("meters" or "miles"; default is "meters".)

All attributes are optional (except version if using a multiline caption). 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:

<pre>
<googlemap version="0.9" lat="36.500667" lon="-82.47797" zoom="12" width="500" height="400" type="map" controls="small">
</googlemap>
</pre>

== KML files ==
Before you specify any markers, you can add URL(s) that point to [http://en.wikipedia.org/wiki/Keyhole_Markup_Language KML] files. Each URL should be on its own line, e.g.

 <nowiki><googlemap></nowiki>
 <nowiki>http://tehcc.org/clubwiki/kml/Pinnacle_Mountain_Tower_Trail.kml</nowiki>
 <nowiki>http://other.url/</nowiki>
 ...
 <nowiki></googlemap></nowiki>

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 [mailto:webmaster@tehcc.org 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 <nowiki><googlemap></nowiki> tags:
<pre>
lat,lon,balloon title (title will be auto linked to a page on this wiki)
balloon text and/or images, can be multiple lines
</pre>

Full coding showing two pins, the first with a linked title and regular text and the second with no linked title but regular text and a small image:
<pre><googlemap version="0.9" lat="36.500667" lon="-82.47797" type="terrain" zoom="15" width="715" height="350" scale="yes" controls="large">
36.50013,-82.47760,WPSP Sinking Waters
Here is the location of the trail head
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]]
</googlemap>
</pre>

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

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

1. Add the icon address in quotes to the googlemap tag, using '''icon''': 
 <nowiki><googlemap lat="36.072635" lon="-79.791975" icon="http://images.wikia.com/walkingdead/images/7/70/Markerfight.png"></nowiki>

Full coding example:
 <nowiki><googlemap lat="36.072635" lon="-79.791975" icon="http://images.wikia.com/walkingdead/images/7/70/Markerfight.png"></nowiki>
 38.453857, -84.356461, Rick Grimes Shot
 <nowiki></googlemap></nowiki>

=== Custom icons ===
This site has a list of custom icons that can be used. See the [[#Icons reference]] to know which letters will invoke which icon

#Add the following extension '''icons''' option: 
##<nowiki><googlemap lat="36.500667" lon="-82.47797" icons="http://tehcc.org/clubwiki/kml/marker{label}.png"></nowiki> 
#Prefix the pin coordinates with (X) where 'X' is the letter for the pin icon desired
##<nowiki>(G) 36.502891,-82.468700</nowiki>

Full coding of a custom icon map:
<pre>
<googlemap lat="36.500667" lon="-82.47797"width="715" height="350" icons="http://tehcc.org/clubwiki/kml/marker{label}.png">
(E) 36.50013,-82.47760
Fall Creek Falls
[[Image:WPSP Fall Creek Falls.jpg|150px|Fall Creek Falls]]
(A) 36.502632,-82.482759
Parking along Fall Creek Road
(G) 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]]
</googlemap>
</pre>

==== Icons reference ====
Icons in use at this site
{| class="wikitable" style="text-align: left; border=1"
!Letter
!Icon
!Meaning
|----
|A
|http://tehcc.org/clubwiki/kml/markerA.png
|Parking
|----
|B
|http://tehcc.org/clubwiki/kml/markerB.png
|Picturesque location
|----
|C
|http://tehcc.org/clubwiki/kml/markerC.png
|Waterfall
|----
|D
|http://tehcc.org/clubwiki/kml/markerD.png
|Alternate for picturesque
|----
|E
|http://tehcc.org/clubwiki/kml/markerE.png
|Overlook
|----
|F
|http://tehcc.org/clubwiki/kml/markerF.png
|Shelter
|----
|G
|http://tehcc.org/clubwiki/kml/markerG.png
|Trailhead/intersection/point of interest
|----
|H
|http://tehcc.org/clubwiki/kml/markerH.png
|Campground
|----
|I
|http://tehcc.org/clubwiki/kml/markerI.png
|Cave
|----
|J
|http://tehcc.org/clubwiki/kml/markerJ.png
|Water crossing - no bridge - rock-hopping
|----
|K
|http://tehcc.org/clubwiki/kml/markerK.png
|Bench
|----
|L
|http://tehcc.org/clubwiki/kml/markerL.png
|Trail bridge
|----
|M
|http://tehcc.org/clubwiki/kml/markerM.png
|Cell Tower/Antenna
|----
|N
|http://tehcc.org/clubwiki/kml/markerN.png
|Cemetery
|----
|O
|http://tehcc.org/clubwiki/kml/markerO.png
|Playground
|----
|Q
|http://tehcc.org/clubwiki/kml/markerQ.png
|Toilet
|----
|R
|http://tehcc.org/clubwiki/kml/markerR.png
|Tunnel
|----
|S
|http://tehcc.org/clubwiki/kml/markerS.png
|Picnic Area
|----
|}
Search http://mapicons.nicolasmollet.com/ for other icons to suggest, send to [mailto:webmaster@tehcc.org webmaster] for inclusion

== 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
*[[WPSP Devil's Backbone|Devil's Backbone]] - Multiple KML files and many pins showing pictures and more