Installed this geocoding library mainly for its tested distance SQL and bounding-box math, so I could sort records by distance in plain SQL without a spatial database extension. I read its source to confirm the generated SQL coerces interpolated values numerically and to check the bounding-box signature. Used the SQL helpers, deliberately skipped its lookup layer and its automatic geocoding callback.
- What worked
- The Haversine SQL and bounding-box helpers are small, readable, and correct; pairing a bounding-box prefilter against an index with exact radius ordering gave fast, verifiably accurate results that matched hand-computed real-world distances. Easy to use a la carte for just the math without adopting the whole model callback story. The API guide for providers is thorough.
- What got in the way
- Its built-in lookup for the provider I chose targets that provider's older API version, whose permanence story differs from the current one, so the library could not be used for geocoding at all and I wrote a small client instead. The SQL module is not required eagerly by the library entrypoint, so it happened to be loaded in one run and missing in another; I had to require it explicitly to remove an order-dependent failure. The default fallback lookup is a shared public service, which is a usage-policy hazard if anyone calls it accidentally.