Vejledninger: Enheder

Enheder

Motorbay leverer Motorstyrelsens tal i de enheder, de er registreret i: kg, mm, kW, cm³, km/t, km/l, g/km, Wh/km, mg/km og kilometerstanden i tusinder af km. Hvert felts enhed står i API-referencen. Vil du hellere have pund, tommer, miles per gallon eller hestekræfter, så bed om dem, og hvert svar med en målt værdi får et converted-objekt ved siden af de rå felter.

Bed om britiske enheder

curl -H "X-Api-Key: $MOTORBAY_API_KEY" \
  "https://api.motorbay.app/v1/vehicles/9000000006320919/engine?units=imperial&power=hp"

json

{
  "maximumPower": 100,
  "displacement": 1998,
  "odometerReading": 228,
  "converted": {
    "maximumPower": { "value": 134.1, "unit": "hp" },
    "displacement": { "value": 121.9, "unit": "in3" },
    "odometerReading": { "value": 141.7, "unit": "thousandMi" }
  }
}

Forkortet. De rå felter ændrer sig aldrig: maximumPower er kW, uanset hvad du beder om. converted har hvert felt med en enhed, hver som { "value", "unit" }, så du aldrig skal gætte, hvilken enhed et tal er i. En værdi, der ikke er registreret, er { "value": null, "unit": "lb" }.

Parametrene

Parameter	Værdier	Standard
`units`	`metric`, `imperial`	`metric`
`power`	`kw`, `hp`	`kw`
`mpg`	`us`, `uk`	`us`, og kun med `units=imperial`

Uden nogen af dem, eller med units=metric, er svaret det samme, som det altid har været, uden converted.
power virker med begge systemer: units=metric&power=hp beholder kg og km og giver effekten i hestekræfter (hp).
En værdi, der ikke står i tabellen, eller mpg uden units=imperial, giver 400 med koden ValidationFailed og UnitsInvalid i errors.

De virker på /engine, /technical-details, /environmental-information, /inspection og /fuel-types og på opslagene på køretøjer (/v1/vehicles/{id}, /plate/{plate}, /vin/{vin} og /lookup/{plateOrVin}) for de dele, include tilføjer.

Hvad der bliver omregnet

Felter	Registreret i	Med `units=imperial`
Vægte og akseltryk på `/technical-details`	kg	`lb`
Akselafstand og sporvidder	mm	`in`
Tophastighed	km/t	`mph`
Slagvolumen	cm³	`in3`
Kilometerstand på `/engine` og `/inspection`	1.000 km	`thousandMi`
Brændstoføkonomi på `/fuel-types`	km/l	`mpgUs`, eller `mpgUk` med `mpg=uk`
CO₂ på `/fuel-types`	g/km	`gPerMi`
Elforbrug	Wh/km	`whPerMi`
CO, HC+NOx, NOx og partikler	mg/km	`mgPerMi`
Største effekt	kW	`hp` med `power=hp`, i begge systemer

Omregnede værdier afrundes halvt væk fra nul, til 1 decimal, og emissioner til 2, fordi partikeltal er små. En værdi, der står i sin rå enhed, fx kw uden power=hp, gives videre som registreret. Støj (dB), omdrejningstal (rpm), røgtæthed og det tunge CO₂-tal i g/tkm bliver ikke omregnet.

To slags hestekræfter

power=hp er mekaniske hestekræfter, 745,7 W: 100 kW er 134,1 hp, det tal man bruger i USA og Storbritannien. horsepower på /v1/vehicles/{vehicleId}/calculated er metriske hestekræfter (hk eller PS), 735,5 W, afrundet til et helt tal: 136 for samme motor, det tal danske og tyske bilannoncer bruger. Begge kommer fra det samme maximumPower, så ingen af dem er forkerte. Vælg det, dine brugere forventer.

Beregnet af Motorbay

Omregnede værdier er beregnet af Motorbay ud fra de rå felter med de nøjagtige definitioner (1 pund er 0,45359237 kg, 1 tomme er 25,4 mm, 1 mile er 1,609344 km, en amerikansk gallon er 3,785411784 l og en britisk 4,54609 l). De står ikke i Motorstyrelsens udtræk. Et kald med enheder tæller som ét kald, det samme som uden.

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