Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Enables easy display of items (taken from a Rails 3 model) with Google Map, OpenLayers, Bing or Mapquest. Geocoding + Directions included. Provides much options: markers customization, infowindows, auto-adjusted zoom, polylines, polygons, circles etc... See wiki for full description and examples.
Ruby CoffeeScript JavaScript

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
config
lib
pkg
public
test
README.rdoc
Rakefile
VERSION
gmaps4rails.gemspec

README.rdoc

Google Maps for Rails (gmaps4rails)

Gmaps4rails is developped to simply create a Google Map (Gmaps) from:

  • model instances (say Users),

  • your own json

It's based on Ruby on Rails 3 Engines and uses Google Maps API V3 with Marker Clusterer in option.

Installation

gem install gmaps4rails

Requirements

  • <%= yield :head %> (in your header)

  • <%= yield :scripts %> (in your footer)

  • config.serve_static_assets = true (in your production.rb)

  • jQuery (used for ajax json, not mandatory if you only use the 'json' option)

Basic configuration

In your model, add:

acts_as_gmappable

def gmaps4rails_address self.address #describe how to retrieve the address from your model end

Create a migration and add the following fields to your table (here users):

add_column :users, :latitude, :float #you can change the name, see wiki add_column :users, :longitude, :float #you can change the name, see wiki add_column :users, :gmaps, :boolean #not mandatory, see wiki

How to?

QuickStart!

Say you have a User model and you want to display all the users on a map. In your view:

<%= gmaps4rails_map(“User”) %>

Done!

Same Result, alternative solution

With this version, you won't need jQuery. In your controller:

@json = User.all.to_gmaps4rails

In your view:

<%= gmaps4rails_map(@json, { "processing" => 'json' }) %>

Done again!

Options

  • Info window

  • Custom Marker

  • Scopes

  • Create from your own json

  • Geocode directly your address and retrieve coordinates.

  • More details in the Wiki

Todo?

Feel free ton contact us, you have your say.

Copyright

MIT license. Authors: Benjamin Roth, David Ruyer

Something went wrong with that request. Please try again.