Project

geofsh

0.01
No commit activity in last 3 years
No release in over 3 years
Geolocation Form Submission Helper
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 3.2.1
~> 3.1
 Project Readme

Geofsh

Simple gem for implementing HTML5 geolocation in your rails app

Installation

Add this line to your application's Gemfile:

gem 'geofsh'

And then execute:

$ bundle

Or install it yourself as:

$ gem install geofsh

Usage

This gem allows you to easily add latitude and longitude coordinates to form fields. To any form input fields, simply add the element id "latitude" and "longitude" and those fields will automatically be filled with geolocation data. If you would like fields to be hidden when geolocation fails, add the element class "geoloc-hide" to the input field.

To include geofsh geolocation for a specific page, include the geofsh javascript file:

= javascript_include_tag 'geofsh'

An example of using Geofsh with simple_form:

= f.input :geolat, label: "Latitude", input_html: { id: "latitude", class: "geoloc-hide" }
= f.input :geolng, label: "Longitude", input_html: { id: "longitude", class: "geoloc-hide" }

Google maps can easily be incorporated into your rails app using geofsh gem. First, you must include google's javascript api:

= javascript_include_tag "http://maps.google.com/maps/api/js?sensor=false"

To enable google maps in your rails app, simply add a div to your view with the element id 'google-map':

<div id='google-map'/>

Geofsh gem will automatically populate this div with a google map centered on your current latitude and longitude.

Before deploying to production, you must also add 'geofsh.js' to the precompile list in your config/application.rb:

config.assets.precompile += %w(foo bar geofsh.js)

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request