Tel het hele register in één verzoek

Hoeveel elektrische auto’s van elk merk staan er geregistreerd? Welke gebreken worden het vaakst gevonden bij keuringen? Analytics rekent over alle voertuigen in de open data van de RDW, zonder dat je die eerst downloadt en inlaadt.

Filter op de velden die GET /api/v1/analytics/fields noemt, groepeer op maximaal twee ervan en vraag tot vijf metrieken: gemiddelde, minimum, maximum, som of mediaan.
Datums groepeer je per jaar of per maand, bijvoorbeeld met group_by=first_admission_date:year.
Het register is geen telling van wat er nu rondrijdt: geëxporteerde en uitgeschreven voertuigen tellen ook mee. Met filter[registration_allowed]=true houd je de voertuigen over die op naam gezet kunnen worden (bij de RDW: „tenaamstellen mogelijk”). Of een voertuig de weg op mag, zegt dat veld niet; kijk daarvoor ook naar insured, exported en apk_expiry_date.
Je gebruikt dezelfde API-sleutel als voor bevragingen. Elk antwoord telt als één analytics-vraag; de velden opvragen is gratis.

Verzoek

GET /api/v1/analytics/vehicles
  ?filter[fuels.fuel]=Elektriciteit
  &group_by=make
  &metrics=avg:catalog_price
  &limit=3

Antwoord

{
  "data": {
    "count": 612480,
    "metrics": { "avg:catalog_price": 48210 },
    "groups": [
      { "key": "TESLA", "count": 98213, "metrics": { "avg:catalog_price": 56940 } },
      { "key": "KIA", "count": 61027, "metrics": { "avg:catalog_price": 44380 } },
      { "key": "VOLKSWAGEN", "count": 52880, "metrics": { "avg:catalog_price": 47120 } }
    ],
    "other_count": 400360
  },
  "meta": { "schema_version": "analytics.v1", … }
}

Voorbeeld: de aantallen en bedragen zijn verzonnen.

Filteren, groeperen en meten

Analytics heeft een eigen lijst van velden om op te filteren, te groeperen en te meten. De namen zijn de veldnamen per dataset, dezelfde als field in de feed en de kolommen in de snapshots. Velden uit een gekoppelde dataset beginnen met de naam van die dataset, zoals fuels.fuel of defects.defect_code. Een bevraging deelt dezelfde velden in secties in en noemt ze daar anders; de tabel hieronder zet de meest gebruikte naast elkaar.

Grenzen van één verzoek

Tot twee niveaus in group_by, de buitenste eerst, zoals make,trade_name.
Tot 100 groepen per niveau met limit, standaard 20, de grootste eerst. other_count telt wat buiten de grens valt.
Tot 50 waarden per filter, gescheiden door komma’s, zoals filter[make]=TESLA,KIA.
Per maand groeperen kan over maximaal 120 maanden, met een filter op die datum met een begin en een eind.

Kenmerken: Filter op één of meer waarden en groepeer per waarde. Ja/nee-velden nemen true of false.; make

trade_name

vehicle_type

body_style

primary_color

secondary_color

european_vehicle_category

fuel_efficiency_class

odometer_judgement

insured

exported

taxi

open_recall

registration_allowed

fuels.fuel

fuels.emission_code

fuels.hybrid_class

bodies.body_type_description

recalls.recall_code

recalls.status

defects.defect_code

defects.approval_type
Datums: Filter op een periode met gte, gt, lte of lt, en groepeer per jaar of per maand.; first_admission_date

first_registration_nl_date

registration_date

apk_expiry_date

defects.report_date
Getallen: Filter op een bereik en meet met avg, min, max, sum of median, zoals metrics=median:catalog_price.; catalog_price

gross_bpm

empty_mass

curb_mass

max_mass

displacement

cylinders

seats

doors

length

width

wheelbase

power_to_mass_ratio

fuels.co2_combined_wltp

fuels.fuel_consumption_combined_wltp

fuels.electric_range_electric_only_wltp

fuels.net_max_power_electric

Dezelfde velden in een bevraging

Analytics	Bevraging (`vehicle.v1`)
make	vehicle.make
trade_name	vehicle.model
catalog_price	vehicle.fiscal.catalog_price_eur
gross_bpm	vehicle.fiscal.gross_bpm_eur
first_admission_date	registration.first_admission_date
apk_expiry_date	inspections.apk.expiry_date
registration_allowed	status.registration_allowed
fuels.fuel	environment.fuels[].type
fuels.co2_combined_wltp	environment.fuels[].emissions.co2.combined_wltp_g_per_km
defects.defect_code	inspections.reports[].defects[].code

Bedragen zijn getallen in euro’s, in analytics en in bevragingen. In een bevraging staat de eenheid in de naam (_eur, _kg, _cm); in analytics niet.

Wat keurmeesters vinden

GET /api/v1/analytics/defects telt de gebreken die bij keuringen zijn gevonden, standaard per gebrekcode, met de omschrijving en het artikelnummer uit de nieuwste versie van de catalogus van de RDW.

Naast het aantal gebreken krijg je bij elke groep het aantal verschillende voertuigen waarop ze zijn gevonden. Filter op merk, model of de datum van de melding, of groepeer per merk om merken te vergelijken.