Changes between Version 22 and Version 23 of GoogleStaticMapMacro

Timestamp:

Aug 24, 2015, 1:03:28 PM (9 years ago)

Author:

figaro

Comment:

Updated code.google links

GoogleStaticMapMacro

@@ -1 +1 @@
 [[PageOutline(2-5,Contents,pullout)]]
 
-= Insert a static Google Map as image
+= Insert a static Google Map as an image
 
 == Description
 
-This macro uses the [http://code.google.com/apis/maps/documentation/staticmaps/ Google Map API] to include '''static''' images of maps.
+This macro uses the [https://developers.google.com/maps/documentation/staticmaps/intro?csw=1&safe=on Google Map API] to include '''static''' images of maps.
 '''Static''' means that is is only a simple image without any user interaction and not the usual feature-rich dynamic map on http://maps.google.com/. No Javascript is needed to display the map image.
 
@@ -21 +21 @@
 
 If you have any issues, create a 
-[http://trac-hacks.org/newticket?component=GoogleStaticMapMacro&owner=martin_s new ticket].
+[/newticket?component=GoogleStaticMapMacro new ticket].
 
 [[TicketQuery(component=GoogleStaticMapMacro&group=type,format=progress)]]
@@ -37 +37 @@
 Install the plugin [http://trac-hacks.org/#HowdoIinstallthesethings as usual].
 
-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.
+To enable the macro put the following into your `trac.ini` file, which is located in the `config` directory of your Trac installation:
 
 {{{#!ini
@@ -52 +51 @@
 }}}
 
+You need to restart Trac to reread the macro file and the configuration file.
+
 == Upgrade from older Versions ==#Upgrade
 
-The current version of the macro uses the [http://code.google.com/apis/maps/documentation/staticmaps/ Google Static Map API v2], while older versions used [http://code.google.com/apis/maps/documentation/staticmaps/v1/ API v1]
-([http://code.google.com/apis/maps/documentation/staticmaps/upgrade.html Upgrade guide]).
+The current version of the macro uses the Google Static Map API v2, while older versions used API v1. To upgrade see 
+[https://developers.google.com/maps/documentation/staticmaps/upgrade?csw=1&safe=on here].
 The syntax provided by Google has changed between the API versions. To provide the newer features without breaking existing macros, both API versions are supported using the `api` key. 
 The older syntax can still be used with newer versions of the macro by setting `api=1` either as a macro argument (`[[GoogleStaticMap(api=1,<old syntax>)]]`) or using the global [#config configuration] option `default_api_version`.
 
-Please note, that since v2 an API key is not required anymore by Google. The API v1 still requires a trac server specific Google Map API key which is [http://code.google.com/apis/maps/signup.html provided by Google for free].
+Please note, that since v2 an API key is not required anymore by Google. The API v1 still requires a Trac server specific Google Map API key which is [https://developers.google.com/maps/signup?csw=1&safe=on provided by Google for free].
 
 == Usage & Examples
@@ -67 +68 @@
 === Parameters
 
-The macro accepts the official [http://code.google.com/apis/maps/documentation/staticmaps/#URL_Parameters Google Static Map argument (see there)] as well as a few internal arguments:
+The macro accepts the official [https://developers.google.com/maps/documentation/staticmaps/intro?csw=1&safe=on Google Static Map argument] as well as a few internal arguments:
  title:: Sets the HTML title of the map image.
- api:: Sets the API version to be used. By default set to "`2`". To reuse the older macros set `api=1` as mentioned earlier.
+ api:: Sets the API version to be used. By default set to "`2`". To reuse the older macros, set `api=1` as mentioned earlier.
  key:: Sets the API key if not set globally in the config file. Deprecated for macro v1.x / Google API v2.
 
@@ -87 +88 @@
 
 You can add markers to the static map using the '`markers`' argument. The format is '`markers=style settings|first location|next location|...`'
-([http://code.google.com/apis/maps/documentation/staticmaps/#Markers details]),
+([https://developers.google.com/maps/documentation/staticmaps/intro?csw=1&safe=on]),
 e.g.: `markers="size:mid|label:A|color:blue|50.805935,10.349121"`, creates a blue marker labeled with 'A' at 50.805935,10.349121. Again also addresses can be used to specify locations.
 The whole value must be quoted if any commas are included. Multiple `markers` arguments can be given to add markers with different styles.
 
-So,
+So the following example:
 {{{
 [[GoogleStaticMap(center="50.805935,10.349121",zoom=5,size=400x400,markers="color:blue|label:A|50.805935,10.349121",markers="color:green|label:B|50.000000,10.000000|Berlin,Germany",markers="color:yellow|label:C|Regensburg,Germany")]]
 }}}
+
 will result in the following map image:
 
@@ -101 +103 @@
 === Paths
 
-Paths between locations can be added using the `path` argument which has basically the same syntax as `markers`, except different styles are supported. See [http://code.google.com/apis/maps/documentation/staticmaps/#Paths the Google documentation] for details.
+Paths between locations can be added using the `path` argument which has basically the same syntax as `markers`, except different styles are supported. See [https://developers.google.com/maps/documentation/staticmaps/intro?csw=1&safe=on the Google documentation] for details.
 
 == Processor Syntax
@@ -107 +109 @@
 While Tracs normal macro syntax (`[[Macro(key=value,key=value)]]`) is nice for smaller arguments lists, it is getting messy for longer lists. 
 This macro now also supports the so called ''wiki processor syntax'' (`{{{ <linebreak> #!Macro <linebreak> content <linebreak> }}}`) to allow for multiple lines of arguments.
+
 In this case a line break will be read as a comma:
 {{{
@@ -116 +119 @@
 }}}
 }}}
+
 is identical to:
 {{{