rails-google-maps 0.0.11 → 0.0.12

data/README.md

@@ -1,6 +1,9 @@
-# RailsGoogleMaps
+# Rails + Google Maps
 
-TODO: Write a gem description
+* Gem provides small js library to simplify communication with google maps.
+* jQuery Autocomplete integration.
+
+Something was taken from https://github.com/rjshade/gmaps-autocomplete
 
 ## Installation
 
@@ -16,9 +19,63 @@ Or install it yourself as:
 
     $ gem install rails_google_maps
 
+To use this gem you need to require google map script on the top of your layout(before including application.js).
+Haml example:
+```ruby
+- unless Rails.env == 'test' # we don't like to load gmaps while testing
+    %script{:src => "http://maps.googleapis.com/maps/api/js?sensor=false", :type => "text/javascript"}
+```
+
+And include it in your ```application.js``` file after jquery:
+```
+//= require rails_google_maps
+```
+
+
 ## Usage
 
-TODO: Write usage instructions here
+1) Apply google map to div element where map should appear:
+```js
+(new GoogleMap()).apply()
+```
+By default it will be applied to the element with id '#gmaps-canvas', but it can be customized:
+```js
+(new GoogleMap({selector: '#gmaps'})).apply()
+```
+
+2) Store selected point (latitude and longitude) in input fields:
+```js
+new GoogleMap({longitudeInput: '#longitude_input', latitudeInput: '#latitude_input'})
+```
+
+3) Set preferred location from your code:
+```js
+gmap = new GoogleMap()
+gmap.apply()
+gmap.geocodeLookup('address', 'New York')
+//or
+gmap.geocodeLookup('latLng', new google.maps.LatLng(51.751724,-1.255284))
+```
+
+4) Prevent users from changing location:
+```js
+new GoogleMap({immutable: true})
+```
+
+5) Integrate map with jquery-autocomplete:
+```js
+gmap = new GoogleMap()
+autoComplete = new GmapAutocomplete('#gmaps-input-address', gmap)
+autoComplete.apply()
+gmap.apply()
+```
+6) Add errors (these - are defaults):
+```js
+(new GoogleMap({errorField: "#gmaps-error"})).apply() // default errorField is "#gmaps-error"
+GmapErrors.wrongInputText = "Sorry, something went wrong. Try again!"
+GmapErrors.incorrectLatLngText = "Woah... that's pretty remote! You're going to have to manually enter a place name."
+GmapErrors.incorrectAddressText = function(value){"Sorry! We couldn't find " + value + ". Try a different search term, or click the map."}
+```
 
 ## Contributing
 

data/lib/rails-google-maps.rb

@@ -0,0 +1,2 @@
+require "rails-google-maps/version"
+require "rails-google-maps/rails" if defined?(Rails)

data/lib/{rails_google_maps.rb → rails-google-maps/rails.rb}

@@ -1,5 +1,3 @@
-require "rails_google_maps/version"
-
 module RailsGoogleMaps
   module Rails
     class Engine < ::Rails::Engine

data/lib/{rails_google_maps → rails-google-maps}/version.rb

@@ -1,3 +1,3 @@
 module RailsGoogleMaps
-  VERSION = "0.0.11"
+  VERSION = "0.0.12"
 end

data/{rails_google_maps.gemspec → rails-google-maps.gemspec}

@@ -1,7 +1,7 @@
 # -*- encoding: utf-8 -*-
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'rails_google_maps/version'
+require 'rails-google-maps/version'
 
 Gem::Specification.new do |gem|
   gem.name          = "rails-google-maps"
@@ -12,12 +12,11 @@ Gem::Specification.new do |gem|
   gem.summary       = 'Provides simple way to add google maps to your app'
   gem.homepage      = 'http://github.com/yratanov/rails_google_maps'
 
-  gem.files        = `git ls-files`.split("\n")
+  gem.files        = `git ls-files`.split($/)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ['lib']
 
   gem.add_dependency 'rails', '~>3.0'
   gem.add_dependency 'jquery-rails'
-  gem.add_dependency 'railties', '~> 3.1'
 end

data/vendor/assets/javascripts/autocomplete.js.coffee

@@ -52,7 +52,7 @@ class root.GmapAutocomplete extends Autocomplete
     self = this
     $(@selector).bind 'keydown', (event)->
       if event.keyCode == 13
-        self.gmap.geocodeLookup  'address', $(self.selector).val(), true
+        self.gmap.geocodeLookup  'address', $(self.selector).val()
         $(self.selector).autocomplete "disable"
       else
         $(self.selector).autocomplete "enable"

data/vendor/assets/javascripts/{gmaps.js.coffee → rails_google_maps.js.coffee}

@@ -11,6 +11,8 @@ class root.GoogleMap
 
   #defines whether user can change map pin or not
   immutable = false
+  mapSelector = "#gmaps-canvas"
+  errorField = "#gmaps-error"
 
   _applied: false
 
@@ -22,10 +24,12 @@ class root.GoogleMap
 
   # options: object options
   # gmapOptions: google map api options
-  constructor: (options = {}, gmapOptions = {}, @mapSelector = "#gmaps-canvas", @errorField = '#gmaps-error')->
+  constructor: (options = {}, gmapOptions = {})->
     @gmapOptions = $.extend {}, GoogleMap.defaultGmapOptions, gmapOptions
     @immutable = true if options['immutable']
-    if options['saveLatLang']
+    @mapSelector = options['selector'] if options['selector']
+    @errorField = options['errorField'] if options['errorField']
+    if options['longitudeInput'] and options['latitudeInput']
       @saveLangLat = true
       @longitudeInput = options['longitudeInput']
       @latitudeInput = options['latitudeInput']
@@ -48,7 +52,7 @@ class root.GoogleMap
   applied: ()->
     @_applied
 
-  geocodeLookup: (type, value, update = false)->
+  geocodeLookup: (type, value, update = true)->
     request = {}
     request[type] = value
     self = this
@@ -63,10 +67,10 @@ class root.GoogleMap
     self = this
     return if @immutable
     google.maps.event.addListener @marker, 'dragend', () ->
-      self.geocodeLookup 'latLng', self.marker.getPosition()
+      self.geocodeLookup 'latLng', self.marker.getPosition(), false
     google.maps.event.addListener @map, 'click', (event) ->
       self.marker.setPosition event.latLng
-      self.geocodeLookup 'latLng', event.latLng
+      self.geocodeLookup 'latLng', event.latLng, false
 
   _succeed: (results, update)->
     if results[0]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-google-maps
 version: !ruby/object:Gem::Version
-  version: 0.0.11
+  version: 0.0.12
   prerelease: 
 platform: ruby
 authors:
@@ -43,22 +43,6 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: railties
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '3.1'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '3.1'
 description: Provides simple way to add google maps to your app
 email:
 - yratanov@gmail.com
@@ -71,12 +55,12 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- lib/rails_google_maps.rb
-- lib/rails_google_maps/version.rb
-- rails_google_maps.gemspec
+- lib/rails-google-maps.rb
+- lib/rails-google-maps/rails.rb
+- lib/rails-google-maps/version.rb
+- rails-google-maps.gemspec
 - vendor/assets/javascripts/autocomplete.js.coffee
-- vendor/assets/javascripts/gmaps.js.coffee
-- vendor/assets/javascripts/test.js
+- vendor/assets/javascripts/rails_google_maps.js.coffee
 homepage: http://github.com/yratanov/rails_google_maps
 licenses: []
 post_install_message: