Skip to content
A Javascript Mapping Abstraction library.
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
examples use opnelayers 2.11 cause 2.12 break OpenLayers.Request.GET on diffre… Jun 29, 2012
source Amending jsdoc comment on swap() Sep 11, 2012
tests Fixing GeoCommons support to updated API Feb 26, 2012
tools Adding zip step to build process Aug 3, 2010 Fix Issue #302; update to have a realistic overview of whic… Oct 16, 2013
build.xml Refined geocoder implementation Aug 17, 2010
license.js Updating license with name and link to relevant OSI page. May 29, 2012

Mapstraction Javascript Library

This is now the official Mapstraction repository. It can be found at

About Mapstraction

Mapstraction is a library that provides a common API for various javascript mapping APIs to enable switching from one to another as smoothly as possible. Developers can code their applications once, and then easily switch mapping provider based on project needs, terms and conditions, and new functionality.

Users can switch maps as desired based on personal taste and quality of maps in their local area. Various tools built on top of Mapstraction allow users to easily integrate maps into their own sites, and configure them with different controls, styles, and provider.

Which Mapstraction Version?

The last official and stable release of Mapstraction was v2.0.18 in 2011. Since then Mapstraction languished for a while but it's now under active development.

A lot has changed in the world of maps APIs since v2.0.18. Some APIs have gone to the deadpool (farewell Yahoo! Maps) and some have changed substantially (hello Google v3 and Leaflet).

If you want to live life on the bleeding edge you can try the v3.0 branch but be warned, this branch is far from stable, is likely to continue to change as the official release of v3.0 draws ever nearer and also contains API changes which will break code that assumes Mapstraction v2.x. It's also not documented much, if at all.

A safer bet is to use the v2.1 branch. Whilst not a formally released branch, this is relatively up to date and was destined to be the next release of Mapstraction before it became evident that the project would receive a major version number boost.

In the meantime, v3.0 of Mapstraction continues onwards, join us and help us get Mapstraction v3.0 out of the door.

Why Mapstraction?

Mapstraction additionally fills some holes each provider's current offerings (taking advantage of existing open source solutions where possible) to normalise the feature set across platforms. Mapstraction also uses OpenStreetMap for people who want to build maps without restrictions on derived works.

Mapstraction is open-source and released under the BSD License.

Major Features

  • Support for more than 11 major mapping providers
  • Dynamic switching of provider
  • Point, Line, Polygon support
  • Marker Filtering by Time, Category, or any attribute
  • Image overlay and base tiles
  • GeoRSS and KML feed import
  • Geocoding of addresses
  • Driving directions

Supported Libraries

Mapstraction Users

  • Nestoria
  • GeoPress
  • Reuters
  • The Los Angeles Times
  • GeoNames
  • IDELab
  • ... and more

The Mapstraction homepage is available at

You can’t perform that action at this time.