Google Maps AngularJS Directive

The Simplest AngularJS Google Maps V3 Directive
Under MIT License
By allenhwkim

angular markers

Google Maps AngularJS Directive

Road Trip By StreetView
Maps Can Talk |
Custom Marker

If you like this, you also may like these:
* ng2-map Google Maps Wrapper for Angular 2+
* react-openlayers React + OpenLayers


There is already one for this. However, I found myself taking a totally different approach than the existing one, such as:

  1. Everything in tag and attributes.
    Thus, users don't even need knowledge of JavaScript.

  2. Expose all original Google Maps V3 API to the user.
    No hiding, no wrapping or whatsoever.
    By doing so, programmers don't need to learn how to use this module.
    You only need to know Google Maps V3 API.

There is a blog that introduces this module. The title of it is 'Google Map As The Simplest Way'

To get started

For Bower users,

$ bower install ngmap

  1. Include ng-map.min.js:
    <script src="/bower_components/ngmap/build/scripts/ng-map.min.js"></script>

  2. Include Google Maps:
    <script src=""></script>

  3. Name your AngularJS app ngMap, or add it as a dependency

var myApp = angular.module('myApp', ['ngMap']);

To get the map instance use the NgMap.getMap() function

app.controller('MyController', function(NgMap) {
NgMap.getMap().then(function(map) {
console.log('markers', map.markers);
console.log('shapes', map.shapes);

For npm users,

$ npm install ngmap

For Meteor users:

Lazy loading of Google Maps JavaScript

Simply wrap the map tag with map-lazy-load="".

<div map-lazy-load="">
<ng-map center="41,-87" zoom="3"></ng-map>

If you need to pass in an API key to the javascript, you can set a scope
variable in your controller (e.g. $scope.googleMapsUrl="";).
This can be set from a constant value in your app to standardise the API key to pass to google for multiple controllers.

<div map-lazy-load=""
<ng-map center="41,-87" zoom="3"></ng-map>

Grey area in Google Maps

The usual reason why this happens is that the size of the map is changed after the map has been initialized. If you for some reason change the size of the div, you need to trigger the "resize" event and possible recenter the map.

 var center = map.getCenter();
google.maps.event.trigger(map, "resize");


Check if a marker is within Map, Rectangle, or Circle

Calculate distance between two position

You can check this out:
As you see, DistanceMatrix does not require map nor directive.

Another way to do this, is to use directions directive. As you see it here:, you have access to DirectionsRenderer by using map.directionsRenderers[id]

You use getDirections() or directions, then calculate the distance from there. e.g.,

{{ map.directionsRenderers[0].directions.routes[0].legs[0].distance }}


Advanced examples



MIT License