This server will be upgraded at 3pm Sydney time on December 3rd (December 2nd, 8pm PST) and will be down for up to 30 minutes.

Google Maps Plugin

Added by Mike Cannon-Brookes, last edited by Nathan Dwyer [Atlassian] on Nov 07, 2008  (view change)
Name Google Maps Plugin
Vendor Atlassian Software Systems (Website)
Authors Nathan Dwyer, Richard Wallace, Keith Brophy, Simon Mittag, Agnes Ro, Mike Cannon-Brookes
Homepage http://confluence.atlassian.com/display/CONFEXT/Google+Maps+Plugin
Issue Management http://developer.atlassian.com/jira/browse/GMAP
Continuous Integration n/a
Categories Content Macros
Most Recent Version 0.7.1
Availability Confluence v2.8.0 to v2.10
State Stable
Support Unsupported Plugins
License Freeware / Open Source (BSD)
Price Free
Release Docs http://confluence.atlassian.com/display/CONFEXT/Google+Maps+Plugin
Java API Docs n/a
Download Source http://svn.atlassian.com/fisheye/browse/public/contrib/confluence/gmaps-plugin/
Download JAR gmaps-confluence-plugin-0.7.1.jar

Description

A macro for including Google Maps of particular addresses within a page.

Installation

Upload this macro using the Plugin Manager.

This plugin now accessable through the Confluence Repository Client.
Upgrading

You must disable the plugin before uninstalling, and enable it after reinstalling - not doing so will result in an exception when registering the component.

Macro parameters

Parameter Name Required Possible Values Default
name   any valid DOM id  
width  
700
height  
500
style   any valid class name
zoom  
13
maptype   (map, satellite, hybrid, terrain)+ map,satellite,hybrid
displaymap   map | satellite | hybrid | terrain map
controls   none | auto | large | medium | small auto (size calculated from width and height)
mapscale   true | false true
maptypecontrol   true | false true
overview   true | false false
drag   true | false true
doubleclickzoom   true | false true (only has an effect if drag is enabled)
wheelzoom   true | false false
marker   true | false true
macro body yes the address to map

Macro body

The macros body can have any number of lines with these formats:

[place:] ([location=]<address>|<latlon> [| info=<info>]

directions: from= | to=

Examples

Map centered on a marker for San Francisco:

{gmap}
San Francisco
{gmap}

Map centered on San Jose with no marker

{gmap}
37.269135,-121.873398
{gmap}

Equivalent to the last one:

{gmap}
place:address=37.269135,-121.873398
{gmap}

With a info box if you click on the marker

{gmap}
San Francisco
{gmap}

Some cities:

{gmap:zoom=3}
Chicago
San Francisco
New York
Seattle
{gmap}

Alternately (centered on Nebraska, but with no marker):

{gmap:zoom=3|marker=false}
Nebraska
place:San Francisco|info=The City
place:address=New York|info=The big apple
place:address=Seattle|info=Cold, dark place
Chicago|info=Someplace in the middle
{gmap}

Some directions:

{gmap}
directions:from=24th and Mission SF CA|to=Geary and 20th SF CA
{gmap}

And...

{gmap}
16th and Mission SF CA|info=The heart of the mission
Alcatraz
18th and Missouri SF CA
directions:from=San Francisco|to=Napa, CA
1 Embarcadero San Francisco, CA|info=Slanted Door restaurant
{gmap}

Release History

Version Date Author Notes
0.1 27-Feb-2006 Mike Cannon-Brookes Initial version.
0.2 06-Jun-2006 Agnes Ro Fixed IE problems
0.3 13-Mar-2007 Simon Mittag Fixed Conf 2.3 problems, added international geocoding
0.4 18-Mar-2007 Simon Mittag Updated to Google maps V2 API, new attributes supported
0.4.1 29-Jul-2007 Simon Mittag Rebuilt Keith's fix for GMAP-5
0.7.1 30-Oct-2008 Nathan Dwyer [Atlassian] Rewritten

Labels

macro macro Delete
google-maps google-maps Delete
confluence13 confluence13 Delete
confluence14 confluence14 Delete
confluence20 confluence20 Delete
confluence21 confluence21 Delete
plugin plugin Delete
repository_current repository_current Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (96)

 

  1. Mar 01, 2006

    Guy Fraser says:

    This plugin seems to fail for any address outside the USA I went to maps.googl...

    This plugin seems to fail for any address outside the USA

    I went to maps.google.com, put in the address and it recommended a different (but correct) address - I then pasted that in to the macro body and the macro still failed to display the location.

    1. Mar 01, 2006

      Guy Fraser says:

      Ah, you're using "geocoder.us" = USA only. Does anyone know of any other free g...

      Ah, you're using "geocoder.us" = USA only. Does anyone know of any other free geocoders?

      1. Mar 01, 2006

        Guy Fraser says:

        Some hunting later... http://maps.google.com/maps?oi=map&output=js&q=A...

        Some hunting later...

        http://maps.google.com/maps?oi=map&output=js&q=ADDRESS_GOES_HERE

        You'll need an exact address and the results will be embedded within a load of JS - however, if the address is found you will see an @ sign near the end followed by the lat/long. Some regex'ing would likely be able to pull the lat/long or warn if the address was not found.

        As for getting addresses outside the US, you have to be extremely specific - in short you'll have to put your address in to Google maps and see what it finds, then use the suggested address exactly as shown in order to find the geocode. Still, at least this would allow a much wider range of addresses to be located.

        It would be useful if there was some level of caching in there too in order to reduce calls to the remote server.

        I also found this API from Yahoo! but it seems to be US only:

        http://developer.yahoo.net/maps/rest/V1/geocode.html

        More searching and found a canadian geocoder:

        http://geocoder.ca/?api=1

        Ah, this one might do the trick...

        http://emad.fano.us/blog/?p=277

        1. Apr 29, 2006

          Ruediger Jungbeck says:

          If you take http://maps.google.com/maps?output=kml&q=ADDRESS_GOES_HERE ...

          If you take

          http://maps.google.com/maps?output=kml&q=ADDRESS_GOES_HERE

          you will get a nice looking (and easy to parse) XML file (which also works for Google Earth).

          This will also work for international addresses (if specified correctly).

          1. Apr 29, 2006

            Guy Fraser says:

            Just tried it and it worked first time - nice one! This will certainly be a much...

            Just tried it and it worked first time - nice one! This will certainly be a much better way to geocode the addresses in the gmap plugin than the current US-only way.

            1. Oct 24, 2006

              Christian Løverås says:

              Where do I specify the geocoder?

              Where do I specify the geocoder?

  2. Mar 02, 2006

    Charles Miller says:

    We should at least add a way to skip the geocoding step and provide an ICBM addr...

    We should at least add a way to skip the geocoding step and provide an ICBM address directly.

    1. Mar 02, 2006

      Guy Fraser says:

      Perhaps a param of "dataType" = address (multiple addresses, one per line?) / ge...

      Perhaps a param of "dataType" = address (multiple addresses, one per line?) / geocode (affectionately known as ICBM) / nac (natural area code) / table (a table of addresses?)

  3. Mar 02, 2006

    Brendan Patterson says:

    I botched my Google Map key for my site. How do I dump the first one I put in a ...

    I botched my Google Map key for my site. How do I dump the first one I put in a new one? That is without resorting to hacking of the database?

    1. Mar 02, 2006

      Brendan Patterson says:

      Ah ha! So today I learned about bandan. The Google Maps key is being stored not ...

      Ah ha! So today I learned about bandan. The Google Maps key is being stored not via the ContentPropertyManager but via Bandana. This appears to be an XMLSerializer being used to store global / config type data for Confluence. This can be found at confluence-data-dir/config/confluence-global.bandana.xml

      Once there the key is clearly marked and can be edited:

          <entry>
      <string>ext.gmaps.api.key</string>
      <string>ABQIAAAAkmi-K3_H9t7UlmUGXJoB9xRQKQXmVp9WnuNec_QyhNoEciuvxxT6i8iiIkxW_-KGeEsYu_e2TafQJA</string>
    </entry>

      Everyone who has commented likely knows this, but it may save someone somewhere some time.

      I also learned that your Google maps key is generated for http://www.site.com/somedir

      then you're good to go for the rest of that server http://www.site.com/somedir/AAA http://www.site.com/somedir/BBB http://www.site.com/somedir/CCC

      If you try to generate a key for http://www.site.com/somedir/AAA then your Google Map key won't work.

      1. Mar 02, 2006

        Mike Cannon-Brookes says:

        For reference, if you set the key wrongly you can still reset it. Go to http://w...

        For reference, if you set the key wrongly you can still reset it. Go to http://www.yourserver.com/admin/plugins/gmaps/configure.action as an Administrator, and you can reset the key through the web interface.

        (In Confluence 2.2, there are neat little 'Configure plugin' links which make all this work seamlessly)

  4. Mar 28, 2006

    Kurt Werle says:

    I'm a bit confused as to what this does. Does it add a link that will open up a...

    I'm a bit confused as to what this does. Does it add a link that will open up a map, or does it include the map itself in the page? The examples show the use without the result!

    'cause I want the former, not the latter.

    1. Mar 28, 2006

      Mike Cannon-Brookes says:

      Kurt - the macro embeds a Google map (scrollable, zoomable etc) within the page ...

      Kurt - the macro embeds a Google map (scrollable, zoomable etc) within the page itself. There is no link right now to open up the map at maps.google.com but that could be added if you want one?

      1. Mar 28, 2006

        Kurt Werle says:

        Yeah - have a bunch of addresses (local restaurants). Maps would be too big, bu...

        Yeah - have a bunch of addresses (local restaurants). Maps would be too big, but links would be great.

        1. Mar 28, 2006

          Guy Fraser says:

          It might be worth making a {gmap-link} macro?

          It might be worth making a {gmap-link} macro?

        2. Mar 28, 2006

          Mike Cannon-Brookes says:

          Kurt - if you just want a link, you can use a simple Confluence link? ie "The At...

          Kurt - if you just want a link, you can use a simple Confluence link? ie "The Atlassian SF office is here" Or am I misunderstanding what you want to do?

          1. Mar 28, 2006

            Guy Fraser says:

            I'm guessing he wants something like: {gmap-link}address goes here{gmap-link} ...

            I'm guessing he wants something like:

            {gmap-link}address goes here{gmap-link}

            That would automatically work out the URL thus leaving markup cleaner...?

            1. Mar 28, 2006

              Kurt Werle says:

              Right. Which leaves the door open to popup maps on hover, link api changes, and...

              Right. Which leaves the door open to popup maps on hover, link api changes, and spiffy features I can't even imagine. Though something like

              Unknown macro: {gmap-link [start address]}
              target address
              Unknown macro: {gmap-link}
              that gives you directions would be cool, too. Obviously there are plenty of options...

  5. May 05, 2006

    Peter Shaw says:

    Just wanted to check if anyone else was seeing a failure of this plugin when usi...

    Just wanted to check if anyone else was seeing a failure of this plugin when using Internet Explorer (on PC) - only just noticed myself as I normally use FF (on both mac & PC). One of my colleagues (who's used the API before) seemed to think it was probably a bug in IE where the javascript has to be in a particular position on a page as mentioned here

    Confluence v2.2-dr2 Build #510 (on Mac OS X 10.4.6), FF v1.5.03 on Mac & PC, IE v6.0.2900.2180 on Windows XP SP2

    1. May 22, 2006

      Christain Stovall says:

      It crashes all the IEs around here too. Pity, because its a damn cool plugin.

      It crashes all the IEs around here too. Pity, because its a damn cool plugin.

      1. Jul 06, 2006

        Agnes Ro says:

         The IE problem has been fixed in version 0.2

         The IE problem has been fixed in version 0.2

  6. Jul 12, 2006

    Steve Soskin says:

    I can get the macro to work just fine in IE. Firefox however presents me with a...

    I can get the macro to work just fine in IE.
    Firefox however presents me with a blank page.
    Any clues?

    1. Jul 12, 2006

      Steve Soskin says:

      Just as a PS - I can get the macro to work in FireFox if I use the IEtab extensi...

      Just as a PS - I can get the macro to work in FireFox if I use the IEtab extension for FireFox....

      1. Jul 12, 2006

        Agnes Ro says:

        I have tried on two different machines using firefox (without the IEtab extensio...

        I have tried on two different machines using firefox (without the IEtab extension) and I don't seem to be having this problem... is anyone else also getting a blank page?

        1. Jul 14, 2006

          Steve Soskin says:

          I've done further testing on FireFox on a linux machine as well as on a Mac with...

          I've done further testing on FireFox on a linux machine as well as on a Mac with the same blank page as a result. I also tried Netscape on a Mac - also a blank page.

          1. Jul 14, 2006

            Mike Cannon-Brookes says:

            Steve - just tried here and it works fine. What exact version of Firefox are you...

            Steve - just tried here and it works fine. What exact version of Firefox are you using? what version of Confluence and the Google Maps macro? Tks, Mike

            1. Jul 14, 2006

              Steve Soskin says:

              Hi Mike - I'm using Firefox 1.5.0.4    Confluence 2.2.5 and Goog...

              Hi Mike -

              I'm using Firefox 1.5.0.4    Confluence 2.2.5 and Google Maps macro 0.2

              thnx,

              steve

              1. Jul 14, 2006

                David Peterson [CustomWare] says:

                Could it be a problem with Flash? Does Google Maps work at all on your computer?...

                Could it be a problem with Flash? Does Google Maps work at all on your computer? Sounds weird...

                David

                1. Jul 21, 2006

                  Steve Soskin says:

                  Yes - Google Maps works fine  on the computer in Firefox - just not from th...

                  Yes - Google Maps works fine  on the computer in Firefox - just not from the plugin. It's only the plugin - and its the same for all of our users......they can see the map in IE6 when in Confluence with the plugin....but the same page in Firefox (unless using IE tabs) renders a blank page.

  7. Jul 21, 2006

    Steve Soskin says:

    Is it possible that our Confluence install is possibly bad? As I said - the map ...

    Is it possible that our Confluence install is possibly bad? As I said - the map renders fine in IE 6 and IE 7 and Firefox with IE Tab on a PC. We get a blank page in all browsers on a Mac.

  8. Jul 21, 2006

    Steve Soskin says:

    OK - I think I figured it out. It looks like the Builder Plugin is what is causi...

    OK - I think I figured it out. It looks like the Builder Plugin is what is causing the blank page. I created a space without Builder and the map renders just fine.  In addition, in IE - with Builder and the map. the Builder menu doesn't render but the map does.

    1. Jul 21, 2006

      Guy Fraser says:

      Thanks for the info Steve - we'll look in to this over the weekend. If possible,...

      Thanks for the info Steve - we'll look in to this over the weekend. If possible, could you email us the wiki notation you're using (to usual email addr) as it'll allow us to set-up our testing area more quickly.

      1. Jul 26, 2006

        Steve Soskin says:

        Any update on using gmaps with Builder? thnx, steve

        Any update on using gmaps with Builder?

        thnx,

        steve

  9. Aug 09, 2006

    Test says:

    I can't get this to work for UK addresses no matter how I format it. It doesn't ...

    I can't get this to work for UK addresses no matter how I format it. It doesn't work even if I get the geocode co-ordinates:

    Error locating address: Waterloo Road, Lambeth, SE1, UK
    Error locating address: Waterloo Road, Lambeth, UK
    Error locating address: Waterloo Road, Lambeth, Greater London, SE1, UK
    Error locating address: -0.112503,51.504278
    Error locating address: 51.504278,-0.112503
    Error locating address: -0.1105, 51.5027

    Does anyone have any ideas on getting around this?

    Cheers!

    1. Aug 27, 2006

      Guy Hoogewerf says:

      I haven't had success either yet... does Google Maps work with Builder anyone?

      I haven't had success either yet... does Google Maps work with Builder anyone?