Buy author a beer

gmap3 is a plugin for jQuery which allows you to use the Google maps API easily. It provides some powerful functions (clustering...) and some simple which avoid you to write lot of repetitive code. However, it allows to use all the Google Maps API.

• The same map can be accessed by all css selectors
• Chainable

• Even if gmap3 provides simplified types, Google Maps types and objects are still usable

• Google Maps services are usable without any code (address resolution, elevation ...) (example of silent address resolution)

• All objects added (markers, overlays ...) can have a unique id and / or have tag(s) in order to access / remove it later (example of id and tags)
• All objects can embed custom data which are sent on events (example of custom data)

Read the documentation

• All the features are visible in a single standalone file in the package

In order to build Gmap3, you need to have Node.js/npm latest and git 1.7 or later. (Earlier versions might work OK, but are not tested.)

For Windows you have to download and install git and Node.js.

Mac OS users should install Homebrew. Once Homebrew is installed, run brew install git to install git, and brew install node to install Node.js.

Linux/BSD users should use their appropriate package managers to install git and Node.js, or build from source if you swing that way. Easy-peasy.

Clone a copy of the main Gmap3 git repo by running:

git clone git@github.com:jbdemonte/gmap3.git

Enter the gmap3 directory and install its dependencies:

cd gmap3
npm install

Now, build it:

gulp

The built version of Gmap3 will be put in the dist/ subdirectory, along with the minified copy.

By default, all the features are included in the build, to create your own light version, you can remove some feature by using "--no-option_name" in the build command line.

e.g., to remove cluster support:

gulp --no-cluster

If a feature is removed while it's a dependency for another one, the remove option will be ignored.

Available options:

• --no-autofit
• --no-bicyclinglayer
• --no-circle
• --no-clear
• --no-cluster (use marker)
• --no-defaults
• --no-destroy
• --no-directionsrenderer
• --no-exec
• --no-get
• --no-getaddress
• --no-getdistance
• --no-getelevation
• --no-getgeoloc
• --no-getlatlng
• --no-getmaxzoom
• --no-getroute
• --no-groundoverlay
• --no-imagemaptype
• --no-infowindow
• --no-kmllayer
• --no-marker
• --no-overlay
• --no-panel
• --no-polygon
• --no-polyline
• --no-rectangle
• --no-streetviewpanorama
• --no-styledmaptype
• --no-trafficlayer
• --no-trigger

GPL v3