The maptastic plugin for Ruby on Rails provides simple and unobtrusive helper methods and javascript libraries to integrate maps in web applications.
Maptastic currently only works with Google Maps and Prototype. This might change in the future but for now that’s how it is.
To install the maptastic gem, simply add it to your Gemfile:
gem 'maptastic'
In order to get the latest development version of maptastic:
gem 'maptastic', :git => 'git://github.com/benedikt/maptastic.git'
and run
bundle install
Afterwards you can run the generator to get the necessary files installed into your application
rails generate maptastic:install
To include the required javascripts put these two lines in your application.html.erb
<%= maptastic_provider_tag %> <%= javascript_include_tag 'maptastic' %>
To finalize the installation please set your defaults in config/initializers/maptastic.rb
To configure maptastic to your needs edit the config/initializers/maptastic.rb file.
Read the API documentation at benedikt.github.com/maptastic/doc
Examples (without markers):
<%= maptastic :center => [37.4419, -122.1419] %> <%= maptastic :center => @poi %> # @poi.latitude and @poi.longitude are used
Examples (with markers):
<%= maptastic @poi %> # Simple marker without info window <%= maptastic @pois do |poi| %> Generates a marker with info window (bubble). Uses @poi.latitude and @poi.longitude to position the marker. <%= poi.name %> <% end %>
Available options:
<%= maptastic :center => [37.4419, -122.1419], :zoom => 10; :controls => true %>
Copyright © 2010 Benedikt Deicke. See LICENSE for details.