Editing ClubWiki:Using GMaps

In many cases you can get by using the [[Extension:Google Maps/Editor's Map|Editor's Map]], but understanding the underlying coding of the Google maps extension will unlock a few extra features for you.

== Extension options ==
Available coding options are:

* 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)
* 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.

So the final code might be:

<pre>
<googlemap lat="52.523777" lon="13.411896" zoom="12" width="500" height="400" type="map" controls="small">
52.499683,13.333907,Kaiser Wilhelm Memorial Church
52.510019,13.369893,Berlin Philharmonie
</googlemap>
</pre>

== Icons ==
:''See [http://mapki.com/wiki/Icon_Image_Sets Mapki's collection of icon images] for a several icons you can use.''
:''See [http://www.awaycity.com/wiki/Dublin/Swimming Awaycity Swimming] for an example of how to use icons.''

You can create your own collection of icons (markers) on your server.<ref>These icons have the same anchor points as Google's default icons.  For example, markerA will also be named markerA. </ref>  

;Change the Google Maps default icon
1. Add the icon address in quotes 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:
 <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

1. Name the pictures with names such as: 
:marker(letter of alphabet).png. 
:For example, markerA.png to create the "A" marker, markerC.png to create the "C" marker, markerR.png to create the "R" marker, etc

2. Upload the pictures which will serve as the icons to your server. 

3. Add the icons coding in quotes the googlemap tag, using '''icons''': 
 <nowiki><googlemap lat="53.35506" lon="-6.276283" icons="http://www.awaycity.com/images/mapfiles/marker{label}.png"></nowiki>

Full coding:
 <nowiki><googlemap lat="53.35506" lon="-6.276283" icons="http://www.awaycity.com/images/mapfiles/marker{label}.png"></nowiki>
 (B) 53.422237547104515, -6.2295109033584595, ALSAA - Aer Lingus Swimming Pool
 Membership required
 (A) 53.34089264525343, -6.357307434082031, Ballyfermot Swimming Pool (Sean Dunne)
 Membership required
 (Z) 53.325577, -6.265393, Rathmines Swimming Pool
 Closed. Expected completion date: November 2009
 (F) 53.36863302821816, -6.14659309387207, Bull Island Beach
 <nowiki></googlemap></nowiki>

=== Icons reference ===
Icons in use at this site
{| class="wikitable" style="text-align: left; border=1"
!Letter
!Icon
|----
|A
|http://tehcc.org/clubwiki/kml/markerA.png
|----
|B
|http://tehcc.org/clubwiki/kml/markerB.png
|----
|C
|http://tehcc.org/clubwiki/kml/markerC.png
|----
|D
|http://tehcc.org/clubwiki/kml/markerD.png
|----
|E
|http://tehcc.org/clubwiki/kml/markerE.png
|----
|F
|http://tehcc.org/clubwiki/kml/markerF.png
|----
|G
|http://tehcc.org/clubwiki/kml/markerG.png
|----
|H
|http://tehcc.org/clubwiki/kml/markerH.png
|----
|I
|http://tehcc.org/clubwiki/kml/markerI.png
|----
|J
|http://tehcc.org/clubwiki/kml/markerJ.png
|----
|}

== Using <nowiki><googlemap></nowiki> in a template ==

If you would like to put a map inside a [[template]], then you will need to use a slightly different coding to get the coding to work properly.

The following is an example for including a map ''without'' markers.

BAD:

 <nowiki><googlemap lat="{{{1}}}" lon="{{{2}}}"></nowiki>

GOOD:

 <nowiki>{{#tag:googlemap|lat={{{1}}} lon={{{2}}}}}</nowiki>

This <nowiki>#tag</nowiki> technique only works with MediaWiki 1.12 and later.

if the above does not work, try
<pre>
<nowiki>
{{#tag:googlemap
|lat={{{1}}}
|lon={{{2}}}
}}</nowiki>
</pre>

== KML export ==

Beginning with version 0.9.0, there is a new tag called <code>googlemapkml</code>. This allows a visitor to your wiki to export (download to their computer) all of the maps on the current page to a [http://en.wikipedia.org/wiki/Keyhole_Markup_Language KML] file by clicking a link.<ref>The contents of the tag are the contents of the link.</ref> For example:

 <nowiki><googlemapkml>Download KML</googlemapkml></nowiki>

[[File:Kml.PNG|300px|right|thumb|Pop up box asking the user to download the kml coding to their desktop. In this example, all the KML map coding from the page "Locations" will be downloaded]]
To allow readers to export (download) the KML coding from your map, use the "article" attribute, for example:

:<nowiki><googlemapkml article="Chicago">View in Google Earth</googlemapkml></nowiki>

This creates the link "View in Google Earth" 

If the user clicks the link, "View in Google Earth", it opens a download pop up box, and downloads all the maps on your Chicago page to their computer. 
{{-}}
==== KML import - export ====
Say for example, you have a wiki about a town. You have a map with theaters and a map with bus stations. You can merge these maps together, so that a visitor to your wiki can select which markers they would like to see (either from the theater map, from the bus stations map or both). 

It is possible to merge the maps of some other articles within a new article’s map, but you must use the full url of GoogleMapsKML.

:<nowiki><googlemap></nowiki>
:<nowiki>http://your.wiki.url/index.php?title=Special:GoogleMapsKML&article=a_article</nowiki>
:<nowiki>http://your.wiki.url/index.php?title=Special:GoogleMapsKML&article=another_article</nowiki>
:...
:<nowiki></googlemap></nowiki>

== Map coding version "0" (default) ==

This section describes the "old coding", which is enabled by default. To force its use, set <code>version="0"</code> in the map attributes.

=== Markers ===

In the content of the tag, you can define one marker per line. 
* Each line can optionally start with an '''icon''' name in parentheses; unless you set the "icons" attribute, icon names are the upper-case letters of the alphabet. ''example: (S)''
* the '''latitude''', then a comma, optionally a space, ''example: 42.711618,''
* then the '''longitude''', then a comma, ''example: -73.205112,''
* then the '''text for the pop up information balloon'''. The label can include wiki coding (and commas) ''example: The fabulous, famous <nowiki>[[Sawyer Library]]</nowiki>''

For example:

 <googlemap lat="42.711618" lon="-73.205112" zoom="2" controls="small">
 <nowiki>42.711618,-73.205112,the fabulous, famous [[Sawyer Library]]</nowiki>
 <nowiki>42.711618, -73.205112, the fabulous, famous [[Sawyer Library]]</nowiki>
 <nowiki>(S) 42.711618, -73.205112, the fabulous, famous [[Sawyer Library]]</nowiki>
 </googlemap>

=== Paths ===

''This feature must first be enabled on your wiki; see [[Extension:Google Maps/Installation#Colored paths]]''

To connect multiple points with a colored path, start the line with a color in RGB hex format., for example:

 <nowiki>#330000</nowiki>
 <nowiki>42.711618,-73.205112</nowiki>
 <nowiki>42.714779,-73.204544</nowiki>

This will connect the two points with a colored line. Any points not on a line should appear before all points on lines. For example:

 42.711618, -73.25112, this point is not on a line
 43.224024, -70.28301, neither is this one
 #770077
 42.202452, -72.83101, this is on a line of color #77077
 45.214425, -72.48114, so is this
 #668800
 42.201324, -70.95811, this starts a second line
 43.404142, -73.44514, this is also on the second line
 
Any text on the same line as, but appearing after, the color specification will be ignored.

You'll probably want to use the [[Extension:Google Maps/Editor's Map]] to generate this coding.

=== Areas ===

'''New in 0.8'''

Areas are enclosed paths with a colored filling. The coding is just like a path, except that the interior color should be specified in parentheses after the path color, like this:

 #770077 (#668800)

=== Tabs ===

'''New in 0.7'''

A feature new to 0.7 are tabbed info balloons. Each tab should have a plain-text title surrounded by inward-leaning slashes (like /this\) followed by a caption that can include wiki mark-up. Tabs will be attached to the previous marker. Example:

  45.214425, -72.48114
  <nowiki>/Info\       This is where Ulysses Grant is buried</nowiki>
  <nowiki>/Directions\ [http://maps.google.com Click here] to get driving directions</nowiki>

That will create a point whose info balloon has two tabs. Note that you can put as much or as little space as you'd like between the title and the caption to make the coding more readable.

If a point has a regular caption ''and'' tabbed captions, clicking the point will only show the tabbed captions.

== Map coding version "0.9" ==

Starting with release 0.9.0, a new map coding is available. It differs only slightly from version "0". To use the new coding, you will need to set <code>version="0.9"</code> in the map attributes (the Editor's Map will do this for you). Benefits include:

* Multiline captions
* Specify opacity
* Titles that appear on mouse-over

The new coding is described below.

=== KML import ===

Before you specify any markers, you can add URLs 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://some.url/</nowiki>
 <nowiki>http://other.url/</nowiki>
 ...
 <nowiki></googlemap></nowiki>

These files will be dynamically imported into the map each time the map is loaded.

=== Markers and Tabs ===
Markers can be specified in several ways:

No caption, just a point:
 42.711618, -73.205112

A marker labeled "S":
 (S) 42.711618, -73.205112

A title but no caption. The title can NOT contain wiki markup. It is displayed when a user mouses over the marker:
 42.711618, -73.205112, Sawyer Library

Title plus a caption. The caption appears when a user clicks on the marker:
 42.711618, -73.205112, Sawyer Library
 <nowiki>[[Sawyer Library]], built in 1977</nowiki>

A caption can span multiple lines. However, the title is still optional, so this is okay too:

 42.711618, -73.205112
 <nowiki>[[Sawyer Library]], built in 1977</nowiki>

Finally, you can also create tabs. A tab's title should appear between inward facing slashes(/ and \). The content of a tab should be on a new line and can span multiple lines, just like captions.

 latitude, longitude, title
 /tab1\
 caption1
 /tab2\
 caption2
 ...

=== Paths and Areas ===

You can connect multiple points  with a color line. However, in version 0.9.0., the color must now include '''opacity''' and '''width''' information, for example:

 <nowiki>6#FF330000</nowiki>


In the example above the width is 6 pixel's wide, the opacity is #FF (opaque) and the color is #330000.

The ''6'' means that the path will be 6 pixels wide. The first two hex digits specify the opacity from #00 (transparent) to #FF (opaque). The final 6 hex digits are a "web color", for example #RRGGBB. 


Similarly for areas, the interior color should be 8 digits instead of 6; the first two digits define the opacity, for example:

 6#770077 (#BB668800)
==Advanced coding==
===Create a map list===
[[File:The walking dead google maps screenshot.png|400px|right|thumb|Google map, showing text in the list is the same in the info balloon]]
Google maps creates a list of all information in the info balloons.
{{-}}
[[File:Google maps list of all items in the template.png|right|thumb|400px|Text in the list is the same as text in the info balloons in google maps, and changes as the info balloon information changes]]
With Google Maps extension, a side by side list of all maps locations and descriptions, which changes when you edit Google maps, is also possible with advanced templates. 

This list is possible with three templates:
# [http://walkingdead.wikia.com/wiki/Template:Map Map template with all information which appears in the map and list]
# [http://walkingdead.wikia.com/wiki/Template:Maptable List template which pulls the information from the map template]
# [http://walkingdead.wikia.com/wiki/Template:Markers A template which explains the rules the templates follow and the formatting]

For the coding to do this, see the edit pages of the above links, or [[Extension:Google Maps/Syntax/list]]

===Changing the size of the balloon===
To change the size of the pop-up info balloon, put the contents of the info window into a custom div.  For example:

 <nowiki><div style="min-width: 120px; min-height: 120px;"> Text for balloon </div></nowiki>
@@ Line 1: / Line 1: @@
-This wiki site uses a MediaWiki extension called Maps. It's full syntax description can be found at its [https://www.semantic-mediawiki.org/wiki/Category:Maps_examples home site]. Here we will just describe the basic features typically used for this site for simplicity for our users.
+In many cases you can get by using the [[Extension:Google Maps/Editor's Map|Editor's Map]], but understanding the underlying coding of the Google maps extension will unlock a few extra features for you.
-== Basic use ==
-The map is invoked by using the following basic structure
-<pre>
-<display_map options and KML links>
-(optional and multiple possible) pin locations
-</display_map>
-</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 (full list [https://www.semantic-mediawiki.org/wiki/Help:Google_Maps_format here]):
+Available coding options are:
-* center (location which can be coordinates or place name but place names slows page render; default is centered on all listed pins)
+* width (in pixels; default is 740)
-* width (assumes pixels by default but can also be ex, em, %; default is auto)
+* height (in pixels; default is 600)
-* height (assumes pixels by default but can also be ex, em, %; default is 350)
+* lat (the center latitude on the map)
-* zoom (the zoom level; 0 is the furthest away, 21 is the closest in; 15 is closest zoom for terrain)
+* lon (the center longitude on the map)
-* type ("terrain" or "roadmap", "hybrid", or "satellite"; default is "roadmap")
+* zoom (the zoom level; 0 is the furthest away, 21 is the closest in)
-* controls (controls to place on the map, list any/all pan, zoom, type, scale, streetview)
+* type ("normal" or "map", "hybrid", or "satellite"; default is "hybrid")
-* zoomstyle (not sure yet, but I think we want this for small vs. large maps)
+* 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)
-* typestyle (not sure yet, but I think we want this for small vs. large maps)
+* selector (show the map/hybrid/satellite selector? ''yes'' (default) and ''no''.)
-* kmlrezoom (yes/no center on drawn kmls; default is no)
+* scale (show the distance scale? ''yes'' and ''no'' (default).)
-* gkml (list URLs to kmls separated by a comma)
+* overview (show the inset navigation map? ''yes'' and ''no'' (default).)
-* markercluster (automatically groups crowded pins and zooms on click; default no)
+* 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 (Default icon to use for all markers/pins - only can apparently use an image on this site without the "File:" prefix)
+* 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. If it is not specified the above described default will be assumed.
+All attributes are optional.
-So the final code to place just a map with no other features might be:
+So the final code might be:
 <pre>
-<display_map center="Warriors Path State Park, TN" zoom="12" width="50%" height="200" type="terrain" controls="scale,type">
+<googlemap lat="52.523777" lon="13.411896" zoom="12" width="500" height="400" type="map" controls="small">
-</display_map>
+.499683,13.333907,Kaiser Wilhelm Memorial Church
+.510019,13.369893,Berlin Philharmonie
+</googlemap>
 </pre>
-<display_map center="Warriors Path State Park, TN" zoom="12" width="50%" height="200" type="terrain" controls="scale,type">
-</display_map>
-== 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 [http://en.wikipedia.org/wiki/Keyhole_Markup_Language KML] files. Each URL should be separated by a comma.
-<pre><display_map gkml="https://tehcc.org/clubwiki/kml/Pinnacle_Mountain_Tower_Trail.kml,http://other.url/,...">
-</display_map></pre>
-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.
+== Icons ==
+:''See [http://mapki.com/wiki/Icon_Image_Sets Mapki's collection of icon images] for a several icons you can use.''
+:''See [http://www.awaycity.com/wiki/Dublin/Swimming Awaycity Swimming] for an example of how to use icons.''
-== Pins ==
+You can create your own collection of icons (markers) on your server.<ref>These icons have the same anchor points as Google's default icons.  For example, markerA will also be named markerA. </ref>
-Pins are added by using the following syntax within the <nowiki><display_map></nowiki> tags. The different attributes of the pin are separated by tildes (~).
-<pre>
+;Change the Google Maps default icon
-Location~Title~Details~Icon~Visited Icon?~Label~???
+. Add the icon address in quotes the googlemap tag, using '''icon''':
-location ~ balloon title ~ balloon contents ~ Map Icon (wiki file) ~ Visited Map icon (wiki file) ~ label(shows next to pin at all times)~ something else?
+ <nowiki><googlemap lat="36.072635" lon="-79.791975" icon="http://images.wikia.com/walkingdead/images/7/70/Markerfight.png"></nowiki>
-</pre>
-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:
+Full coding:
-<pre>
+ <nowiki><googlemap lat="36.072635" lon="-79.791975" icon="http://images.wikia.com/walkingdead/images/7/70/Markerfight.png"></nowiki>
-<display_map center="36.500667,-82.47797" type="terrain" zoom="15" width="715" height="350">
+.453857, -84.356461, Rick Grimes Shot
-.50013,-82.47760~[[WPSP Sinking Waters|Sinking Waters]]~Here is the location of the trail head~MarkerA.png~ ~This is where Putin Works
+ <nowiki></googlemap></nowiki>
-.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>
-</pre>
-<display_map center="36.500667,-82.47797" type="terrain" zoom="15" width="715" height="350">
+;Custom icons
-.50013,-82.47760~[[WPSP Sinking Waters|Sinking Waters]]~Here is the location of the trail head~MarkerA.png~ ~This is where Putin Works
-.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>
-The above commands can be used many times within a single map to create the pins needed.
+. Name the pictures with names such as:
+:marker(letter of alphabet).png.
+:For example, markerA.png to create the "A" marker, markerC.png to create the "C" marker, markerR.png to create the "R" marker, etc
-== Pin icons ==
+. Upload the pictures which will serve as the icons to your server.
-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 ===
+. Add the icons coding in quotes the googlemap tag, using '''icons''':
-The default icon used for pins can be changed by adding an icon command in the extension options:
+ <nowiki><googlemap lat="53.35506" lon="-6.276283" icons="http://www.awaycity.com/images/mapfiles/marker{label}.png"></nowiki>
-Add the icon address in quotes to the displat_map tag, using '''icon''':
+Full coding:
-<pre><display_map icon=MarkerG.png>
+ <nowiki><googlemap lat="53.35506" lon="-6.276283" icons="http://www.awaycity.com/images/mapfiles/marker{label}.png"></nowiki>
-.453857,-84.356461~Rick Grimes Shot
+ (B) 53.422237547104515, -6.2295109033584595, ALSAA - Aer Lingus Swimming Pool
-.462857,-84.365461~Rick Grimes Shot
+ Membership required
-.444857,-84.347461~Rick Grimes Shot
+ (A) 53.34089264525343, -6.357307434082031, Ballyfermot Swimming Pool (Sean Dunne)
-</display_map></pre>
+ Membership required
+ (Z) 53.325577, -6.265393, Rathmines Swimming Pool
+ Closed. Expected completion date: November 2009
+ (F) 53.36863302821816, -6.14659309387207, Bull Island Beach
+ <nowiki></googlemap></nowiki>
-<display_map icon=MarkerG.png>
+=== Icons reference ===
-.453857,-84.356461~Rick Grimes Shot
-.462857,-84.365461~Rick Grimes Shot
-.444857,-84.347461~Rick Grimes Shot
-</display_map>
-=== 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:
-<pre>
-<display_map width="auto" height="350">
-.50013,-82.47760~Fall Creek Falls~[[Image:WPSP Fall Creek Falls.jpg|150px|Fall Creek Falls]]~MarkerE.png
-.502632,-82.482759~Parking along Fall Creek Road~ ~MarkerA.png
-.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>
-</pre>
-<display_map width="auto" height="350">
-.50013,-82.47760~Fall Creek Falls~[[Image:WPSP Fall Creek Falls.jpg|150px|Fall Creek Falls]]~MarkerE.png
-.502632,-82.482759~Parking along Fall Creek Road~ ~MarkerA.png
-.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>
-==== Icons reference ====
 Icons in use at this site
 {| class="wikitable" style="text-align: left; border=1"
-!Filename
+!Letter
 !Icon
-!Meaning
-!Name used in icon lists
-|----
-|MarkerA.png
-|[[File:MarkerA.png]]
-|Parking
-|Parking
-|----
-|MarkerB.png
-|[[File:MarkerB.png]]
-|Picturesque location
-|Photo spot
-|----
-|MarkerC.png
-|[[File:MarkerC.png]]
-|Waterfall
-|Waterfall
-|----
-|MarkerD.png
-|[[File:MarkerD.png]]
-|Alternate for picturesque
-|Other photo spot
-|----
-|MarkerE.png
-|[[File:MarkerE.png]]
-|Overlook
-|Overlook
-|----
-|MarkerF.png
-|[[File:MarkerF.png]]
-|Shelter
-|Shelter
-|----
-|MarkerG.png
-|[[File:MarkerG.png]]
-|Trailhead/intersection/point of interest
-|Point of interest
-|----
-|MarkerH.png
-|[[File:MarkerH.png]]
-|Campground
-|Campground
-|----
-|MarkerI.png
-|[[File:MarkerI.png]]
-|Cave
-|Cave
-|----
-|MarkerJ.png
-|[[File:MarkerJ.png]]
-|Water crossing - no bridge - rock-hopping
-|Water crossing
-|----
-|MarkerK.png
-|[[File:MarkerK.png]]
-|Bench
-|Bench
-|----
-|MarkerL.png
-|[[File:MarkerL.png]]
-|Trail bridge
-|Trail bridge
-|----
-|MarkerM.png
-|[[File:MarkerM.png]]
-|Cell Tower/Antenna
-|Comm tower
-|----
-|MarkerN.png
-|[[File:MarkerN.png]]
-|Cemetery
-|Cemetery
-|----
-|MarkerO.png
-|[[File:MarkerO.png]]
-|Playground
-|Playground
-|----
-|MarkerP.png
-|[[File:MarkerP.png]]
-|Summit Marker
-|Summit
-|----
-|MarkerQ.png
-|[[File:MarkerQ.png]]
-|Toilet
-|Toilet
-|----
-|MarkerR.png
-|[[File:MarkerR.png]]
-|Tunnel
-|Tunnel
-|----
-|MarkerS.png
-|[[File:MarkerS.png]]
-|Picnic Area
-|Picnic spot
-|----
-|MarkerT.png
-|[[File:MarkerT.png]]
-|Trail intersection signpost
-|Trail sign
 |----
-|MarkerU.png
+|A
-|[[File:MarkerU.png]]
+|http://tehcc.org/clubwiki/kml/markerA.png
-|Trail road crossing
-|Road crossing
 |----
-|MarkerV.png
+|B
-|[[File:MarkerV.png]]
+|http://tehcc.org/clubwiki/kml/markerB.png
-|Old abandoned structure or foundation
-|Old structure
 |----
-|MarkerW.png
+|C
-|[[File:MarkerW.png]]
+|http://tehcc.org/clubwiki/kml/markerC.png
-|Horseback riding
-|Horseback
 |----
-|MarkerX.png
+|D
-|[[File:MarkerX.png]]
+|http://tehcc.org/clubwiki/kml/markerD.png
-|Alien capsule(?!)
-|Alien landing
 |----
-|MarkerY.png
+|E
-|[[File:MarkerY.png]]
+|http://tehcc.org/clubwiki/kml/markerE.png
-|Rest spot
-|Rest
 |----
-|Marker1.png
+|F
-|[[File:Marker1.png]]
+|http://tehcc.org/clubwiki/kml/markerF.png
-|Skiing
-|Skiing
 |----
-|Marker2.png
+|G
-|[[File:Marker2.png]]
+|http://tehcc.org/clubwiki/kml/markerG.png
-|Tower (fire tower - It was the best that could be found)
-|Tower
 |----
-|powerline.png
+|H
-|[[File:powerline.png]]
+|http://tehcc.org/clubwiki/kml/markerH.png
-|Power Line
-|Power line
 |----
-|treedown.png
+|I
-|[[File:treedown.png]]
+|http://tehcc.org/clubwiki/kml/markerI.png
-|Blowdowns on trail
-|Blowdown
 |----
-|Rangerstation.png
+|J
-|[[File:Rangerstation.png]]
+|http://tehcc.org/clubwiki/kml/markerJ.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 ==
+== Using <nowiki><googlemap></nowiki> in a template ==
-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
+If you would like to put a map inside a [[template]], then you will need to use a slightly different coding to get the coding to work properly.
-*[[WPSP Devil's Backbone|Devil's Backbone]] - Multiple KML files and many pins showing pictures and more
+The following is an example for including a map ''without'' markers.
+BAD:
+ <nowiki><googlemap lat="{{{1}}}" lon="{{{2}}}"></nowiki>
+GOOD:
+ <nowiki>{{#tag:googlemap|lat={{{1}}} lon={{{2}}}}}</nowiki>
+This <nowiki>#tag</nowiki> technique only works with MediaWiki 1.12 and later.
+if the above does not work, try
+<pre>
+<nowiki>
+{{#tag:googlemap
+|lat={{{1}}}
+|lon={{{2}}}
+}}</nowiki>
+</pre>
+== KML export ==
+Beginning with version 0.9.0, there is a new tag called <code>googlemapkml</code>. This allows a visitor to your wiki to export (download to their computer) all of the maps on the current page to a [http://en.wikipedia.org/wiki/Keyhole_Markup_Language KML] file by clicking a link.<ref>The contents of the tag are the contents of the link.</ref> For example:
+ <nowiki><googlemapkml>Download KML</googlemapkml></nowiki>
+[[File:Kml.PNG|300px|right|thumb|Pop up box asking the user to download the kml coding to their desktop. In this example, all the KML map coding from the page "Locations" will be downloaded]]
+To allow readers to export (download) the KML coding from your map, use the "article" attribute, for example:
+:<nowiki><googlemapkml article="Chicago">View in Google Earth</googlemapkml></nowiki>
+This creates the link "View in Google Earth"
+If the user clicks the link, "View in Google Earth", it opens a download pop up box, and downloads all the maps on your Chicago page to their computer.
+{{-}}
+==== KML import - export ====
+Say for example, you have a wiki about a town. You have a map with theaters and a map with bus stations. You can merge these maps together, so that a visitor to your wiki can select which markers they would like to see (either from the theater map, from the bus stations map or both).
+It is possible to merge the maps of some other articles within a new article’s map, but you must use the full url of GoogleMapsKML.
+:<nowiki><googlemap></nowiki>
+:<nowiki>http://your.wiki.url/index.php?title=Special:GoogleMapsKML&article=a_article</nowiki>
+:<nowiki>http://your.wiki.url/index.php?title=Special:GoogleMapsKML&article=another_article</nowiki>
+:...
+:<nowiki></googlemap></nowiki>
+== Map coding version "0" (default) ==
+This section describes the "old coding", which is enabled by default. To force its use, set <code>version="0"</code> in the map attributes.
+=== Markers ===
+In the content of the tag, you can define one marker per line.
+* Each line can optionally start with an '''icon''' name in parentheses; unless you set the "icons" attribute, icon names are the upper-case letters of the alphabet. ''example: (S)''
+* the '''latitude''', then a comma, optionally a space, ''example: 42.711618,''
+* then the '''longitude''', then a comma, ''example: -73.205112,''
+* then the '''text for the pop up information balloon'''. The label can include wiki coding (and commas) ''example: The fabulous, famous <nowiki>[[Sawyer Library]]</nowiki>''
+For example:
+ <googlemap lat="42.711618" lon="-73.205112" zoom="2" controls="small">
+ <nowiki>42.711618,-73.205112,the fabulous, famous [[Sawyer Library]]</nowiki>
+ <nowiki>42.711618, -73.205112, the fabulous, famous [[Sawyer Library]]</nowiki>
+ <nowiki>(S) 42.711618, -73.205112, the fabulous, famous [[Sawyer Library]]</nowiki>
+ </googlemap>
+=== Paths ===
+''This feature must first be enabled on your wiki; see [[Extension:Google Maps/Installation#Colored paths]]''
+To connect multiple points with a colored path, start the line with a color in RGB hex format., for example:
+ <nowiki>#330000</nowiki>
+ <nowiki>42.711618,-73.205112</nowiki>
+ <nowiki>42.714779,-73.204544</nowiki>
+This will connect the two points with a colored line. Any points not on a line should appear before all points on lines. For example:
+.711618, -73.25112, this point is not on a line
+.224024, -70.28301, neither is this one
+ #770077
+.202452, -72.83101, this is on a line of color #77077
+.214425, -72.48114, so is this
+ #668800
+.201324, -70.95811, this starts a second line
+.404142, -73.44514, this is also on the second line
+Any text on the same line as, but appearing after, the color specification will be ignored.
+You'll probably want to use the [[Extension:Google Maps/Editor's Map]] to generate this coding.
+=== Areas ===
+'''New in 0.8'''
+Areas are enclosed paths with a colored filling. The coding is just like a path, except that the interior color should be specified in parentheses after the path color, like this:
+ #770077 (#668800)
+=== Tabs ===
+'''New in 0.7'''
+A feature new to 0.7 are tabbed info balloons. Each tab should have a plain-text title surrounded by inward-leaning slashes (like /this\) followed by a caption that can include wiki mark-up. Tabs will be attached to the previous marker. Example:
+.214425, -72.48114
+  <nowiki>/Info\       This is where Ulysses Grant is buried</nowiki>
+  <nowiki>/Directions\ [http://maps.google.com Click here] to get driving directions</nowiki>
+That will create a point whose info balloon has two tabs. Note that you can put as much or as little space as you'd like between the title and the caption to make the coding more readable.
+If a point has a regular caption ''and'' tabbed captions, clicking the point will only show the tabbed captions.
+== Map coding version "0.9" ==
+Starting with release 0.9.0, a new map coding is available. It differs only slightly from version "0". To use the new coding, you will need to set <code>version="0.9"</code> in the map attributes (the Editor's Map will do this for you). Benefits include:
+* Multiline captions
+* Specify opacity
+* Titles that appear on mouse-over
+The new coding is described below.
+=== KML import ===
+Before you specify any markers, you can add URLs 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://some.url/</nowiki>
+ <nowiki>http://other.url/</nowiki>
+ ...
+ <nowiki></googlemap></nowiki>
+These files will be dynamically imported into the map each time the map is loaded.
+=== Markers and Tabs ===
+Markers can be specified in several ways:
+No caption, just a point:
+.711618, -73.205112
+A marker labeled "S":
+ (S) 42.711618, -73.205112
+A title but no caption. The title can NOT contain wiki markup. It is displayed when a user mouses over the marker:
+.711618, -73.205112, Sawyer Library
+Title plus a caption. The caption appears when a user clicks on the marker:
+.711618, -73.205112, Sawyer Library
+ <nowiki>[[Sawyer Library]], built in 1977</nowiki>
+A caption can span multiple lines. However, the title is still optional, so this is okay too:
+.711618, -73.205112
+ <nowiki>[[Sawyer Library]], built in 1977</nowiki>
+Finally, you can also create tabs. A tab's title should appear between inward facing slashes(/ and \). The content of a tab should be on a new line and can span multiple lines, just like captions.
+ latitude, longitude, title
+ /tab1\
+ caption1
+ /tab2\
+ caption2
+ ...
+=== Paths and Areas ===
+You can connect multiple points  with a color line. However, in version 0.9.0., the color must now include '''opacity''' and '''width''' information, for example:
+ <nowiki>6#FF330000</nowiki>
+In the example above the width is 6 pixel's wide, the opacity is #FF (opaque) and the color is #330000.
+The ''6'' means that the path will be 6 pixels wide. The first two hex digits specify the opacity from #00 (transparent) to #FF (opaque). The final 6 hex digits are a "web color", for example #RRGGBB.
+Similarly for areas, the interior color should be 8 digits instead of 6; the first two digits define the opacity, for example:
+#770077 (#BB668800)
+==Advanced coding==
+===Create a map list===
+[[File:The walking dead google maps screenshot.png|400px|right|thumb|Google map, showing text in the list is the same in the info balloon]]
+Google maps creates a list of all information in the info balloons.
+{{-}}
+[[File:Google maps list of all items in the template.png|right|thumb|400px|Text in the list is the same as text in the info balloons in google maps, and changes as the info balloon information changes]]
+With Google Maps extension, a side by side list of all maps locations and descriptions, which changes when you edit Google maps, is also possible with advanced templates.
+This list is possible with three templates:
+# [http://walkingdead.wikia.com/wiki/Template:Map Map template with all information which appears in the map and list]
+# [http://walkingdead.wikia.com/wiki/Template:Maptable List template which pulls the information from the map template]
+# [http://walkingdead.wikia.com/wiki/Template:Markers A template which explains the rules the templates follow and the formatting]
+For the coding to do this, see the edit pages of the above links, or [[Extension:Google Maps/Syntax/list]]
+===Changing the size of the balloon===
+To change the size of the pop-up info balloon, put the contents of the info window into a custom div.  For example:
-== Unexplored Features ==
+ <nowiki><div style="min-width: 120px; min-height: 120px;"> Text for balloon </div></nowiki>
-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 [http://semantic-mediawiki.org/wiki/Maps_examples/Google_Maps_shapes here]
-* Polygons on hover over a defined area - information [http://semantic-mediawiki.org/wiki/Maps_examples/Google_Maps_polygons_on_hover here]
-* Searching within markers (although their examples don't seem to work - information [http://semantic-mediawiki.org/wiki/Maps_examples/Google_Maps_searchmarkers here]
-* Fusion tables(???)
-* [[Special:MapEditor|Map Editor]] to create lines, polygons, pin placements, etc.
-* Dynamic tables and maps by searching created pages - See example [https://wiki.hackerspaces.org/Category:Pages_with_a_map_rendered_by_the_Maps_extension 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)