/geotab

Geotab integration gem

Primary LanguageRubyMIT LicenseMIT

Geotab

Ruby wrapper for the Geotab SDK API inspired by ActiveRecord.

Add this line to your application's Gemfile:

gem "geotab", git: "https://github.com/rarestep/geotab.git", tag: "v0.0.1"

And then execute:

$ bundle

Or install it yourself as:

$ gem install geotab

Usage

Global connection configuration

Geotab.config do |c|
  c.username = "<username>"
  c.password = "<password>"
  c.database = "<database>"
  c.path = "myxx.geotab.com"
end

Geotab::Device.all

Or inline connection

client = Geotab::Client.new
client.authenticate("<username>", "<password>", "<database>")

Geotab::Device.with_connection(client).all

Or inside of a block

client = Geotab::Client.new
client.authenticate("<username>", "<password>", "<database>")

Geotab.with_connection(client) do
  devices = Geotab::Device.all
  fault_data = Geotab::FaultDatum.all
end

Geotab resources are modeled after ActiveRecord models. They have access to .all, .where, .find, and .first. The where method is chainable. Next step is to add support for .update.

# Returns an array of devices
Geotab::Device.all

# Returns a single device
Geotab::StatusDatum.first
Geotab::Diagnostic.find("b1")

# Where clauses are chainable. Conditions should follow Geotab SDK syntax
Geotab::Device.where({"serialNumber" => "G7B020D3E1A4"}).where({"name" => "07 BMW 335i"}).first

# Some resources have associated resources and can be queried as such
device = Geotab::Device.find("b1")

# Returns associated StatusData objects
device.status_data

# Returns device's current GPS location
device.location

=> {:date=>"2015-08-18T19:54:49.063Z", :bearing=>140, :current_state_duration=>"06:04:46.063", :is_device_communicating=>true, :is_driving=>false, :latitude=>33.511528, :longitude=>-86.8136673, :speed=>0.0}

Contributing

  1. Fork it ( https://github.com/[my-github-username]/geotab/fork )
  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 a new Pull Request