No commit activity in last 3 years
No release in over 3 years
A place field for RailsAdmin that can be used to retrieve and associate a google place or foursquare venue
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 3.0.0
 Project Readme

Gem Version Build Status

Rails Admin Place Field

rails_admin_place_field is a gem that works with rails_admin to provide an easy to use Google Maps interface for displaying and setting geographic coordinates in a model and then performing lookups for associations to a nearby Google Place or Foursquare Venue

Where a latitude and longitude is set on the model, it is indicated by a marker shown on a Google map centered at the marker. The administrator can change the value of these fields by clicking on the desired new location on the map.

Usage

rails_admin_place_field expects that the model will have two attributes, one for latitude and one for longitude of the point represented. To enable rails_admin_place_field, add the gem to your Gemfile. I recommend using the git repo until I release a 1.0.0 version of the gem, however, you can add the RubyGems version if you feel so inclined.

gem "rails_admin_place_field", :git => "git://github.com/thinkclay/rails_admin_place_field.git"

Then, add in your config/initializers/rails_admin.rb initializer:

RailsAdmin.config do |config|
  config.model Place do
    edit do
      label "Geo and Place Info"
      field :latitude, :place
      field :longitude, :hidden
    end
  end
end

Note: The field which is set as a :place field must be the latitude field, not the longitude.

Configuration

For different configurations, rails_admin_place_field can be configured with the following:

  • longitude_field - the name of the longitude field that forms the co-ordinate with the latitude field specified. Defaults to "longitude"
  • google_api_key - if you use a Google Maps API Key, it can be specified here, otherwise the maps will do limited lookups without a key
  • foursquare_api_key - this api will be disabled until a valid key is provided
  • places_api_key - this api will be disabled until a valid key is provided
  • default_latitude - the latitude to center the map shown on if the latitude field is blank. Defaults to 51.5, the latitude of London, UK.
  • default_longitude - the longitude used if the longitude field is blank. Defaults to -0.126, the longitude of London, UK.

A more complicated configuration example:

RailsAdmin.config do |config|
  config.model Place do
    edit do
      field :latitude, :place do
        label "Geo and Place Info"
        longitude_field :longitude
        foursquare_field :foursquare
        gplace_field :gplace
        google_api_key "a1b2c3d4e5f6deadbeef"
        places_api_key "a1b2c3d4e5f6deadbeef"
        foursquare_api_key "a1b2c3d4e5f6deadbeef"
        default_latitude -34.0
        default_longitude 151.0
      end
    end
  end
end

rails_admin_place_field is licensed under the MIT license.

Kudos and credit to beyondthestory for the map_field which gave me the starting point to learn how to make this