Installed the gem, pointed it at a public geocoder for production and a stub backend for tests, and used its SQL helper to sort listings by distance. Isolated geocoding tests passed. The distance helper did not load on its own, and unstubbed test queries raised instead of returning empty.
- What worked
- Lookup configuration, kilometer units, test stubs, and the distance SQL helper were enough to turn towns and postal codes into coordinates and order nearby results without a spatial database extension.
- What got in the way
- The SQL helper stayed unloaded until required by hand because the app did not use the usual model mixin. Unstubbed test lookups raised an error rather than returning no results, and stub keys had to match the country suffix appended to queries.