=== XML Google Maps ===
Contributors: dschuesae
Tags: google maps, google, maps, gpx, kml, kmz, tracks, routes
Requires at least: 2.1
Tested up to: 2.5
Stable tag: 1.4
Donate link: http://www.matusz.ch/donate_xmlgooglemapswpplugin.htm

This plugin allows you to easily insert Google Maps into your blog.

== Description ==
This plugin allows you to easily insert Google Maps into your blog. You just have to add a link to your self defined Map from My Google Maps or your uploaded Google Earth (kmz, kml) file. Even if you have a GPX-File from your GPS, upload it, link it and it get displayed. For GPX-Tracks you can even display speed and elevation charts (Google Charts API) and a data table with checkpoints.

It's easy - try it! 

<a href="http://www.matusz.ch/blog/projekte/xml-google-maps-wordpress-plugin/" target="_blank">Deutsche Anleitung</a>!

To extend or correct the map there are some parameters too:<br>
Include Parameters within the &lt;a&gt; and &lt;/a&gt; tag (&lt;a href=&quot;gpx, kml or kmz url&quot;&gt;Title [Parameters]&lt;/a&gt;) and make sure that the whole url is on the same line.
<ul>
<li>maptype: Defines view type of Google Maps &gt; (G_HYBRID_MAP, G_SATELLITE_MAP, G_NORMAL_MAP, G_PHYSICAL_MAP)</li>
<li>maxlat, maxlon, minlat, minlon: Manually set center and zoom of your world View</li>
<li>urldisplaymode: none (no link), showvars (include parameters), title (default)</li>
<li>width, height: dimension of a single map can be changed</li>
<li>zoom: Zoom Value of Google Maps to override the default or calculated zoom level (max. is around 20)</li>
<li>deltazoom: Adds or subtracts zoom level to calculated or default zoom level! (Only works for maps without parameter "zoom")</li>
<li>panzoomcontrol: large, small, zoom, hide</li>
<li>overviewmapcontrol: hide, show</li>
<li>scalecontrol: hide, show</li>
<li>maptypecontrol: hide, show (Normal Buttons), hierarchical (Hierarchical Buttons and Checkboxes)</li>
<li>align: left, center, right</li>
<li>mapnormal, maphybrid, mapsat, mapphysical: Shows or Hides the specific Map Type Control Button</li>
<li>dragging: enabled, disabled</li>
<li>googlebar: enabled, disabled</li>
<li>continuouszoom: enabled, disabled</li>
<li>doubleclickzoom: enabled, disabled</li>
<li>scrollwheelzoom: enabled, disabled</li>
<li>gpxinterval: Shows only every xth Track- or Routepoint</li>
<li>gpxcolor: Color of GPX Tracks and Routes!</li>
<li>gpxlinewidth: Width of GPX Tracks and Routes!</li>
<li>gpxlineopacity: Opacity of GPX Tracks and Routes!</li>
<li>gpxview: all, trk (tracks only), rte (routes only), wpt (waypoints only)</li>
<li>gpxelevation: show (only works for gpx tracks with elevation information), hide</li>
<li>gpxelevationcolor: line color of elevation chart</li>
<li>gpxelevationlinewidth: line width of elevation chart</li>
<li>gpxelevationheight: height of elevation chart</li>
<li>measurement: metric or imperial</li>
<li>speedscale: level1 (m/s or fps) / level2 (km/h or mph)</li>
<li>gpxspeedchart: show (only works for gpx tracks with elevation information), hide</li>
<li>gpxspeedchartcolor: line color of speed chart</li>
<li>gpxspeedchartlinewidth: line width of speed chart</li>
<li>gpxspeedchartheight: height of speed chart</li>
<li>gpxcheckpointinterval: to set automatically checkpoints after x miles or kilometres on tracks (supported by checkpoint table, elevation charts and speed charts)</li>
<li>gpxcheckpointmarkercolor: red / green / yellow / blue</li>
<li>gpxcheckpointtable: show / hide</li>
</ul>

Examples:
<ul>
<li><a href="http://www.matusz.ch/blog/2007/08/30/ferien-bretagne-und-vendee-2-tag/" target="_blank">GPX File with Parameters</a></li>
<li><a href="http://www.matusz.ch/blog/2007/04/11/skating-auf-der-thuner-allmend/" target="_blank">KML File</a></li>
<li><a href="http://www.matusz.ch/blog/projekte/xml-google-maps-wordpress-plugin/beispiele/" target="_blank">More Samples...</a></li>
</ul>

== Installation ==
<ul>
<li>Download the Plugin ZIP File</li>
<li>Upload the Folder xml-google-maps to your wordpress plugin folder</li>
<li>Activate the plugin</li>
<li>Create a Google Maps API Key <a href="http://www.google.com/apis/maps/signup.html" target="_blank">here</a></li>
<li>Enter the Google Key in the Option Pane</li>
<li>Set the size of your Google Map in the Option Pane</li>
<li>Developed a better algo for resolving the url to a local path (GPX and KML parsing).</li>
</ul>

For Updates:
<ul>
<li>Deactivate the plugin!</li>
<li>Continue with the installation steps!</li>
</ul>

== Frequently Asked Questions ==
= Link don't get converted to map =
The whole a-Tag has to be on the same line in HTML Source

= Cannot change visibilty of one Map Type Control Button =
If you set this button to your default view, then this button has to be visible. But you can hide the whole Map Type Control in the top right corner.

== Screenshots ==
1. Normal Map
2. KML map marker with image
3. Sample of GPX File with Elevation Graph 
4. Supports Google Bar in the bottom left Corner and Hierarchical Map Type Buttons on the top right corner
5. Use of checkpoints and the data table
6. Use of the speed profile chart

== Changes ==
Version 1.4
<ul>
<li>Removed debug information from map (sometimes they get displayed - no idea why...)</li>
<li>Added Quick Navigation Links on Admin Page</li>
<li>Added Speed Chart to show the Speed Profile of a GPX Track (including new parameter: gpxspeedchartcolor, gpxspeedchart, gpxspeedchartlinewidth, gpxspeedchartheight)</li>
<li>Support of Chart Title for Elevation Chart and Speed Chart</li> 
<li>Improvement of displaying Charts and Auto-Scale</li>
<li>New Parameter: speedscale (level1 ms or fps / level2 kmh or mph)</li>
<li>Changed Parameter: gpxelevationmeasurement to measurement</li>
<li>New Parameter: gpxcheckpointinterval to set automatically checkpoints after x miles or kilometres (supported by checkpoint table, elevation charts and speed charts)</li>
<li>New Parameter: gpxcheckpointmarkercolor (red / green / yellow / blue) for setting the color of the checkpoint marker on the map</li>
<li>New Parameter: gpxcheckpointtable (show / hide) for showing a checkpoint data table</li>
<li>By setting the gpxcheckpointinterval-parameter checkpoints will be displayed automatically as markers on maps and as vertical lines on charts</li>
<li>Support of displaying a checkpoint table (distance, time, speed)</li>
</ul>

Version 1.3
<ul>
<li>Also supports a-tags with single quoted attributes now</li>
<li>New algorithm for GPX Polyline encoding</li>
<li>Shows XML Google Maps WP Plugin Banner on Map</li>
<li>Supports new Map Type Physical</li>
<li>New Parameters to change the MapType Control Buttons: mapnormal, maphybrid, mapsat, mapphysical (show, hide)</li>
<li>Support added for the new Hierarchical Map Type Control. Set parameter overviewmapcontrol to hierarchical</li>
<li>New parameters (enabled/disabled) for customize the map behaviour: dragging, googlebar, continuouszoom, doubleclickzoom, scrollwheelzoom</li>
</ul>

Version 1.2.4
<ul>
<li>GPX Elevation line color names didn't work (green, red, ...). The plugin now converts the known html color names into hex.</li>
</ul>

Version 1.2.3
<ul>
<li>Changed algorithm to get local path of a gpx file</li>
</ul>

Version 1.2.2
<ul>
<li>Changed admin pages for new Wordpress Admin Styles</li>
</ul>

Version 1.2.1
<ul>
<li>Tested for Wordpress 2.5</li>
</ul>

Version 1.2
<ul>
<li>The plugin does now validate for XHTML 1.0 Transitional (thx to fishtoes2000)</li>
<li>Link to a on My Google Maps created map now also works with domains other than google.com (examples: google.de, google.ch, ... - thx to marius).</li>
<li>Did not free xml parser and so did not accept more than one gpx file on the same page!</li>
<li>Solved problem with the apos sign in the gpx comment, description or name tag</li>
<li>New property 'CSS Style for GPX Waypoints' added in the settings section of the plugin!</li>
</ul>

Version 1.1
<ul>
<li>New Parameter: gpxelevationmeasurement: metric/imperial</li>
<li>Improvements in displaying the chart</li>
<li>Bug with missing description for GPX Waypoints in map fixed!</li>
<li>New Parameter: zoom to ovveride the default or calculated zoomlevel</li>
<li>New Parameter: deltazoom to add or subtract zoom level to calculated or default zoom level! (Only works for maps without parameter "zoom")</li>
<li>Set property frameborder=0 to iframe. IE now shows the iframe without any frame!</li>
<li>Changed required_once(<file>) to required_once(dirname(__FILE__).<file>)</li>
</ul>

Version 1.0
<ul>
<li>New feature: Reads elevation information from the gpx tracks and displays the data in a chart!</li>
<li>New Parameter: gpxelevation: show( only works for gpx tracks with elevation information), hide</li>
<li>New Parameter: gpxelevationcolor: line color of elevation chart</li>
<li>New Parameter: gpxelevationlinewidth: line width of elevation chart</li>
<li>New Parameter: gpxelevationheight: height of elevation chart</li>
<li>Bug with parameter value showvars=title fixed.</li>
<li>Bug with Google Maps URL with encoded ampersand '&' -> '&amp;' in it fixed (Wordpress replaces every '&' to '&amp;' during saving a post).</li>
</ul>

Version 0.8
<ul>
<li>Using Maps without Links possible with: [xmlgm &lt;parameters&gt;]</li>
</ul>

Version 0.7
<ul>
<li>KML Files loading problem (script duration) solved!</li>
<li>Marker from GPX Files won't show</li>
<li>New Parameters: width and height for single map dimensions</li>
<li>KML only correctly loaded with MapType G_MAP_TYPE, now delayed loading of other MapTypes!</li>
<li>Support for KMZ Files added!</li>
<li>New Parameter: panzoomcontrol for defining the left top pan/zoom control!</li>
<li>New Parameter: overviewmapcontrol for showing a small overview map of the region!</li>
<li>New Parameter: scalecontrol for showing a Scale Control!</li>
<li>New Parameter: maptypecontrol for showing the Map Type Selection Buttons!</li>
<li>New Parameter: align for aligning the IFrame</li>
</ul>

Version 0.6
<ul>
<li>Default values for parameters can be set on the Option Pane</li>
<li>The plugin now uses Encoded Polylines for faster loading and smaller files</li>
<li>Changed Google Maps API Version from 2.x to 2 (stable)</li>
</ul>

Version 0.5
<ul>
<li>Option Pane for Google Maps API Key and Dimension of the showing Google Maps</li>
<li>GPX and KML files don&apos;t need to be added to wp_check_filetypes anymore</li>
</ul>

Version 0.4
<ul>
<li>Internet Explorer didn&apos;t show Overlay&apos;s</li>
<li>Performance optimazation for Polylines with man points</li>
</ul>

Version 0.3
<ul>
<li>Use of Parameters: maptype, gpxinterval, gpxcolor, gpxlinewidth, gpxlineopacity, gpxview, maxlat, maxlon, minlat, minlon and urldisplaymode</li>
<li>"My Maps - KML"-Links also get converted</li>
<li>Georg&apos;s Solution for show.php</li>
<li>Tracks and Routes get displayed</li>
</ul>

Version 0.2
<ul>
<li>Some minor bugs</li>
</ul>