Maps

A simple, easy to use Plone integration with Google Maps by Jarn.

Project Description

A Google Maps solution for Plone

The main purpose of this product is to provide a very simple to use Google Maps integration for Plone. The following goals were set for development:

• Ease of use
  • Add locations to a folder
  • Set the view of the folder to Map
  • It figures out how to center and zoom the map automatically
• Flexibility for enhancement by using the Zope 3 component architecture
• Sane fallbacks when Javascript is not available
• Clean separation of javascript, templates and logic
• Works on Smart Folders

Additionally Maps has the following features:

• Support for existing markers from qPloneGoogleMaps
• Support for content which has a location set with the geolocation product

Installation

In Plone 3.0 Maps shows up in the "Add-on Products" configuration panel.

In Plone 2.5 the installation is a bit more complex. Maps is set up using GenericSetup:

• in the ZMI, go to portal_setup
• Select the Properties tab
• On the Properties tab - in the list of active profiles, select Maps, Activate it
• click the Import tab
• click the import all steps. button on the bottom of the page.

To use Google Maps you need an Google Maps API key from Google.

You need to use the URL at which your site is normally available from the outside (most likely your own domain). You can just use the root of your site for the registration and the key will automatically be used for all maps on the site. If you have a map on your site which sees much traffic, then you may want to register another key for it's URL, so the volume limits from Google Maps are spread out a bit.

UK and China address search

The default Google Maps geocoding (search for coordinates by address) doesn't work everywhere. As of May 2007 it doesn't work in the UK and China for example.

We have added a workaround for this. To activate this workaround feature you'll have to add a key for Google AJAX Search to enable search for those regions.

To use the Google AJAX Search fallback, you need an Google AJAX Search API key from Google.

Two keys are included for testing with the following URLs:

• http://localhost:8080
• http://testing:8080

In Plone 3.0 you can use the "Maps settings" configuration panel to add keys.

In Plone 2.5 you have to setup your keys through the ZMI in portal_properties/maps_properties/map_google_api_keys.

Dependencies

• Plone 2.5.x on Zope 2.9.x, or
• Plone 3.0.x on Zope 2.10.x

Credits

Created by Florian Schulze for Plone Solutions in 2007.

Parts are based on:

• ATGoogleMaps
• qPloneGoogleMaps
• geolocation

Development sponsored by

The Student Services of Bergen, Norway

University of Oxford (Medical Sciences Division)

A Jarn (previously Plone Solutions) product

http://www.jarn.com