Project

geo_rb

0.0
No commit activity in last 3 years
No release in over 3 years
geo_rbkucho/geo_rbHomepageDocumentationSource CodeBug TrackerWiki
geo_rb makes it easy for Ruby developers to locate the coordinates of addresses, cities, countries, and landmarks across the globe using third-party geocoders.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
3,881
Stars
5
Forks
0
Watchers
2
 Releases
Current version
0.0.2
Total releases
2
First release
2021-04-15
Latest release
2021-04-20
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2021-04-19
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 2.2
rspec
~> 3.10
standardrb
~> 1.0

Runtime

concurrent-ruby
~> 1.1.8
geodesic_wgs84
~> 1.46.1
 Project Readme

geo_rb

geo_rb makes it easy for Ruby developers to locate the coordinates of addresses, cities, countries, and landmarks across the globe using third-party geocoders.

It is heavily inspired by geopy.

Install

gem install geo_rb

Usage

Location lookup

Basic example:

GeoRb::Location.lookup("Plaza San Martin, Lima, Peru")
# [#<GeoRb::Location:0x000000015b3a9fb0 @address="Plaza San Martín, Avenida Nicolás de Pierola, Lima, LIMA 01, Perú", @point=#<GeoRb::Point:0x000000014b0769e8 @latitude=-12.05165965, @longitude=-77.03460482707533, @altitude=0.0>, @raw={:place_id=>101994693, :licence=>"Data © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright", :osm_type=>"way", :osm_id=>44364378, :boundingbox=>["-12.0523471", "-12.050949", "-77.035317", "-77.0338948"], :display_name=>"Plaza San Martín, Avenida Nicolás de Pierola, Lima, LIMA 01, Perú", :class=>"tourism", :type=>"attraction", :importance=>0.631409003314806, :icon=>"https://nominatim.openstreetmap.org/ui/mapicons//poi_point_of_interest.p.20.png", :latitude=>-12.05165965, :longitude=>-77.03460482707533}>]

It is possible to specify search options (WIP doc).

Distance from A to B

plaza = GeoRb::Location.lookup("Plaza San Martin, Lima, Peru")
palacio = GeoRb::Location.lookup("Palacio de Justicia, Lima, Peru")
plaza.distance_to(palacio).km # => 0.6649563608870949
palacio.distance_to(plaza).km # => 0.6649563608870949

Distance between multiple points

.between makes concurrent requests. However, it is not possible to specify options for each individual search.

GeoRb::Distance.between("Plaza San Martin, Lima", 
                        "Palacio de Justicia, Lima", 
                        "Jockey Plaza, Lima").km
# => 0.7775e1