gmap3 - Google Maps and jQuery
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.
Why using gmap3 ?
- The same map can be accessed by all css selectors
Full Google Maps API
- Even if gmap3 provides simplified types, Google Maps types and objects are still usable
Silent use of Google Maps services
- Google Maps services are usable without any code (address resolution, elevation ...) (example of silent address resolution)
Unique Id, tags & custom data
- 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)
A complete documentation
Lot of examples
- All the features are visible in a single standalone file in the package
What you need to build your own Gmap3
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.)
Mac OS users should install Homebrew. Once Homebrew is installed, run
brew install git to install git,
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.
How to build your own Gmap3
Clone a copy of the main Gmap3 git repo by running:
git clone email@example.com:jbdemonte/gmap3.git
Enter the gmap3 directory and install its dependencies:
cd gmap3 npm install
Now, build it:
The built version of Gmap3 will be put in the
dist/ subdirectory, along with the minified copy.
The builder contains two main tasks named "default" and "package".
- "default" build the gmap3.js and its minified version
- "package" also include the demo and examples files
By default, all the features are included in the build, to create your own light version, you can either remove some features by using --no-option_name in the build command line or only include the ones you want by using the option --only.
only include "rectange" and "circle" features:
gulp --only --rectangle --circle
The code below is equivalent to:
gulp default --only --rectangle --circle
To also includes compatible demo and examples:
gulp package --only --rectangle --circle
to keep all features but the cluster support:
If a feature is removed while it is a dependency for another one, it will be nevertheless kept.
- cluster (use marker)