How alexreisner/geocoder works
Geocoder is a Ruby geocoding library: users submit addresses, coordinates, or IPs; the library selects a lookup service, returns normalized results, and can integrate geocoding and spatial queries with application models. The graph also captures caching, request-IP lookup, command-line use, and database-backed queries. Provider adapters and result classes are represented as families to avoid cataloguing dozens of individual services. Relationships involving unsampled modules are omitted or marked unverified; documented capabilities are identified with README evidence.
Main entry points: active_record.rb ActiveRecord scopes · geocoder.rb Geocoder search · lookups Provider adapters · lookup.rb Lookup dispatch
Components 18
Search and Results
- Geocoder search
lib/geocoder.rb - Query classification
lib/geocoder/query.rb - Lookup dispatch
lib/geocoder/lookup.rb
Lookup Providers
- Provider adapters
lib/geocoder/lookups - Provider results
lib/geocoder/results
Models and Queries
- Geo calculations
lib/geocoder/calculations.rb - Model geocoding
lib/geocoder/models - ActiveRecord scopes
lib/geocoder/stores/active_record.rb - Spatial SQL
lib/geocoder/sql.rb
Configuration and Support
- Lookup configuration
lib/geocoder/configuration.rb - Lookup cache
lib/geocoder/cache.rb - Cache backends
lib/geocoder/cache_stores - Request IP lookup
lib/geocoder/request.rb - Command line
lib/geocoder/cli.rb
Other components
- Application user
- Geocoding APIs
- Application database
- HTTP request
Connections 19
- Application user → Geocoder search: submits query
- Geocoder search → Query classification: creates query
- Query classification → Lookup dispatch: selects lookup
lib/geocoder/query.rb - Lookup dispatch → Provider adapters: dispatches to
- Provider adapters → Geocoding APIs: requests geocoding
- Provider adapters → Provider results: normalizes results
- Provider results → Application user: returns location data
- Application user → Model geocoding: configures geocoding
- Model geocoding → Application database: stores coordinates
- Application user → ActiveRecord scopes: runs spatial queries
- ActiveRecord scopes → Geo calculations: computes query geometry
lib/geocoder/stores/active_record.rb - ActiveRecord scopes → Spatial SQL: builds spatial SQL
lib/geocoder/stores/active_record.rb - ActiveRecord scopes → Application database: queries records
- Lookup configuration → Lookup dispatch: configures services
- Geocoder search → Lookup cache: uses caching
- Lookup cache → Cache backends: uses backend
- HTTP request → Request IP lookup: provides client IP
- Request IP lookup → Geocoder search: looks up IP
- Application user → Command line: runs lookup