= Inserts a dynamic Google Map into wiki pages =

== Description ==

This macro lets the user insert a full dynamic [http://maps.google.com/ Google Map]. Because a lot of javascript is used (by Google) a [http://local.google.com/support/bin/answer.py?answer=16532&topic=1499 Google Map compatible browser] is needed. Newer version of Firefox and MS Internet Explorer are compatible.

For javascript-less static maps use the similar GoogleStaticMapMacro.

'''Please note that this is an alpha version which still lacks a lot of functionality.'''

Multiple Google Maps on the same wiki page are actively supported but are more likely to cause trouble. 

== Bugs/Feature Requests == 

Existing bugs and feature requests for GoogleMapMacro are 
[report:9?COMPONENT=GoogleMapMacro here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=GoogleMapMacro&owner=martin_s new ticket].

== Download ==

Download the zipped source from [download:googlemapmacro here].

== Source ==

You can check out GoogleMapMacro from [http://trac-hacks.org/svn/googlemapmacro/0.11 here] using Subversion, or [source:googlemapmacro/0.11 browse the source] with Trac.

There is a develop version which can be unstable: [http://trac-hacks.org/svn/googlemapmacro/dev/0.11 check-out] | [source:googlemapmacro/dev/0.11 browse]


== Installation & Configuration ==

Just copy the [http://trac-hacks.org/browser/googlemapmacro/0.11/googlemap.py?format=raw python file] in the `plugin` directory of your trac installation.

A different Google Map API key is needed for every web domain which can be [http://code.google.com/apis/maps/signup.html get for free from Google].

To enable the macro put the following into your `trac.ini` file, which is located in the `config` directory of your trac installation.
You need to restart trac to reread the macro file and the configuration file.

{{{
[components]
googlemap.* = enabled

[googlemap]
api_key = <Your Google API key (long hex number)>
}}}


== Example ==

=== Using geographic coordinates ===
Please use a colon, not a comma, as separator for the coordinates.
{{{
[[GoogleMap(center=50.0:10.0,zoom=10,size=400x400)]]
}}}

=== Using an address ===
Please use semicolons, not commas, as separators in the address.
{{{
[[GoogleMap(address="Street; City; County",zoom=10,size=400x400)]]
}}}
or
{{{
[[GoogleMap("Street; City; County",zoom=10,size=400x400)]]
}}}
Please note that the address is converted into coordinates by user-side javascript every time the wiki page is loaded.
If this fails no map will be shown, only an empty gray rectangle.

Server side address conversion including caching is underway.

=== Using both ===
Doesn't make this much sense, but is supported anyway. This could be used as failsafe if you aren't sure if the address resolution will be successful.
{{{
[[GoogleMap(center=50.0:10.0,address="Street; City; County",zoom=10,size=400x400)]]
}}}
The given coordinates will be shown until the address is resolved, which can take a little when the user has a slow internet connection.
After (and if) the address is resolved the map will be centered on it.


== Recent Changes ==

[[ChangeLog(googlemapmacro/0.11, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:martin_s] [[BR]]
'''Contributors:'''