jQuery.gmap


> Stop wasting your time typing Google Maps API code. Be more efficient.

To display a neat Google Map you have to write the same basic code every time. This plugin helps to create Google Maps with less code.

Dependencies

As this is a jQuery plugin it depends on the jQuery library and of course the Google Maps API v3. Thats it.

Usage

Include the Google Maps API v3 and jquery.gmap.min.js somewhere on your site, preferably before the closing body tag.

``HTML


`

Create an element:
`HTML



`

Initialize your map:

`JavaScript
var $map = $('#map').gmap({
lat: 52.5075419,
lng: 13.4251364,
options: {
disableDefaultUI: true,
zoom: 13
}
});

$map.gmap('addMarker', {
lat: 52.5075419,
lng: 13.4251364,
title: 'I am the title'
infoWindow: {
content: 'This is an info popup',
opened: true
}
});
`

The same map code without jquery.gmap would look like this:

`JavaScript
var options = {
disableDefaultUI: true,
zoom: 13,
center: new google.maps.LatLng(52.5075419, 13.4251364)
}
var map = new google.maps.Map(document.getElementById('map'), options);

var marker = new google.maps.Marker({
position: new google.maps.LatLng(52.5075419, 13.4251364),
title: 'I am the title',
map: map
});

var infowindow = new google.maps.InfoWindow({
content: 'This is an info popup'
});

google.maps.event.addListener(marker, 'click', function() {
infowindow.open(map, marker);
});

infowindow.open(map, marker);
`

You can also specify options inline which will overwrite the default value and the value specified on initialization. You still have to initialize the map.

`HTML



`

`JavaScript
$('#map').gmap();
`

Options

$3

Type: boolean
Default: true

Recenter the map to the current center if map gets resized.

$3

Type: boolean
Default: true

Only open one infoWindow at most. Automatically closes opened infoWindow if you click on a marker to open a different.

API

jQuery.gmap offers several methods which are wrappers for common Google Map API functions.

$3

Add a marker to a previously initialized map. You can attach an infoWindow with some content,
set the marker icon and add a title. The optional infoWindow can be toggle via click on the marker.

`JavaScript
$map.gmap('addMarker', {
lat: 52.5075419,
lng: 13.4251364,
title: 'I\'m a title!',
icon: '/path/to/icon.ext',
infoWindow: { // optional
content: 'Some content',
opened: true // whether it should be opened on init
}
});
`

$3

Set options after initialization. Extends current options, does not replace.

`JavaScript
$('#map').gmap('setOptions', {
scrollwheel: false,
draggable: true
});
`

$3

Not all features of Google Maps API v3 are covered by jquery.gmap. Therefore you can get the raw Map object and work with it as normal.

`JavaScript
var $gmap = $('#map').gmap({
...
});

var map = $gmap.getMap();
// do whatever you like
var id = map.getDiv();
``

$3

Get all initialized marker objects.