Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

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.

Fetching latest commit…

Cannot retrieve the latest commit at this time


Google Maps for Rails (gmaps4rails)

Gmaps4rails is developped to simply create a Google Map:

  • directly from your model,

  • from your own json

It's based on Ruby on Rails 3 Engines and uses Google Maps API V3.

See screencasts here:

When Gmaps4rails finally means Global Maps for Rails

I now want to extend the gem, so it would support other map providers. I intend to add:

  • openlayers

  • mapquest

  • bing


Any help would be appreciated.


  • gem 'gmaps4rails' (in your gemfile, then bundle)

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

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

  • config.serve_static_assets = true (in your production.rb), or run 'rails generate gmaps4rails:install' to copy the JS and CSS assets to your /public folder.

Basic configuration

In your model, add:


def gmaps4rails_address
  #describe how to retrieve the address from your model, if you use directly a db column, you can dry your code, see wiki
  "#{self.street}, #{}, #{}" 

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?


In your controller:

@json = User.all.to_gmaps4rails

In your view:

<%= gmaps4rails(@json) %>



  • Markers with Info window, Custom Picture

  • Automatic sidebar with list of markers

  • Circles, Polylines, Polygons

  • Geocode directly your address and retrieve coordinates.

  • Wrapper for 'Direction', giving instructions to go from point A to point B

  • Auto-adjust the map to your markers

  • Refresh your map on the fly with Javascript (and Ajax)

  • More details in the Wiki


Feel free ton contact us, you have your say.


MIT license.

Authors: Benjamin Roth, David Ruyer

Contributors: Mircea Pricop, Alex Vorobiev

Something went wrong with that request. Please try again.