OpenLayers

IMPORTANT NOTE: OpenLayers 7.x-2.0-alpha2 changes the name "Presets" to "Maps" which means that API and hook functions have changed. If you write modules that use the OpenLayers API, read the upgrade documentation.

The OpenLayers Module and its submodules bring the OpenLayers JS library into Drupal. They enable users to combine maps from different map providers with data from Views and CCK input. The OpenLayers JavaScript library is open source, making it flexible and capable across standards as well as proprietary APIs.

Read the Handbook Documentation for the 2.x version of this module.

Help: Looking for Developers

2011-09-10: The developer capacity for this module has decreased significantly over the past 6 months and we would love some active co-maintainers. You don't have to be a mapping expert, just good with Javascript and Drupal and care about the code you write. See #1275190: Looking for co-maintainers.

Features & Submodules

OpenLayers

The OpenLayers core code stores map configurations: maps, styles, layers, and behaviors, and combines them to create maps using the OpenLayers javascript library on any Drupal site.

Layers

OpenLayers supports a wide range of map types and new types can easily be added as ctools exportables - new layer types are being added all the time. Currently the module supports OpenStreetMap, Google Maps, Yahoo Maps, Virtual Earth, TMS, WMS, CloudMade, and XYZ map types, and the MapBox module adds support for MapBox maps.

Behaviors

Map interactions like popups, zoom controls, editing, and fullscreen can be added via the UI and extended by other modules.

OpenLayers UI

This module allows for a user interface to create and store maps which can be used to customize all sorts of things like CCK Formatters to Views Plugins. Maps can be provided by code or stored in the database and integrated with Features.

OpenLayers Views

The Views module is the preferred system of putting an OpenLayers map on a page: two types are provided - OpenLayers Data and OpenLayers Map, so that a single map can contain multiple node types and views.

OpenLayers CCK (6.x only)

OpenLayers CCK adds an OpenLayers map and a simple OpenLayers WKT field type for storing complex geodata like points, lines, and polygons. Deprecated in Drupal 7

OpenLayers Filters (6.x only)

Provide a simple filter to allow for inline maps in content areas. By using a syntax similar to [openlayers preset_name], a map can be rendered in content.

Documentation

Main documentation for this module can be found at the Drupal OpenLayers Handbook and within the docs/ directory of the module itself. Contributions are welcome.

The 1.x version contains supplemental documentation with Advanced Help.

Translations

You can get and help out on translations into different languages at the OpenLayers project on localize.drupal.org.

Presentations

Check out the handbook page with links to presentations, videos, and other similar resources.

RoadMap & Current State

• 2.x feature complete and focused on stability. Check the roadmap draft to see direction. This version depends on ctools. The D7 version has majority of the same features as D6 version, but the OpenLayers CCK module is deprecated. The majority of development will be focused on Drupal 7.
• 1.x is no longer supported
• 0.x is no longer supported.

Upgrading

• Upgrade from 6.x-2.x to 7.x-2.x. API changes that will affect integrating modules and Features based modules. Please read the upgrade documentation.
• Upgrade from 1.x to 2.x: This is still incomplete, see for status: #710610: Upgrade Path for 1.x to 2.x
• Upgrading from 0.x to 2.x: Because of thorough API improvements, manual upgrading is recommended for those who want to upgrade from 0.x.

Related Modules

• OpenLayers Geocoder - This module extends OpenLayers CCK input widget allowing to mark a location on the map by simply providing its address.
• Geo Taxonomy (2.x) - Attaches geo information (latitude, longitude, bounding boxes, etc.) to taxonomy terms. Provides Views integration.
• WFS (2.x) - Provides integration with GeoServer and optimized interaction for complex maps.
• MapBox (2.x) - Provides a configurable MapBox layer type and the ability to quickly add attribution for OpenStreetMap data.
• OpenLayers KML (1.x) (github) - Use filefield to upload KML files and have them automatically put on a map.
• Domain Bonus Integration - Provides integration with the Domain Access module and the different keys for different layers
• OpenLayers Plus (2.x) - Adds a number of nice improvements to the module, and used in Managing News.
• StyleWriter (2.x) provides some of the backend required for dynamic point and polygon rendering and interaction.
• OpenLayers Icons Styles provides a set of styles and the ability to have styles automatically created from fils in the libaries folder. Combine with Map Icons to have an amazing set of styles.

Credits

• This module has taken some great ideas from modules such as GMap, ImageCache, Views, and Mapstraction.
• The developers and patch-providers have worked very hard to make this module what it is.
• Some sponsorship provided by Trellon, Geomemes, EchoDitto, and Development Seed.
• Drupal OpenLayers monster by Saman Bemel Benrud.

Downloads