Vejledninger: Køretøjsstatistik

Køretøjsstatistik

Tæl køretøjer med ét kald: hvor mange der passer på et sæt filtre, og hvordan de fordeler sig på mærke, art, anvendelse, farve, modelår eller registreringsstatus.

Tæl indregistrerede personbiler pr. mærke

curl -H "X-Api-Key: $MOTORBAY_API_KEY" \
  "https://api.motorbay.app/v1/statistics/vehicles?kindId=1&registrationStatus=registered&groupBy=make&limit=3"

Svaret, forkortet og med opdigtede tal:

json

{
  "total": 2734520,
  "groupCount": 312,
  "groups": [
    { "make": { "id": "10", "name": "VOLKSWAGEN", "originalName": "VOLKSWAGEN" }, "count": 331208 },
    { "make": { "id": "34", "name": "TOYOTA", "originalName": "TOYOTA" }, "count": 222914 },
    { "make": { "id": "41", "name": "PEUGEOT", "originalName": "PEUGEOT" }, "count": 187455 }
  ]
}

kindId=1 er id'et for personbiler i GET /v1/kinds. Find de id'er, du skal bruge, dér og i /v1/makes, /v1/usages og /v1/colors.

Filtre

Filtrene er de samme som i køretøjssøgningen, GET /v1/vehicles, og betyder det samme:

Parameter	Beholder
`makeId`, `kindId`, `usageId`, `colorId`	Køretøjer med det mærke, den art, den primære anvendelse eller den farve
`fromModelYear`, `toModelYear`	Modelår i intervallet, begge ender med. Køretøjer uden modelår er ikke med
`registrationStatus`	`registered`, `deregistered`, `unknown` eller `pending`, stavet som et køretøjs `registrationStatus`

registrationStatus virker også i køretøjssøgningen: GET /v1/vehicles?registrationStatus=registered viser kun indregistrerede køretøjer.

Gruppering

groupBy tager et eller to af make, kind, usage, color, modelYear og registrationStatus, adskilt med komma. To felter giver én gruppe pr. kombination: groupBy=make,modelYear tæller hvert mærke pr. modelår.

Hver gruppe har kun de felter, den er grupperet efter, og count. Mærker, arter, anvendelser og farver kommer som { "id", "name", "originalName" }, ligesom på et køretøj.
Et grupperet felt er null for de køretøjer, der ikke har en værdi, for eksempel køretøjer uden registreret farve. De er deres egen gruppe.
Grupperne kommer med den største count først. Grupper med samme antal står i samme rækkefølge hver gang.
limit bestemmer, hvor mange grupper du får, fra 1 til 1000, og 50, hvis du udelader den.
total tæller alle køretøjer, der passer på filtrene, og groupCount alle grupper, også dem efter limit.

Uden groupBy er svaret kun totalen, med "groups": [].

Hvad tallene beskriver

Tallene kommer fra det ugentlige udtræk af Motorstyrelsens DMR-register, som vi har indlæst. De er præcise for det udtræk og svarer til den totalCount, køretøjssøgningen giver for de samme filtre. De er ikke et levende billede af registret. Headeren Motorbay-Data-As-Of på svaret fortæller, hvilket udtræk de kommer fra, som på alle svar, og de ændrer sig først, når det næste udtræk er indlæst. Motorbay er ikke tilknyttet Motorstyrelsen.

Forbrug og fejl

Ét kald er én forespørgsel på din grænse pr. minut og din månedlige kvote, uanset hvor mange grupper det giver.

Status	Kode	Hvornår
400	`GroupByInvalid`	Et felt i `groupBy` er ikke et af de seks, eller det samme felt står der to gange
400	`GroupByTooMany`	`groupBy` nævner tre eller flere felter
400	`LimitOutOfRange`	`limit` er under 1 eller over 1000
400	`RegistrationStatusInvalid`	`registrationStatus` er ikke en af de fire værdier

De kommer som problem details med koden i errors, ligesom alle andre valideringsfejl.

Fandt du ikke svaret? Skriv til support@motorbay.app.