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

This plugin allows you to easily insert Google Map or Google Earth Plugin Maps into your blog. Supports KML, KMZ, GPX, geoRSS filelinks. Supports Dfeault, Satellite, Hybrid, Physical and Google Earth Plugin Maptypes

== Description ==
This plugin allows you to easily insert Google Map or Google Earth Plugin Maps into your blog. You just have to add a link to your self defined Map from My Google Maps, Picasa Webalbum Picture Map, any geoRSS Feed (like Flickr) 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. This plugin supports the Google Earth Plugin maptypes. 

It's easy - try it! 

<b>Usage:</b>
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. 
For geoRSS and dynamic KML links use [xmlgm {http://www.test.com/dynamic.php?output=kml} Parameters]. Examples you will find in the FAQ section!
<ul>
<li>maptype: Defines view type of Google Maps &gt; (G_HYBRID_MAP, G_SATELLITE_MAP, G_NORMAL_MAP, G_PHYSICAL_MAP, G_SATELLITE_3D_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), nomap (disable the plugin for this link)</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, mapearth: 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>

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

== 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 ==
FAQ's you will find <a href="http://translate.google.ch/translate?u=http%3A%2F%2Fwww.matusz.ch%2Fblog%2Fprojekte%2Fxml-google-maps-wordpress-plugin%2Ffaq%2F&sl=de&tl=en&hl=de&ie=UTF-8">here</a>! This page is autotranslated from german to english!
Examples you will find <a href="http://translate.google.ch/translate?u=http%3A%2F%2Fwww.matusz.ch%2Fblog%2Fprojekte%2Fxml-google-maps-wordpress-plugin%2Fbeispiele%2F&sl=de&tl=en&hl=de&ie=UTF-8">here</a>! This page is autotranslated from german to english!

== 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
7. Use of Google Earth Plugin in Google Maps
8. Picasa Webalbum Integration
9. Flickr geoRSS Feed

== Changes ==
Version 1.7
<ul>
<li>Enumeration displayurlmode supports &apos;nomap&apos; for disabling the specified URL.</li>
<li>xmlgm supports now other links that are supported from the Google Maps API GeoXML Object - simply use it with [xmlgm {http://www.test.com/dynamic.php?output=kml} maptype=G_NORMAL_MAP]!</li>
</ul> 

Version 1.6
<ul>
<li>The XML Google Maps Plugin supports now even Picasa-KML links in your post to be converted into a google map!</li>
<li>Help for wrong My Google Maps link added. Now supports 'link to this page' to if a map has been saved (and the google earth link will be shown)!</li>
</ul>

Version 1.5
<ul>
<li>Added support to use the Google Earth Plugin in the Google Maps. New Parameter added: mapearth (show, hide) and extended value for parameter maptype with G_SATELLITE_3D_MAP</li>
</ul>

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>