vehery/cordova-plugin-googlemaps

Google Maps plugin for Cordova

Cordova GoogleMaps plugin for iOS and Android

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

###Chat Join our online chat at

###Donation Please consider to make a small donation. We spent many hours to make this a great plugin, we even pay other developers to contribute new functions. In order to keep up the motivation, we ask for your help, too. Thanks!

Currently donated: 50 $

Before I release the clustering feature, I want to raise a funding of 1000$. I will donate some of the funded money to @limeuwe for donating the code and to my developer for the Android part. If you want to donate for funding, please add a note about that fact inside of the comments on paypal, or it will be considered as a normal donation.

Currently funded: 70 $

###Quick install

Plugin is finally available on npm
Before you install, make sure you've read the instructions

npm (current stable 1.3.9)

$> 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)

$> cordova plugin add https://github.com/phonegap-googlemaps-plugin/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"

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

$> cordova plugin rm plugin.google.maps
$> 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.

###WARNING This plugin is not compatible with Cordova-iOS 4.0.0. WKWebView is not supported. They have been huge changes in the API, and due to lack of time, there is no ETA when this plugin will be compatible. PRs are welcome!!

###Last release information

v.1.3.9 - 04/01/2016 Happy new year!

• Fixed a few bugs with Crosswalk, White-Screen Problems.
• Added "maxAddressLines" for Geocoder (Android, iOS had it already). Check "lines" inside of the extras array.
• Updated Google Maps SDK for iOS to 1.11.1

Please check the new Tutorial for Crosswalk

I recommend to set settings for Crosswalk to 15+ and remove android-platform (cordova platform rm android) and re-install it. No patches required anymore to run with crosswalk. It also has some nice performance boosts, as setting translucent isn't required anymore. (in my test-cases)

v.1.3.6 - 07/12/2015

• Fixed some small bugs
• Updated Google Maps SDK for iOS to 1.11.0
• Will fix some bugs on iOS 9
• with BITCODE support
• fixed blank map problems

Check out the release notes.

###Documentation

• Introduction

  • Difference between JavaScript APIs (web) and the mobile SDKs (native)
  • Why should I use this plugin?
  • Java Objective C or JavaScript. Which one do you like?

• Installation

  • Automatic Installation
  • Tutorials
    • Tutorial for Windows
    • Tutorial for Mac/Linux
    • PhoneGap Usage
    • Tutorial for Crosswalk
    • Tutorial for Monaca (Cloud building service)
  • Upgrade
    • Just re-install this plugin

• Terms of Services

• Map

  • 
  • Create a map
  • Create a map with initialize options
  • Change the map type
  • Move the camera
  • Move the camera within the specified duration time
  • Get the camera position
  • Get my location
  • Map Class Reference

• Marker

  • 
  • Add a Marker
  • Show InfoWindow
  • Add a marker with multiple line
  • callback
  • Simple Icon
  • Scaled Icon
  • Text Styling
  • Base64 Encoded Icon
  • Remove the marker
  • Click a marker
  • Click an infoWindow
  • Create a marker draggable
  • Drag Events
  • Create a flat marker
  • Marker Class Reference

• Circle

  • 
  • Add a circle
  • callback
  • Remove the circle
  • Circle Class Reference

• Polyline

  • 
  • Add a polyline
  • callback
  • Remove the polyline
  • Polyline Class Reference

• Polygon

  • 
  • Add a polygon
  • Click a polygon
  • callback
  • Remove the polygon
  • Polygon Class Reference

• Tile Overlay

  • 
  • Add a tile overlay
  • TileOverlay Class Reference

• Ground Overlay

  • 
  • Add a ground overlay
  • GroundOverlay Class Reference

• Kml Overlay

  • 
  • Add a kml overlay
  • KmlOverlay Class Reference

• LatLng

  • Create a LatLng object
  • LatLng Class Reference

• LatLngBounds

  • Create a LatLngBounds object
  • LatLngBounds Class Reference

• CameraPosition

  • CameraPosition Class Reference

• Location

  • Location Class Reference

• Geocoder

  • 
  • Geocoding
  • Reverse geocoding
  • Geocoder Class Reference

• BaseClass

  • BaseClass Reference

• External Service

  • 
  • Launch the navigation application

---

##Crosswalk If you want to use crosswalk (highly recommended), just follow this easy documentation. Install Plugin with Crosswalk

Join the official community

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

###Example You can see an example here. phonegap-googlemaps-plugin-v1.2.5.apk

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