Using a Google Maps Gadget in Google Sites

I’m working on a Google Site for a group I belong to, and it’s been an uneven experience. The user experience for general editing is quite good, but things get very hairy very quickly when you try to insert “gadgets” onto the page. I assumed that adding, for example, a Google Map to a page would be trivial, but working with the official Map Gadget was frustrating as there was no help documentation on how to populate the “data source URL” field.

I finally dug deep enough to turn up the answer. The Google Map gadget was intended to work with Google Spreadsheets. To get a map on your Google Site showing your map content, here’s what you do:

  1. Create a spreadsheet in Google Docs.
  2. In the first column of the spreadsheet, type in the address as you would search for it in Google Maps. Full street addresses seem to work quite reliably.
  3. In the second column, enter some text that describes the item–this becomes the tooltip for the marker on the map. Repeat for as many items as you like, making sure not to skip rows.
  4. For debugging, I like to add a Map Gadget to the spreadsheet to check my data. Tell it to use Sheet!A1:B10 (or however many rows you have) and to use the last column for tooltips, then Apply and Close.
  5. Verify that the map looks right, then click the map so the title bar is showing, click the little menu in the upper right hand corner of the gadget, and choose Get Query Data Source URL. Choose Entire Sheet and select and copy the resulting URL to the clipboard.
  6. In your Google Site, edit the page you want to put the map on.
  7. Insert a map gadget into the page using the Gadget browser. Fill in the fields, pasting the URL you copied in step 5 into the Data Source URL field, and checking the option to use the last column for tooltips.
  8. Save your changes to the page and behold: a map with markers for all your attractions.

This gives you a pretty basic map view with control over the markers, the height and width of the displayed map, and tooltips. For more advanced map control (street view vs. satellite, zoom level, etc.) I think you’d have to embed raw calls to the API, but I’d be thrilled to be proven wrong.

13 comments...What do you think?

  1. Posted by Francisco 24th June, 2008 at 10:27 am

    Hello,

    Nice solution, works well… provided you are member of the group.

    I’ll try to make this simple gadget visible from the whole web but it’s seems to be impossible. I have try to replace the data query URL pointing to googledocs with the URL obtained after publishing th edoc in the web :

    Your document is viewable at:
    http://spreadsheets.google.com/pub?key=ppUVLbhkPQ_G7TruQ6EVtJw

    From a browser it works, but as a query URL within the tool, no way :-((

    But thank you for the trick

  2. Posted by Nigel 1st August, 2008 at 5:22 am

    Thank you VERY much for this tutorial as i have been looking into this solution for months. Your contribution to the web community is greatly appreciated.

  3. Posted by mg 2nd August, 2008 at 3:45 pm

    I’ve been having the same problem that end users get a need to sign in error: there is a workaround. First, do all as described above, including getting the data source URL. Load this URL up in your browser as per normal, and you’ll see that it dumps out a bunch of JavaScript like:

    google.visualization.Query.setResponse({requestId:’0′,status:’ok’,signature:’4648419300596197257′,table:{cols: [{id:'A',label:'',type:'t',pattern:''},{id:'B',label:'',type:'t',pattern:''}],rows: [[{v:'First cell'},{v:'Second cell'}]]}});

    Copy that into a static text file hosted on your webserver (e.g. www/mapsquerydata.txt) and then use that url as the data source url in the gadget. Will work fine after that.

  4. Posted by whr 10th August, 2008 at 2:34 am

    mg’s suggestion worked for me although I struggled for a while to work out how to “Copy that into a static text file hosted on your webserver”. Here’s what I did in the end:

    created a plain text file on my computer with the “google.visualization…..” stuff in it and nothing else. I then attached that to my Sites page. Now right click on the link to your attachment and “Copy link location”. This can be used as your source URL for the Map gadget. I had to remove stuff in the link after (and including) the question mark.

  5. Posted by whr 10th August, 2008 at 3:09 am

    I take that last post back - it doesn’t work.

  6. Posted by Baskabas 11th August, 2008 at 10:43 am

    I also experienced the “not signed in” problem…

    What worked for me was publishing the worksheet including the gadget and embed that into the Google Site.

    Just hide the data columns, tweak the size until it fits just right and your set.

    This way you keep the gadget up-2-date through your spreadsheet publishing.

  7. Posted by Baskabas 11th August, 2008 at 10:47 am

    What worked for me was publishing the entire spreadsheet (incl. gadget) and embed that in my Google site.

    Just hide the data columns and resize the first cell to fit your gadget… et voila!

  8. Posted by Albert 19th August, 2008 at 12:29 am

    It requires signing in. Not work.

    My solutions for now is to have my map on a separate page made through Google Pages. Yes. It will only work for a while before Google Pages is removed.

    If someone knows how to do it and works fine, please let me know. THANKS.

  9. Posted by James 30th August, 2008 at 5:18 pm

    Thanks a lot for this post!

    Regarding the “not signed in” problem that some folks have been having: you can solve it as follows:

    1) Go to your spreadsheet’s “sharing” tab
    2) Check box that reads “Anyone can view this document WITHOUT LOGGING IN”

  10. Posted by Jim 20th October, 2008 at 4:18 pm

    How do you”Insert a map gadget into the page using the Gadget browser”
    On the edit mode of the specific page on google sites the “insets” menu does not contain Gadgets Browser.
    Am I looking in the wrong place for this to insert my URL of the spreadsheet ??
    Thanks

  11. Posted by Tim Jarrett 20th October, 2008 at 4:21 pm

    Sorry, should have been more specific. I should have said, Use the Inserts menu, go down to the bottom of the Gadgets section, and then select More…. This brings up the Gadgets browser.

  12. Posted by JB 26th October, 2008 at 8:06 am

    excellent solution. Thanks!

  13. Posted by ViGIlant 29th October, 2008 at 7:33 am

    howto make my markers different color?

What do you think? Join the discussion...