Author: dom
Date: 2006-02-22 22:10:50 +0000 (Wed, 22 Feb 2006)
New Revision: 736
Added:
trunk/README.GMAPS
Modified:
trunk/INSTALL
trunk/README
trunk/lib/OpenGuides.pm
trunk/lib/OpenGuides/Config.pm
Log:
More Google Maps tweaks.
Modified: trunk/INSTALL
===================================================================
--- trunk/INSTALL 2006-02-21 23:28:00 UTC (rev 735)
+++ trunk/INSTALL 2006-02-22 22:10:50 UTC (rev 736)
@@ -201,7 +201,7 @@
If you want Google Maps integration, you need to register with Google to get
an API key. Visit http://www.google.com/apis/maps/signup.html and follow the
instructions. Paste the great long string into the console window where you
-are installing.
+are installing. See README.GMAPS for more information.
"What is the longitude of the centre point of a map to draw for your guide?"
"What is the latitude of the centre point of a map to draw for your guide?"
@@ -249,6 +249,9 @@
National Grid, Geography::NationalGrid::IE to use the Irish National
Grid, and Geo::Coordinates::UTM to use a UTM ellipsoid.
+If you want to use a UTM ellipsoid, WGS-84 is the best choice, as it
+will allow you to use the Google Maps support with the minimum of fuss.
+
* Dependency errors
If, after you have answered these questions, the build script complains
Modified: trunk/README
===================================================================
--- trunk/README 2006-02-21 23:28:00 UTC (rev 735)
+++ trunk/README 2006-02-22 22:10:50 UTC (rev 736)
@@ -13,6 +13,8 @@
BUGS AND CAVEATS
UTF8 data are currently not handled correctly throughout.
+ Google Maps points will display offset when using British and Irish
+ National Grid input systems.
Other bugs are documented at
<http://dev.openguides.org/>
@@ -35,7 +37,7 @@
The OpenGuides Project (openguides-dev(a)openguides.org)
COPYRIGHT
- Copyright (C) 2003-2005 The OpenGuides Project. All Rights Reserved.
+ Copyright (C) 2003-2006 The OpenGuides Project. All Rights Reserved.
The OpenGuides distribution is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.
Added: trunk/README.GMAPS
===================================================================
--- trunk/README.GMAPS 2006-02-21 23:28:00 UTC (rev 735)
+++ trunk/README.GMAPS 2006-02-22 22:10:50 UTC (rev 736)
@@ -0,0 +1,39 @@
+As of 0.52, OpenGuides supports Google Maps using the API. The support has a
+few rough edges that still need ironing out, mostly relating to ellipsoids,
+and for that reason they aren't exposed by default.
+
+To use Google Maps, you need to get an API key from
+http://www.google.com/apis/maps/signup.html. When you've put this value into
+the config file as gmaps_api_key, the maps become available to you in two
+places. Firstly, if the user has set the user preference to display Google
+Maps, any node which has location information will get an inset map
+pinpointing the location. Secondly, the URL
+http://.../wiki.cgi?action=index;format=map becomes a large map with a list
+of all nodes (regardless of the user settings). The latter will become very
+slow on any sizable guide (there is work being done on speeding up indexes
+in general - please see the mailing list). If you don't get maps displayed
+when you know that the node has location information, read on.
+
+Ellipsoids and map accuracy
+---------------------------
+
+If you are based in the US and inputting points using latitude/longitude,
+the values in your database will almost certainly correspond to points on
+Google Maps. If so, simply change the "ellipsoid" configuration variable
+to "WGS-84" if it's not already set to this, and your maps will display.
+
+If you are using the British Grid system things are more complicated and this
+support is incomplete. If you set the configuration variable force_wgs84
+to 1, maps will display, but points will be offset from where they should
+be, normally by about 50 metres. This is because the British Grid uses a
+different ellipsoid from Google Maps. We plan to integrate conversion
+routines to fix this in a future release. In the meantime, if you
+advertise the maps you must make users aware of this flaw and tell them
+not to try and "correct" location data!
+
+You may be unlucky enough to be using the UTM input modes (ie not British
+or Irish National Grid) but have data entered in a mixture of formats.
+This is likely if your users are from the UK, as you may find a mixture of
+WGS-84 and Airy (ie British Grid style) based nodes. In this case, you
+*do* need to correct any that are offset. Only do this if your users
+input Lat/long values rather than grid Eastings/Northings.
Modified: trunk/lib/OpenGuides/Config.pm
===================================================================
--- trunk/lib/OpenGuides/Config.pm 2006-02-21 23:28:00 UTC (rev 735)
+++ trunk/lib/OpenGuides/Config.pm 2006-02-22 22:10:50 UTC (rev 736)
@@ -77,7 +77,7 @@
formatting_rules_link => "http://openguides.org/page/text_formatting",
backlinks_in_title => 0,
geo_handler => 1,
- ellipsoid => "International",
+ ellipsoid => "WGS-84",
centre_long => 0,
centre_lat => 0,
default_gmaps_zoom => 5,
@@ -232,7 +232,7 @@
=item * geo_handler (default: C<1>)
-=item * ellipsoid (default: C<International>)
+=item * ellipsoid (default: C<WGS-84>)
=item * gmaps_api_key
@@ -254,7 +254,7 @@
=head1 COPYRIGHT
- Copyright (C) 2004-2005 The OpenGuides Project. All Rights Reserved.
+ Copyright (C) 2004-2006 The OpenGuides Project. All Rights Reserved.
The OpenGuides distribution is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.
Modified: trunk/lib/OpenGuides.pm
===================================================================
--- trunk/lib/OpenGuides.pm 2006-02-21 23:28:00 UTC (rev 735)
+++ trunk/lib/OpenGuides.pm 2006-02-22 22:10:50 UTC (rev 736)
@@ -985,7 +985,7 @@
=head1 COPYRIGHT
- Copyright (C) 2003-2005 The OpenGuides Project. All Rights Reserved.
+ Copyright (C) 2003-2006 The OpenGuides Project. All Rights Reserved.
The OpenGuides distribution is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.