AngularGM

AngularGM is a set of directives for embedding Google Maps in your application using the Google Maps Javascript API.

AngularGM 1.0.0 is here! This release includes some breaking API changes so make sure to read about it in the migration guide.

Features

Bi-directional association of map bounds, center, and zoom with scope variables
Multiple Google Maps can be embedded in the same page
Works with ngView and reuses map instances so there is no memory leak
Bind custom objects to markers
Listen for and generate events on markers/objects
Create InfoWindows which compile Angular expressions (credit goes to ui-map for this feature)
Create polylines

Documentation and Examples

Quick Start

Include the required libraries

<script src="//maps.googleapis.com/maps/api/js?sensor=false"></script>
<script src="//ajax.googleapis.com/ajax/libs/jquery/2.0.2/jquery.min.js"></script>
<script src="//ajax.googleapis.com/ajax/libs/angularjs/1.0.7/angular.min.js"></script>
<script src="//dylanfprice.github.io/angular-gm/1.0.0/angular-gm.min.js"></script>

Declare a dependency on the AngularGM module

var app = angular.module('myModule', ['AngularGM']);

Make a map

<gm-map gm-map-id="'myMap'" gm-center="center" gm-zoom="zoom" gm-bounds="bounds" gm-map-type-id="mapTypeId" style="width:500px;height:500px;"></gm-map>

There is also now the option to install through Bower: bower install AngularGM

Development

Clone the repo, git clone git://github.com/dylanfprice/angular-gm.git

AngularGM is tested with karma

$ sudo npm install grunt-cli --global
$ npm install
$ grunt karma:server

You can build the latest version using grunt.

$ grunt build

You can also view the latest documentation on your local machine.

$ grunt && grunt connect

then go to http://localhost:8000/dist/docs/

Pull Requests welcome!

Author

Dylan Price (the.dylan.price@gmail.com, http://github.com/dylanfprice)

Credits

Inspired by Nicolas Laplante's angular-google-maps directive (http://github.com/nlaplante/angular-google-maps)

README and project layout stolen from Olivier Louvignes' AngularStrap repo (http://github.com/mgcrea/angular-strap)

Much of the gmInfoWindow directive code is from the ui-map project

Changelog

Moved to CHANGELOG.md

xxxazxxx / angular-gm