Ruby Geocoding Quick Start Guide - XLRoutes

Installation

When you sign up with XLRoutes on Heroku, you will be provided with a unique username and password that you can use when configuring your proxy service in your application:

http://username:password@proxy.xlroutes.com:9292

We recommend you store the connection string in an environment variable xlroutes_URL to maintain compatibility with platforms like Heroku.

You can test your proxy setup using curl:

$ curl -x username:password@proxy.xlroutes.com:9292 http://www.google.com/

Integration

Ruby Geocoder is the leading geocoding solution for Ruby and Rails and works seamlessly with XLRoutes.

Simply add your authenticated connection string in to the geocoder initializer.

# config/initializers/geocoder.rb
Geocoder.configure(
...
:http_proxy => ENV["xlroutes_URL"],
:timeout => 5 
)