= Inserts a static Google Map as image = == Description == This macro uses the [http://code.google.com/apis/maps/documentation/staticmaps/ Google Map API] to include '''static''' images of maps. '''Static''' means that is is only a simple image without any user interaction not the usual feature-rich dynamic map on http://maps.google.com/. The positive side is that no javascript is needed to display the map image. For a dynamic Google map use GoogleMapMacro. The maximum size supported by Google is 640x640 pixels. If a bigger width or height is requested it will be reduced to 640px. == Bugs/Feature Requests == Existing bugs and feature requests for GoogleStaticMapMacro are [report:9?COMPONENT=GoogleStaticMapMacro here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=GoogleStaticMapMacro&owner=martin_s new ticket]. == Download == Download the [http://trac-hacks.org/browser/googlestaticmapmacro/0.11/googlestaticmap.py?format=raw single-file macro], which is also available as [download:googlestaticmapmacro ZIP-file]. == Installation & Configuration == Just copy the [http://trac-hacks.org/browser/googlestaticmapmacro/0.11/googlestaticmap.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] googlestaticmap.* = enabled [googlestaticmap] api_key = # Optional settings: #default_size = 300x300 #default_language = de }}} == Source == You can check out GoogleStaticMapMacro from [http://trac-hacks.org/svn/googlestaticmapmacro here] using Subversion, or [source:googlestaticmapmacro browse the source] with Trac. == Example == {{{ [[GoogleStaticMap(center=50.805935:10.349121,zoom=5,size=400x400)]] }}} will result in the following map image: [[Image(http://maps.google.com/staticmap?center=50.805935%2C10.349121&zoom=5&size=400x400&key=ABQIAAAAMwTA9mkyZbDS6QMcxvwm2BQk7JAK84r7ycdvlw9atwcq_yt-SxQd58w7cbhU8Fvb5JRRi4sH8vpPEQ,nolink)]] See http://code.google.com/apis/maps/documentation/staticmaps/#URL_Parameters for all supported arguments. In addition the image title can be set using a `title` argument. The map location must be given in geographic coordinates, not as address. Please note that the format `center=X:Y` must be used, not `center=X,Y` as described in the above web site, due to the way trac parses the macro. == Recent Changes == [[ChangeLog(googlestaticmapmacro, 3)]] == Author/Contributors == '''Author:''' [wiki:martin_s] [[BR]] '''Contributors:'''