/ncapratings

NHTSA NCAP Car Safety Rating API Demo

Primary LanguageCSSMIT LicenseMIT

NCAP Ratings

NHTSA NCAP Car Safety Rating API Demo uses NCAP Car Safety API.

This is a really basic throwaway JQuery / Bootstrap demo to be used as a guide when constructing example apps in:

  • Ionic Framework
  • Titanium Appcelerator
  • React Native
  • React JS
  • NativeScript
  • Ext JS 6

##Working Demo

A working demo can be seen here, note that this is best from a mobile user agent and that the Back and Restart buttons are not functional for the purposes of this demo. These should be included in your implementation and made to work.

Sample Vehicles to try:

  • All data present, has recalls: 2015 Audi A4
  • All data present, no recalls: 2016 Fiat 500
  • Some data missing, has recalls: 2009 Ford Explorer
  • No data, no recalls: 2015 BMW 228i XDrive

##Screen Flow

Allow users to go back to the previous screen, or start over.

##API Implementation Notes

The government does not have CORS on for this API, but it works fine with JSONP.

##Data Items to Show for Each Vehicle

(JSON field names in parentheses)

###Vehicle Name:

  • Model Year (ModelYear)
  • Manufacturer (Make)
  • Vehicle Model (Model)

###Star Ratings:

  • Overall Rating (OverallRating)
  • Front Crash Rating (OverallFrontCrashRating)
  • Side Crash Rating (OverallSideCrashRating)
  • Side Pole Crash Rating (SidePoleCrashRating)
  • Rollover Rating (RolloverRating)

If any of these are not present, the API returns "Not Rated" in place of 1-5.

###Crash Images:

  • Front Crash (FrontCrashPicture)
  • Side Crash (SideCrashPicture)
  • Side Pole Crash (SidePolePicture)

If any of these are not present, they will be undefined in the API - display text instead, for example:

"Side pole crash image unavailable."

###Recalls:

  • Number of recalls (RecallsCount)

Handle case where there are 0, 1, >1 recalls. Use visual warning indication when >0 recalls.

##Example data for 2015 BMW 335i XDrive GT

{
  Count: 1,
  Message: "Results returned successfully",
  Results: [
    {
      OverallRating: "5",
      OverallFrontCrashRating: "4",
      FrontCrashDriversideRating: "4",
      FrontCrashPassengersideRating: "5",
      OverallSideCrashRating: "5",
      SideCrashDriversideRating: "5",
      SideCrashPassengersideRating: "5",
      RolloverRating: "5",
      RolloverRating2: "Not Rated",
      RolloverPossibility: 0.095,
      RolloverPossibility2: 0,
      SidePoleCrashRating: "5",
      NHTSAForwardCollisionWarning: "Optional",
      NHTSALaneDepartureWarning: "Optional",
      ComplaintsCount: 0,
      RecallsCount: 1,
      InvestigationCount: 0,
      ModelYear: 2015,
      Make: "BMW",
      Model: "335I XDRIVE GT",
      VehicleDescription: "2015 BMW 335I Xdrive GT 5 HB AWD",
      VehicleId: 9178
    }
  ]
}

##Example Data with Additional Images and Video - 2016 BMW 328i

{
  Count: 1,
  Message: "Results returned successfully",
  Results: [
    {
      VehiclePicture: "http://www.safercar.gov/staticfiles/DOT/safercar/ncapmedia/images/2016/v07857P076.jpg",
      OverallRating: "5",
      OverallFrontCrashRating: "4",
      FrontCrashDriversideRating: "4",
      FrontCrashPassengersideRating: "5",
      FrontCrashPicture: "http://www.safercar.gov/staticfiles/DOT/safercar/ncapmedia/images/2016/v07857P077.jpg",
      FrontCrashVideo: "http://www.safercar.gov/staticfiles/DOT/safercar/ncapmedia/movies/2016/v07857C019.wmv",
      OverallSideCrashRating: "5",
      SideCrashDriversideRating: "5",
      SideCrashPassengersideRating: "5",
      SideCrashPicture: "http://www.safercar.gov/staticfiles/DOT/safercar/ncapmedia/images/2016/v07858P104.jpg",
      SideCrashVideo: "http://www.safercar.gov/staticfiles/DOT/safercar/ncapmedia/movies/2016/v07858C013.wmv",
      RolloverRating: "5",
      RolloverRating2: "Not Rated",
      RolloverPossibility: 0.095,
      RolloverPossibility2: 0,
      SidePoleCrashRating: "5",
      SidePolePicture: "http://www.safercar.gov/staticfiles/DOT/safercar/ncapmedia/images/2016/v07859P071.jpg",
      SidePoleVideo: "http://www.safercar.gov/staticfiles/DOT/safercar/ncapmedia/movies/2016/v07859C014.wmv",
      ComplaintsCount: 0,
      RecallsCount: 0,
      InvestigationCount: 0,
      ModelYear: 2016,
      Make: "BMW",
      Model: "328I",
      VehicleDescription: "2016 BMW 328 I 4 DR RWD",
      VehicleId: 10450
    }
  ]
}