GoogleMap:Wikka

Google Map

Try the demo:

The Google Maps API lets developers embed Google Maps in their own web pages with JavaScript. You can add overlays to the map (including markers and polylines) and display shadowed "info windows" just like Google Maps. (quoted from Google maps API homepage).

Based on PivWans idea to use this service to build a UserMap, here is the first code for a googlemap action.

Enhanced to use various parameters and api v2 (Experimented on http://wikka.pnconcept.com/GoogleMap)

Thank you Frank! I added you to the authors in the action-file.

add the following as actions/googlemap.php

<?php
/**
* Prints a map from Googles Map-service on a page.
*
* Note that you have to register your (sub)domain with google to get a key to use the map.
* See http://www.google.com/apis/maps/signup.html for details.
*
* @package actions
* @author {@link http://www.wikkawiki.org/NilsLindenberg Nils Lindenberg} (initial version)
* @author {@link http://www.wikkawiki.org/SamuelDR SamuelDR} (bugfix)
* @author {@link http://www.wikkawiki.org/FrankChestnut FrankChestnut} (various parameters and api v2)
*
* @todo: - Load markers from...
* - phpdoc document params
*/
//the key you get from google
$key = 'ABC';
// defaults
$latitude = '37.441944';
$longitude = '-122.141944';
$width = '300';
$height = '300';
$maptype = 'G_NORMAL_MAP';
$zoom = '4';
$overview = false;
$maptypes = array('normal' => 'G_NORMAL_MAP',
'satellite' => 'G_SATELLITE_MAP',
'hybrid' => 'G_HYBRID_MAP');
// E_ALL fix
if (isset($vars) && is_array($vars)) {
if (isset($vars['latitude']) && !empty($vars['latitude'])) {
$latitude = $vars['latitude'];
}
if (isset($vars['longitude']) && !empty($vars['longitude'])) {
$longitude = $vars['longitude'];
}
if (isset($vars['width']) && !empty($vars['width'])) {
$width = $vars['width'];
}
if (isset($vars['height']) && !empty($vars['height'])) {
$height = $vars['height'];
}
if (isset($vars['zoom']) && !empty($vars['zoom'])) {
$zoom = $vars['zoom'];
}
if (isset($vars['maptype']) && array_key_exists($vars['maptype'], $maptypes)) {
$maptype = $maptypes[$vars['maptype']];
}
if (isset($vars['overview']) && !empty($vars['overview'])) {
// 0 & '0' are considered empty so there is no need for further checks
$overview = true;
}
}
?>
<script src="http://maps.google.com/maps?file=api&v=2&key=<?php echo $key ?>" type="text/javascript"></script>
<div id="map" style="width: <?php echo $width ?>px; height: <?php echo $height ?>px"></div>
<script type="text/javascript">
//<![CDATA[
setTimeout("ShowGoogleMap()", 100);
function ShowGoogleMap()
{
if (GBrowserIsCompatible()) {
var map = new GMap2(document.getElementById("map"));
map.addControl(new GLargeMapControl());
map.addControl(new GMapTypeControl());
<?php
if ($overview) {
?>
map.addControl(new GOverviewMapControl());
<?php
}
?>
map.setCenter(new GLatLng(<?php echo $latitude ?>, <?php echo $longitude ?>, <?php echo $zoom ?>), <?php echo $zoom ?>);
map.setMapType(<?php echo $maptype ?>);
}
}
//]]>
</script>

This will print out a map with 300 x 300 pixel and the controls to change between map/satellite-picture and To move/zoom-in zoom-out. The map is centered to Paolo Alto.

Available parameters

latitude

logitude

width

height

maptype (normal, satellite, hybrid)

zoom

overview ("0"/"1") (Show minimap - default: "0")

Todo

params for width/height, controlls, location and other possible additions to a map, see the documentation. Done

Load markers from...........

Discussion

From: FrankChestNut

Little follow up about a google map...
Here is a little concept : http://www.ubuntu-fr.org/map/ (Beware... ridiculously long to load)
From what I understand from the source, people add their coordinates on this page http://doc.ubuntu-fr.org//utilisateurs/ou_sommes_nous
And an admin probably do a copy/paste of the markers section into a data.xml file http://www.ubuntu-fr.org/map/data.xml
On one side, not too bad, on the other, kind of a poor way to do the thing. But the basic idea is there. A way could be found to generate dynamically a xml output (like RecentChanges) and use it to compile the markers to put on the map.
Regards!
F.C. !

From: DarTar

Hi Frank,
what I had in mind was actually something quite similar to the Ubuntu thing (which is so heavy that it crashes my browser!). The way I see it, there are three possible ways of implementing GM functionality within Wikka:

As an action:
{{googlemap source="blablabla.xml"}}
Actions are used to generate content within a page, so this might be the most natural way to implement this kind of functionality. The problem with this approach is that the XML data source should be created manually, as you suggest, and this is not an interesting option. Alternatively we could have data stored as plain text in another page (say MyPage) and use a specific '/xml' handler to parse this page and generate the data file to be used by the action, e.g.
{{googlemap source="MyPage/xml"}}

As a handler:
http://wikkawiki.org/HomePage/googlemap
A handler typically performs operations on a page as a whole. A /googlemaps handler could display a specific map depending on whether specific strings are present in the page body or, alternatively - if appended to a UserPage - display the location of the user (as stored in a dedicated field of the user table).

As a formatter
Maybe the most interesting way to implement Google Maps would be to use a specific markup, e.g.

	::(gm)
	center: 45,76878;2,56658;
	type: satellite;
	zoom: 7;
	width: 250px;
	marker: 1; 45,76878; 2,666; DarTar;
	marker: 2; 46,54763; 3,666; WikkaWiki;
	::

(note this is just a mockup of possible markup, to give an idea of what I have in mind)
This would allow users to easily generate google maps with markers within a wiki, without the need of bothering with XML. The major drawback with this approach is that - because of the way in which the Wikka formatter is built- it's very difficult to introduce a "modular" formatter, so this should be core functionality - which definitely goes against Wikka's vision. Maybe GM support could be the occasion for an overhaul of the functioning of Wikka formatters?
--DarTar

From: FrankChestnut

From what I saw on the last formatter/wakka.php, you are not necessarily that far from modularity. Not that what is there is necessarily the solution but...
What I mean is the part where you define de PATTERN_XXX constants... (wasn't in 1.1.6.0 iirc)
All the regex could be either constants (or coming from another source) instead of being hardcoded.
If you define a way for people to have a custom markup definition file, people could use different markup. One could want to use a Doku style markup, or a PEAR style, etc.
One example of a problem I had when porting Wikka to PostNuke was that I had a glitch with WikiEdit. I update the WikiEdit to the latest version (3.01) and found out that the list button gave a different result (2spaces*1space instead of a tab). I had to change the markup for the lists in pnWikka to reflect this change and be able to use Wikiedit whatever version it was.
Based on what we do on PostNuke and templates, modules have their own templates. But a user can overide a specific module template (or style) by putting a different one in its theme template folder.
The PostNuke engine will check the availability of a template in the following order :
root/themes/USERTHEME/templates/modules/pnWikka/pnwikka_user_show.tpl
if not found, take the one that comes with the module.
root/modules/pnWikka/pntemplates/pnwikka_user_show.tpl
The same happens for module stylesheets.
Imagine something like this
wikkaroot/user/formatters/wakka.php
wikkaroot/formatters/wakka.php
if file exists in user/formatters/... then take this one.
else... take generic.
You win some modularity. ;)
And you give the power to your users to modify its markup without touching the original (most appreciated for updates). One drawback will be if you add markups. The natural extension of the solution would be of course to use different files for each tags.
wikkaroot/formatters/wakka.lists.php
wikkaroot/formatters/wakka.bold.php
etc...
... but might be kind of bad on the inclusions though.
Anyway....... writing brainstorming writing... and my coffee is getting cold. :)
Regards...
FC !

CategoryDevelopmentActions

Comments

Comment by SamuelDr

2005-06-30 18:19:27

params are not too complicated. We have to verify that it is a number that is entered for w/h. Location, a BOOLEAN value is ok and finally, for te location, 2 values, latitude and longitude, verify it can be true (I don't know what is the maximum value for thoses.)
All simple. I would do it if my browser would let me handle those maps ...

Here is an error :
&key= <?php echo $key ?>"
There sould be no space between those...

Comment by JavaWoman

2005-07-01 14:30:16

"The map is centered to Paolo Alto." ?

Would that be Palo Alto?

Comment by NilsLindenberg

2005-07-04 12:18:36

@Jw: Aehm, yes :)

@SamuelDr: I didn't had the time to do that. Perhaps it's better to define the key as a Constant since it'll only change when you move to a new url.

2005-07-07 03:01:35

maybe...

Comment by RolandStens

2006-01-12 05:55:39

You have to move the following code to header.php and put it in between the <head> tags. Otherwise this does not work.

#
<?php
#
$key = abc //the key you get from google
#
?>
#

#
<script src="http://maps.google.com/maps?file=api&v=1&key=<?php echo $key ?>" type="text/javascript"></script>

2006-01-12 10:25:15

Roland,
But it does work on DarTar's demo page, where the script api link is not in the head section...

2006-01-12 20:45:59

Yes, I noticed. But when I implement exactly the same thing, I get errors to the point that the page simply does not want to show. These errors went away by putting the script reference in the HEAD.

I must say, that I have replaced all the code in wikka.php that deals with output compression and the detection if a browser does support gzip compression with ob_gzhandler.
Although this works perfectly, it must have changed the behavior, so my "tip" might only be valid for me.

Comment by DarTar

2006-01-12 20:57:36

Hi Roland, I'll post asap the improved version of the GoogleMap action that I'm using for the demo.

2006-01-20 21:31:01

BTW, DarTar's demo now fails as well, with exactly the same error that I used to have.

2006-01-23 03:32:40

Roland, what do you mean by "now fails as well"? Nothing has changed in my demo since I uploaded it, and it works fine for me both with Safari/FF+Mac OS X and FF+WinXP.

Comment by 24.86.188.95

2006-01-23 10:06:50

This was with IE.
With FF and WinXP it works fine.

Comment by FrankChestnut

2006-06-13 19:41:16

You should try this, it's a simili fix as it will still fail for some people but will dramatically reduce their numbers.

//<![CDATA[
setTimeout("ShowGoogleMap()", 100);
function ShowGoogleMap()
{
if (GBrowserIsCompatible()) {
....etc...
}
}
....

The setTimeout tells the browser to wait (milliseconds) before executing the function.

The problem is that IE doesn't accept to change the content of a page before being fully loaded.

The only other solution is to put the script in the header and add the onload in the body tag.

Have fun ! ;-)
C !

Wikka : GoogleMap

Google Map

Available parameters

Todo

Discussion