Geocoder (Ruby)
≈ 5 min read
Names in other languages
No names in other languages are held for this entry yet.
Article bodies are English and are not machine-translated. A name in another language is not a translation of the article.
Geocoder is a geocoding library for Ruby. Geocoding helps to enhance webpages by presenting location relevant information to the user. When used with Rails, Geocoder adds geocoding functionality such as finding coordinates with street addresses or vice versa in addition to distance calculations for ActiveRecord objects.[1] Since the functionality does not rely on proprietary database functions, finding different geocoded objects in an area works out-of-the-box for databases like MySQL, PostgreSQL and SQLite.[1]
Compatibility
edit edit sourceGeocoder has been fully tested with Ruby 1.8.7, 1.9.2, and JRuby 1.5.3.[1]
Geocoder is compatible with Rails 3, but there is only limited functionality with Rails 2.[1]
Installation
edit edit sourceThe Prerequisites to installing Geocoder are Ruby and RubyGems.
Geocoder gem can be installed with the following command:
gem install geocoderOr, if you're using Bundler for Rails, you may add this to your Gemfile:[1]
gem 'geocoder'and run at the command prompt:[2]
bundle installIt can be used as a plugin with rails too:[1]
rails plugin install git://github.com/alexreisner/geocoder.gitConfiguration
edit edit sourceIn order to use Geocoder with objects, the project must be set up as follows:
Required attributes
edit edit sourceActiveRecord
edit edit sourceIn order to use Geocoding with ActiveRecord objects, they must have two additional attributes, latitude and longitude coordinates.[1] When stored in the table they should be called latitude and longitude but they may be changed as explained below. When using reverse geocoding (translating a user's location coordinates into a physical address), the model must implement a method that returns an address.[3] The address may be a single attribute; however, it can also be a method which returns a string assembled from different attributes such as city, state, and country.[1]
Mongoid
edit edit sourceWhen using Mongoid, the model only needs to add the address, latitude and longitudes as fields. The model must also include Geocoder::Model::Mongoid before making any calls to the geocoded_by: method. [1]
Model behavior
edit edit sourceIn the rails model, Geocoder must be told which method returns the object's full address:[1]
geocoded_by :full_street_address # can also be an IP address after_validation :geocode # auto-fetch coordinatesFor reverse geocoding, Geocoder must know which method returns latitude and longitude coordinates. If :address option is not provided, it fetches the address automatically in the address attribute. Else, it fetches the address into the location attribute like the example given below.[1]
reverse_geocoded_by :latitude, :longitude, :address => :location after_validation: reverse_geocode # auto-fetch addressForward and Reverse Geocoding on the same model is possible.[1]
geocoded_by :address reverse_geocoded_by :latitude, :longitude after_validation :geocode, :reverse_geocodeIn order to use different names for latitude and longitude in the model, the following change may be done when implementing geocoded_by:[1]
geocoded_by :address, :latitude => :lat, :longitude => :lonAdditionally, the address method may return any string that would be used to search Google Maps.[1] Any of the following examples will work:
- "123 Sample St, New York, NY"
- "Eiffel Tower, Paris, FR"
- "Raleigh, NC, US"
Services
edit edit sourceBy default, Geocoder makes use of Google's geocoding API to retrieve addresses and coordinates. Currently, these address geocoding services are supported:
Examples
edit edit sourceHere are some examples[5] to demonstrate Geocoder functionality:
Hotel.near("Raleigh, North Carolina")Finds hotels near Raleigh.
@restaurant.distance_to("Empire State Building")Finds the distance from @restaurant to the Empire State Building.
Applications
edit edit source- Developers may also use Geocoder to convert a user's IP address to their city location. By making such a conversion you may be able to offer user's content relevant to their current location without requiring to ask for it beforehand.[6]
- It may be used for geospatial analysis in order to recognize patterns within the information. This is very useful in data mining applications.
- Web-based GIS tools such as Google Maps, Yahoo Maps etc. include geocoding functionality.
References
edit edit source- ^ a b c d e f g h i j k l m n "File: README — Documentation for rails-geocoder (0.9.11)". www.rubydoc.info. Retrieved 2016-01-31.
- ^ "alexreisner/geocoder:Complete ruby geocoding solution". www.github.com.
- ^ a b "The Google Maps Geocoding API". Google Developers. Retrieved 2016-02-13.
- ^ "Yahoo BOSS Geo Services". developer.yahoo.com. Retrieved 2016-02-13.
- ^ "Ruby Geocoder". www.rubygeocoder.com. Retrieved 2016-01-31.
- ^ "Search by location with Geocoder". synbioz.com. Retrieved 2016-02-07.
External links
edit edit sourceText derived from https://en.wikipedia.org/w/index.php?oldid=1374053868 under CC BY-SA 4.0; modifications have been made.