How to install RGeo with GEOS on Ubuntu?

Install GEOS via apt with 'sudo apt install libgeos-dev', then add the rgeo gem to your Gemfile. For detailed steps, refer to the Installing GEOS documentation in the README. On other systems, you may need to build from source or use package managers.

RGeo vs PostGIS for Ruby projects?

RGeo is a client-side Ruby library for in-app geospatial processing, while PostGIS is a server-side database extension. They are often used together via adapters; RGeo handles geometric objects in Ruby code, and PostGIS manages spatial queries in PostgreSQL. For pure database needs, PostGIS alone might suffice.

How to handle coordinate projections in RGeo?

Use the rgeo-proj4 extension by installing the gem and configuring factories for coordinate transformations. This allows you to work with different geographic projections, as described in the extensions section of the README.

Is RGeo suitable for real-time geospatial applications?

RGeo is efficient for many operations via GEOS integration, but performance can vary with complex geometries. For high-volume real-time processing, benchmark with your specific data and consider caching or optimizing spatial indexes, as it relies on C library calls.

Can I use RGeo with Rails and ActiveRecord?

Yes, via database adapters like activerecord-postgis-adapter for PostGIS. Include the adapter gem in your Rails project and set up spatial columns in migrations, enabling seamless integration for location-aware models, as outlined in the extensions.

What are good alternatives to RGeo for Ruby?

Few comprehensive alternatives exist; RGeo is the primary geospatial library for Ruby. For simpler tasks, consider gems like geokit for basic distance calculations, or use external APIs. For non-Ruby projects, libraries like GeoDjango or Turf.js might be better fits.

How to upgrade RGeo from version 2 to 3?

Follow the upgrade guide in doc/Upgrading-to-v3.md, which includes checking for breaking changes in factories and operations. Review NEWS.md for an overview and test thoroughly in development, as version 3 introduces significant updates that may affect existing code.

Open-Awesome

rgeo

NOASSERTIONRuby

A Ruby geospatial data library implementing OGC Simple Features for modeling and analyzing location data.

Visit Website GitHub

1.1k stars159 forks0 contributors

What is rgeo?

RGeo is a geospatial data library for Ruby that implements the OGC Simple Features Specification. It provides data representations of geometric objects like points, lines, and polygons along with spatial analysis operations, enabling developers to build location-aware applications and handle geolocation data effectively.

Target Audience

Ruby developers building applications that require geospatial data processing, such as mapping services, location-based analytics, GIS tools, or any software needing geometric calculations and spatial relationships.

Value Proposition

Developers choose RGeo because it offers a comprehensive, standards-compliant geospatial toolkit specifically for Ruby, with support for spherical geometry, projections, and seamless integration with spatial databases through its extension ecosystem.

Overview

Geospatial data library for Ruby

Use Cases

Best For

Building location-aware Ruby applications with geometric data modeling
Performing spatial analysis operations like intersections and buffering
Handling spherical geometry and geographic projections in Ruby
Reading and writing WKT/WKB data formats for spatial databases
Integrating geospatial functionality with ActiveRecord via PostGIS/MySQL adapters
Processing GeoJSON and ESRI shapefiles in Ruby environments

Not Ideal For

Applications requiring only basic latitude/longitude storage without geometric analysis or spatial operations
Development environments where installing system-level C libraries like GEOS is restricted or problematic
Teams heavily invested in non-Ruby stacks or needing cross-language geospatial interoperability without Ruby integration
Projects on Windows without prior experience in setting up FFI or native extensions, as indicated by the need for ffi-geos

Pros & Cons

Pros

OGC Standards Compliance

Implements the industry-standard OGC Simple Features Specification for geometric objects and operations, ensuring interoperability with spatial databases and tools, as highlighted in the core features.

Comprehensive Spatial Analysis

Supports a wide range of operations like intersections, buffering, and length/area calculations, making it suitable for complex geospatial applications, directly from the summary.

Spherical Geometry Support

Correctly handles spherical geometry and geographic projections for map display and analysis, essential for accurate geolocation data, as noted in the key features.

Extensible Ecosystem

Offers optional add-on modules for Proj4, GeoJSON, shapefiles, and database adapters, enhancing functionality for specific use cases, detailed in the extensions section.

Cons

System Dependency Hassles

Requires installation of external C libraries like GEOS and potentially Proj4, which can be challenging on some platforms, as admitted in the dependencies section with notes for Windows and JRuby.

JRuby Limitations

Only partial support for JRuby, with features like CAPI unavailable and reliance on ffi-geos, limiting its effectiveness in JVM-based Ruby environments.

Breaking Changes Complexity

Version 3.0 introduces breaking changes requiring a dedicated upgrade guide, which can cause migration headaches and additional maintenance overhead for existing projects.

Extension Maintenance Gaps

Some extensions, such as the activerecord-spatialite-adapter, are explicitly noted as not maintained, leading to potential compatibility and support issues over time.

Frequently Asked Questions

Related Projects

Geocoder

Complete Ruby geocoding solution.

Stars6,446

Forks1,198

Last commit1 month ago

Google Maps for Rails

Enables easy Google map + overlays creation in Ruby apps

Stars2,248

Forks375

Last commit8 years ago

Geokit

Official Geokit Gem. Geokit gem provides geocoding and distance/heading calculations. Pair with the geokit-rails plugin for full-fledged location-based app functionality.

Stars1,626

Forks358

Last commit2 years ago

geoip

The Ruby gem for querying Maxmind.com's GeoIP database, which returns the geographic location of a server given its IP address

Stars723

Forks82

Last commit7 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub