Changes between Version 46 and Version 47 of GoogleMapMacro


Ignore:
Timestamp:
Aug 8, 2015, 2:45:08 PM (9 years ago)
Author:
figaro
Comment:

Cosmetic changes, substituted code.google.com links

Legend:

Unmodified
Added
Removed
Modified

  • GoogleMapMacro

    v46 v47  
    33= Insert a dynamic Google Map into wiki pages
    44
    5 {{{
    6 #!NewsFlash
    7  '''Nov. 4th 2008''':: Support for '''driving directions''' with multiple targets as been added. Use like this: {{{[[GoogleMap(from="here",to="there",to="there too")]]}}}. The map will automatically be zoomed to make the driving directions full visible. Please be warned that there isn't yet any error handling implemented, so wrong addresses etc. will just get you a normal map.
    8  '''Nov. 3rd 2008''':: GoogleMapMacro is now implementing `IEnvironmentSetupParticipant` to create and update the needed DB table. Use `trac-admin `''<trac path>''` upgrade` to update the Trac DB after installing GoogleMapMacro >[4732].
    9 }}}
    10 
    115== Description
    126
    137This 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&amp;topic=1499 Google Map compatible browser] is needed. Newer version of Firefox and MS Internet Explorer are compatible.
    148
    15 For javascript-less static maps use the similar GoogleStaticMapMacro.
    16 
    17 Multiple Google Maps on the same wiki page are actively supported.
     9For Javascript-less static maps use the similar GoogleStaticMapMacro.
     10
     11Multiple Google Maps on the same wiki page are supported.
    1812
    1913'''Feedback''': I would like to get some [mailto:martin@scharrer-online.de?subject=Feedback%20GoogleMapMacro user feedback] for this macro.
    20 Tell me if you like it or not and what could be better. Feel free to request additional features as long there are supported by the [http://code.google.com/apis/maps/ Google Maps API]
    21 by opening a [http://trac-hacks.org/newticket?component=GoogleMapMacro&owner=martin_s&type=enhancement&release=0.11 feature request].
    22 
    23 The macro should work both with Trac 0.11 and 0.12. At the moment there is only a 0.11 directory which can also be used for Trac 0.12.
     14Tell me if you like it or not and what could be better. Feel free to request additional features as long there are supported by the [https://developers.google.com/maps/?csw=1&safe=on Google Maps API] by opening a [/newticket?component=GoogleMapMacro&owner=martin_s&type=enhancement&release=0.11 feature request].
     15
     16The macro should work both with Trac 0.11 and 0.12. There is only a 0.11 directory which can also be used for Trac 0.12.
    2417The AdvParseArgsPlugin is used to allow for quoted argument values and must also be installed.
    2518
    … …  
    3427
    3528If you have any issues, create a
    36 [http://trac-hacks.org/newticket?component=GoogleMapMacro&owner=martin_s&release=0.11 new ticket].
     29[/newticket?component=GoogleMapMacro new ticket].
    3730
    3831[[TicketQuery(component=GoogleMapMacro&group=type,format=progress)]]
    … …  
    6255== Configuration ==#config
    6356
    64 A different [http://code.google.com/apis/maps/signup.html Google Map API key] is needed for every web domain which can be obtained for free from Google.
     57A different [https://developers.google.com/maps/signup?csw=1&safe=on Google Map API key] is needed for every web domain which can be obtained for free from Google.
    6558'''Please check if the Google Map API Terms of Use apply for your Trac project.''' They apply to free and openly accessible Trac projects.
    6659
    6760To enable the macro put the below text into your `trac.ini` file, which is located in the `config` directory of your Trac installation.
    6861You can define project wide default values for some arguments and also whether the geocoding (address-to-coordinates conversion) is done on by the Trac server or by the client's web browser.
     62
    6963Google recommends server side geocoding with caching which is now implemented and can be enabled using `geocoding = server`.
    7064Please note that this creates a table `googlemapmacro` in your Trac database which is used for the caching.
    … …  
    9286
    9387The macro knows the following arguments, which can be used in the normal `key1=value1,key2=value2,...` syntax. If a value includes one or more comma then it must be set in double quotes (`" "`).
    94 If a key-less value is given it will be taken as `center` coordinates if it's in the proper format otherwise it's taken as an `address`. Unknown (or misspelled) keys or key-less values except the first are silently ignored.
     88If a key-less value is given it will be taken as `center` coordinates if it's in the proper format, otherwise it's taken as an `address`. Unknown (or misspelled) keys or key-less values except the first are silently ignored.
    9589
    9690 `address`:: Sets the center of the map to the given address. The value must be surrounded by quotes if it includes commas, e.g. `"Street, City, Country"`.
    … …  
    170164[[GoogleMap(Street; City; Country,zoom=10,size=400x400)]]
    171165}}}
     166
    172167Please note that the address is converted into coordinates by user-side Javascript every time the wiki page is loaded.
    173168If this fails, then no map will be shown, only an empty gray rectangle.
    … …  
    215210[[GoogleMap("Street, City, Country",zoom=10,size=400x400,markers=center;A|"Next street, City, Country";B|10.243:23.343;C)]]
    216211}}}
     212
    217213The same with hyperlinked markers:
    218214{{{