Project

rdw

0.0
No commit activity in last 3 years
No release in over 3 years
Get Dutch car information from the RDW
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.5
>= 0
~> 3.0.0.beta2
>= 0

Runtime

 Project Readme

Free RDW vehicle information

Build Status Code Climate Dependency Status Dependency Status

This project gets the public available vehicle information from the Dutch RDW. It makes the following attributes available:

  • brand
  • first_color (alias: color)
  • second_color
  • number_of_cylinders
  • cylinder_capacity
  • number_of_seats
  • fuel_efficiency_main_road
  • fuel_efficiency_city
  • fuel_efficiency_combined
  • energy_label
  • bpm (alias: BPM)
  • co2_combined
  • fuel_type
  • stock_price

Configuration (optional)

A configuration is optional, here is an example configuration with explanation in the comments:

RDW.configure do |config|
  # Leave this out of the configuration to not use the cache.
  # This must be a cache object (with read, write and fetch methods).
  config.cache = Rails.cache
  
  # If you are using the cache you can set a custom prefix for cache keys.
  # Default value: rdw_
  config.cache_prefix = 'rdw_data_'
  
  # If set to true, Dutch values will be translated to english.
  # This applies to colors, fuel types and unregistered values
  # For example:
  #   - 'ROOD' will be translated to 'red'
  #   - 'Benzine' will be translated to 'gasoline'
  #   - 'Niet geregistreerd' will be translated to 'unregistered'
  #
  # Default value: false
  config.translate_values = true
end

Add the configuration in the config/initializers folder, name the file rdw.rb (any name will work).

Usage

require "RDW"
@vehicle = RDW::CarInfo.new("9KJT45")
@vehicle.brand #=> FERRARI
@vehicle.energy_label #=> G
@vehicle.first_color #=> ROOD
@vehicle.bpm #=> 82168
@vehicle.number_of_cylinders #=> 12

Notice

There is a rate limit on this api (50,000 per month), more information can be found here: rdw.nl. More details for the service can be found here: [http://www.rdw.nl/SiteCollectionDocuments/Over%20RDW/Naslagwerk/Beschrijving%20dataset%20Voertuigen.pdf].

Contributing

  1. Fork it ( http://github.com/<my-github-username>/rdw/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 new Pull Request