Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Extends geokit and gives convenient helpers for adding google maps to your application.
branch: master

This branch is 61 commits ahead of chrislo:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
.gitignore
Gemfile
MIT_LICENSE.txt
README.md
Rakefile
google_map.gemspec

README.md

GoogleMap

A RubyGem that and makes generating google maps easy as pie.

INSTALL

In your Gemfile, add the following dependency: gem 'google_map' Run: $ bundle install

CONFIGURATION

Set your Google Maps API Key in environment.rb (or somewhere else if you'd prefer) I'd suggest copying the configuration code out of your environment.rb and into an initializer named geokit This key is good for localhost:3000, signup for more at http://www.google.com/apis/maps/signup.html

GOOGLE_APPLICATION_ID = "ABQIAAAA3HdfrnxFAPWyY-aiJUxmqRTJQa0g3IQ9GZqIMmInSLzwtGDKaBQ0KYLwBEKSM7F9gCevcsIf6WPuIQ"

Usage

MAP CONTROLS

maps_controller.rb class MapsController < ApplicationController def show @map = GoogleMap::Map.new

        # define control types shown on map
        @map.controls = [ :large, :scale, :type ]
        # valid controls options include
        # :large 
        # :small 
        # :overview
        # :large_3d
        # :scale
        # :type
        # :menu_type
        # :hierachical_type
        # :zoom
        # :zoom_3d
        # :nav_label

        # allow user to double click to zoom
        @map.double_click_zoom = true

        # not certain what this does
        @map.continuous_zoom = false

        # allow user to scroll using mouse wheel?
        @map.scroll_wheel_zoom = false

    end
end

MAP CENTERING AND ZOOM

maps_controller.rb class MapsController < ApplicationController def show @map = GoogleMap::Map.new @map.center = GoogleMap::Point.new(47.6597, -122.318) #SEATTLE WASHINGTON @map.zoom = 10 #200km end end

MAP CENTERING USING BOUNDS

maps_controller.rb class MapsController < ApplicationController def show @map = GoogleMap::Map.new @map.bounds = [GoogleMap::Point.new(47.6597, -121.318), GoogleMap::Point.new(48.6597, -123.318)] #SEATTLE WASHINGTON 50KM end end

SIMPLE MARKER USAGE

maps_controller.rb class MapsController < ApplicationController def show @map = GoogleMap::Map.new @map.markers << GoogleMap::Marker.new( :map => @map, :lat => 47.6597, :lng => -122.318, :html => 'My House') end end

maps/show.html.erb <%= @map.to_html %>

<%= @map.div %>

Advanced Marker Usage

Available icon classes:

  • GoogleMap::LetterIcon.new(@map, 'A') # letter must be uppercase
  • GoogleMap::SmallIcon.new(@map, 'yellow')

maps_controller.rb class MapsController < ApplicationController def show @map = GoogleMap::Map.new @map.markers << GoogleMap::Marker.new( :map => @map, :icon => GoogleMap::SmallIcon.new(@map, 'blue'), :lat => 47.6597, :lng => -122.318, :html => 'My House', :marker_icon_path => '/path/to/image', :marker_hover_text => 'String to show on Mouse Over', :open_infoWindow => true #opens marker by default )

    end
end

maps/show.html.erb <%= @map.to_html %>

<%= @map.div %>

PLOTTING POLYLINE ROUTES

maps_controller.rb class MapsController < ApplicationController def show @map = GoogleMap::Map.new

        # plot points for polyline
        vertices = []
        object.gpxroute.gpxtrackpoints.each do |p|
          vertices << GoogleMap::Point.new(p.lat, p.lon)
        end

        # plot polyline
        @map.overlays << GoogleMap::Polyline.new(   :map => @map, 
                                                    :color=>'#FF0000', 
                                                    :weight=>'2', 
                                                    :opacity=>'.5', 
                                                    :vertices=>vertices
                                                    )
    end
end

maps/show.html.erb <%= @map.to_html %>

<%= @map.div %>
Something went wrong with that request. Please try again.