Awesome Open Source
Awesome Open Source

Automatic Link Client

Build Status Gem Version

A wrapper to consume the Automatic API.


Add this line to your application's Gemfile:

gem 'automatic-client'

And then execute:

$ bundle

Or install it yourself as:

$ gem install automatic-client


The API will require an OAuth access_token to retrieve data. You will store this token in an ENV variable inside of the .env file:



require 'automatic/client'

trips = Automatic::Models::Trips.all

# Iterate through the trips
trips.each do |trip|
  puts "trip.user #{trip.user}"
  puts "trip.vehicle #{trip.vehicle}"

  puts "trip.start_location #{trip.start_location.coordinates}"
  puts "trip.start-at #{trip.start_at}"

  puts "trip.end_location #{trip.end_location.coordinates}"
  puts "trip.end_at #{trip.end_at}"

  puts "trip.fuel_cost #{trip.fuel_cost}"
  puts "trip.fuel_cvlume #{trip.fuel_volume}"
  puts "trip.average_mpg #{trip.average_mpg}"
  puts "trip.elapsed_time #{trip.elapsed_time}"

You can also use this data to get aggregate statistics as you see fit.


Automatic will provide an encoded polyline with the path attribute. This gets wrapped around the polylines gem giving us the ability to decode the polyline.

# View a trip
trip = Automatic::Client::Trips.find_by_id('trip-id')
# => #<Automatic::Client::Trip:0x007fa36aa29760 ...>

# Return the proxy object
# => #<Automatic::Client::Polyline:0x007fa36aa399f8 ...>

# Return the array of latitude and longitude parts
#=> [[20,-400]]

Command Line

You can also utilize a few CLI executable scripts that will allow you to:

  • View a table of the data
  • Export your trips to a CSV file

You can read more here.


The supported endpoints are stored in Automatic::Client.routes. This allows you to view all endpoints and generate a url_for the given route. Routes are comprised of either a Uri Template or full path.

require 'automatic'
# => true

# Get the URL for a templated URL with optional params
# => ""

# Add optional parameters to expand into the URL
Automatic::Client.routes.route_for('trips').url_for(page: 1, per_page: 50)
# => ""

# Retrieve the URI Template for a single trip route
trip_route = Automatic::Client.routes.route_for('trip')
# => #<RestlessRouter::Route:0x007f985cb7b280 @name="trip", @path="{id}", @options={:templated=>true}>

# Specify the ID for the single trip route
trip_route.url_for(id: '1234')
# => ""


  • Configuration: Use the ENV or runtime defined configuration options.
  • Connection: Create a connection to the API Host and handle server communication.
  • Request Handling: Make requests to the API Host and handle server communication.
  • Response Handling: Consume the body of the Request and handle accordingly.
  • Error Handling: Ensure the Response error and cast to domain specific models.
  • Response Modeling: Use the Response and cast to domain specific models.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


  • Add Core Extension helpers for different data types
  • Add Serializers for all types (JSON, CSV, PDF)
  • Extract configuration into it's own object. This will allow for class and instance level configurations for things like scopes, access_token, api_host, etc. This is currently handled with global ENV vars.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
ruby (12,870
wrapper (230
api-client (193
automotive (16