Git Product home page Git Product logo

angularjs-google-maps's Introduction

Google Maps AngularJS Directive

Demo
Documentation
Road Trip By StreetView
Maps Can Talk | Custom Marker

If you like this, you also may like these:

Background

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="http://maps.google.com/maps/api/js"></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(map.getCenter());
    console.log('markers', map.markers);
    console.log('shapes', map.shapes);
  });
});

For npm users,

$ npm install ngmap

For Meteor users: https://atmospherejs.com/wormy/angularjs-google-maps

Configuration

You can use ngMapConfig provider to configure ngMap.

Available configurations:

Advanced Marker Elements
  • useAdvancedMarkerElements: when markers are added, the maps API uses AdvancedMarkerElement instead of Marker class

AdvancedMarkerElement requires a mapId is set when initialising the map. You can customise this mapId by adding a data attribute for mapId to the ngMap instance e.g.: <ng-map data-map-id="068edba235fe60d">

Example using configuration:

app.config(function (ngMapConfigProvider) {
  // Enable advanced marker elements
  ngMapConfigProvider.useAdvancedMarkerElements = true;
});

Important: using AdvancedMarkerElement requires Google Maps Javascript API v3.53.2 or higher

Lazy loading of Google Maps JavaScript

Simply wrap the map tag with map-lazy-load="https://maps.google.com/maps/api/js".

<div map-lazy-load="https://maps.google.com/maps/api/js">
  <ng-map center="41,-87" zoom="3"></ng-map>
</div>

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="https://maps.googleapis.com/maps/api/js?key=YOUR_KEY_HERE";). 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="https://maps.google.com/maps/api/js"
  map-lazy-load-params="{{googleMapsUrl}}">
  <ng-map center="41,-87" zoom="3"></ng-map>
</div>

FAQ

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");
 map.setCenter(center);

Ref.

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

`map.getBounds().contains(marker.getPosition());`

Calculate distance between two position

You can check this out: https://developers.google.com/maps/documentation/javascript/distancematrix. 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: https://rawgit.com/allenhwkim/angularjs-google-maps/master/testapp/directions2.html, you have access to DirectionsRenderer by using map.directionsRenderers[id]

https://developers.google.com/maps/documentation/javascript/reference?hl=en#DirectionsRenderer

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

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

Directives

  • bicycling-layer
  • custom-control
  • custom-marker (NEW)
  • directions (NEW)
  • drawing-manager (NEW)
  • dynamic-maps-engine-layer
  • fusion-tables-layer
  • heatmap-layer
  • info-window
  • kml-layer
  • map
  • map-data
  • map-lazy-load (NEW)
  • map-type
  • map_controller
  • maps-engine-layer
  • marker
  • overlay-map-type
  • places-auto-complete
  • shape
  • street-view-panorama (NEW)
  • traffic-layer
  • transit-layer

Advanced examples

Contributing

  • Clone the repository from GitHub.
  • Change to the cloned directory.
  • npm install to install the build tools
  • gulp build to build the JavaScript & doc files in the /build folder & run the unit tests.
  • gulp clean to clean up the repository by removing files and folders from previous build.
  • gulp test to run the Karma unit test suite.
  • gulp test:e2e to run the Protractor test suite. For the first test run, you may need to update the protractor webdriver manager. It will show the command on screen if this is required (node_modules/gulp-protractor/node_modules/protractor/bin/webdriver-manager update).
  • gulp test:server will start a web server for the testapp on http://localhost:8888

License

MIT License

angularjs-google-maps's People

Contributors

allenhwkim avatar c-hanvey avatar hamzaazeem avatar cyberap avatar pixelmixer avatar jo3d3v avatar xajhqffl avatar trainerbill avatar aitboudad avatar tk120404 avatar dlukez avatar larsdecker avatar jonfor avatar jkornata avatar sebas-nicholls avatar nkovacic avatar stillgbx avatar frozendroid avatar tonywilk avatar timoperplex avatar tallyb avatar stevenlundy avatar sebastianiridian avatar razvan-tudosa avatar nicolasbonduel avatar privatejava avatar hokennethk avatar harm-less avatar galenmarchetti avatar calraiden avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.