node package manager


Cordova GoogleMaps plugin for iOS and Android

This plugin is a thin wrapper for Google Maps Android API and Google Maps SDK for iOS. Both PhoneGap and Apache Cordova are supported.

Quick install

Before you install, make sure you've read the instructions

npm (current stable 1.4.0)

$> cordova plugin add cordova-plugin-googlemaps --variable API_KEY_FOR_ANDROID="YOUR_ANDROID_API_KEY_IS_HERE" --variable API_KEY_FOR_IOS="YOUR_IOS_API_KEY_IS_HERE"

Github (current master, potentially unstable)


If you re-install the plugin, please always remove the plugin first, then remove the SDK

$> cordova plugin rm cordova-plugin-googlemaps
$> cordova plugin rm com.googlemaps.ios
$> cordova plugin add cordova-plugin-googlemaps --variable API_KEY_FOR_ANDROID="YOUR_ANDROID_API_KEY_IS_HERE" --variable API_KEY_FOR_IOS="YOUR_IOS_API_KEY_IS_HERE"

The SDK-Plugin won't be uninstalled automatically and you will stuck on an old version.

Last release information

v1.4.0 - 04/Nov/2016

  • Lots of bugs are fixed.
  • Improve performance (especially adding markers using the same url)
  • Updated Google Maps SDK for iOS to 2.1.1
  • StyledMapType is available.

Quick demo

<script type="text/javascript">
var map;
document.addEventListener("deviceready", function() {
  var div = document.getElementById("map_canvas");
  // Initialize the map view 
  map =;
  // Wait until the map is ready status. 
  map.addEventListener(, onMapReady);
}, false);
function onMapReady() {
  var button = document.getElementById("button");
  button.addEventListener("click", onBtnClicked);
function onBtnClicked() {
  // Move to the position with animation 
    target: {lat: 37.422359, lng: -122.084344},
    zoom: 17,
    tilt: 60,
    bearing: 140,
    duration: 5000
  }, function() {
    // Add a maker 
      position: {lat: 37.422359, lng: -122.084344},
      title: "Welecome to \n" +
             "Cordova GoogleMaps plugin for iOS and Android",
      snippet: "This plugin is awesome!",
    }, function(marker) {
      // Show the info window 
      // Catch the click event 
      marker.on(, function() {
        // To do something... 
        alert("Hello world!");


All documentations are here!!


If you want to use crosswalk, just follow this easy documentation. Install Plugin with Crosswalk

Join the official community

New versions will be announced through the official community. Stay tuned!


Join our online chat at


You can see an example here. (old version, but all most the same)


$> adb install phonegap-googlemaps-plugin-v1.2.5.apk


Version 2.0 Beta

The new version 2.0 supports multiple maps on multiple pages. Lots of issues are fixed, and the performance are improved.

However, the documentation is not enough for the version 2.0. For the reason, the new version is still in the beta. If you are interested in it, you can try the new version.

For more details, please read here.

You can try the demo application from here.

Version 2.0 Beta Roadmap

The version 1.x will be shutdown in 2017. The date is not decided yet, but we release the v1.4.0 is the last version of v1.x

For more details are announced through the Official community