====== Google Map3 Plugin ======

---- plugin ----
description: Allow displays a Google map on wiki page 
author     : Oleg Borodin
email      : onborodin@gmail.com
type       : syntax
lastupdate : 2011-05-21
compatible : 2009-12-25c, 2010-11-07, 2011-05-26, Lemmings, Anteater, Rincewind, Angua
depends    : 
conflicts  : 
similar    : googlemaps
tags       : media, maps, google, embed
securitywarning: allowsscript

downloadurl: https://github.com/onborodin/googlemap3/zipball/master
bugtracker : https://github.com/onborodin/googlemap3/issues
sourcerepo : https://github.com/onborodin/googlemap3
donationurl: 

screenshot_img: 
----

===== Installation =====

  * Search and install the plugin using the [[plugin:extension|Extension Manager]]. 
  * Or download using the [[https://www.unix7.org/_media/ict/googlemap/googlemap3.tar.gz|following URL]] and unpack in plugin directory. Refer to [[:Plugins]] on how to install plugins manually.

===== Description ======

This plug-in rebuild [[plugin:googlemaps|googlemaps plugin]] of [[chris@jalakai.co.ukrewritten|Christopher Smith]] to use new GoogleMap javascript API v3.

New:
  * Not needed Google Map API Key
  * Has a helper, showing the coordinates of the selected point & center map
  * Separate small signature & wiki-description of marker
  * Asynchronous loading of Google java script 

  * New Googlemap API v.3 can be more fastest work what v.2
  * You can use one mouse click on map for moving

Plugin homepage: https://www.unix7.org/ict/googlemaps

===== Syntax =====

Syntax little differently than in [[plugin:googlemaps|googlemaps plugin]]:

<code html>
<googlemap3 width="number" height="number" lat="number" lng="number">
latitude, longtitude, short signature; long desctiption
latitude, longtitude, short signature; long desctiption with {{:some:image.jpg?300|with image}} and [[:page:link| link to page]]
latitude, longtitude, short signature without longdescription;
latitude, longtitude,;longdescription without signature 
</googlemap3>
</code>

Long description for marker you must write in **one** string, without line break.

Use a semicolon as separator is dictated by the desire to use a comma in the signatures, for example, //"Anchho Mountain, height 2696m."//

You can disable the coordinates helper:
<code html>
<googlemap3 width="number" height="number" helper="off" >
</code>

By default it is enabled.

===== Configuration and Settings =====

=== Parameters ===

Changes from [[plugin:googlemaps|prevention googlemaps plugin]] marked bold.

  * width --- //999[css length unit*]// (e.g. 500px, 50%) width of the Google map, default is "400px".
  * height --- //999[css length unit*]// (e.g. 500px, 30em) height of the Google map, default is "300px".
  * type --- values: map | normal | hybrid | satellite | **terrain**,  default map (normal).
  * lat --- values: -90.0 - 90.0; latitude of map centre, negative values are south.
  * **lng** --- values: -180.0 - 180.0; longitude of map centre, negative values are west.
  * zoom --- integer, zoom level, default value 8.  Valid values depend on the map and location.
  * controls --- values on | off. default on.  Whether or not to show controls for zooming and panning on the map.
  * kml --- values: off | [URL of kml file].
  * **helper** --- values on | off

=== Config URL ===

Default URL for downloading javascrypt API is <code>http://maps.google.com/maps/api/js?sensor=false</code>
You may use concrete version API & enable sensor if you have it in target browser <code>http://maps.google.com/maps/api/js?v=3.3&sensor=true</code>

For more information see [[http://code.google.com/intl/ru/apis/maps/documentation/javascript/basics.html#Versioning|Google Maps Javascript API V3 Basics]]

=== Known Bugs and Issues ===

  * No google map appears on my page.

== Does not work on IE7 ==

I'm running dokuwiki 'Adora Belle' (fresh default install). The map shows up in Firefox but not in IE7. The page status bar says 'Done, but with errors on page'. Details says 'Error: array 'googleMapArray' is undefined'

===== Discussion =====

Hello, can you please insert a Sample to test the installation? In my case only a line is shown :-(
Me either...
----

FIXME A malicious content editor can inject javascript into the page even if $conf['htmlok'] is false (details emailed to Borodin/Chris 6th Jul 2013) - symcbean, 12 Jul 2013