Viimeisin päivitys: 2025-03-31

Hae tilastotietoja API:n kautta, Hiilidioksidipäästöt grammoina.

Koskee Opter 2024.06.00 ja uudempia versioita. Joitakin toiminnallisia parannuksia on saatavilla, jos käytät Opter 2024.12.00 tai uudempaa versiota.

Tässä Artikkeli

Opter API:n avulla voit nähdä kuljetustesi arvioidun ilmastovaikutuksen hiilidioksidipäästöinä.

Voit ohjelmoida ratkaisun, jossa suoritat API-kutsun Opterin tilastojen API:lle ja esität sitten tilastot haluamallasi tavalla. Voit automatisoida virtauksen niin, että tiedot haetaan Opterista niin usein kuin haluat. API:n palauttamat tiedot ovat "raakadataa"/perusdataa Opterin tietokannasta. Lisätietoa: Tilastotietojen noutaminen API:n kautta.

Edellytykset

Esimerkki

Esimerkkejä noudettavista hiilidioksidipäästötiedoista:

Tilauksen arvioidut hiilidioksidipäästöt perustuvat tilauksen tekohetkellä käytettävissä oleviin tietoihin. Arvioituja hiilidioksidipäästöjä voidaan muuttaa manuaalisesti jälkikäteen.

Kaikki tilauksia koskevat tiedot haetaan, jos asetat includeDeliveries arvoksi "true".

Seuraavat kentät osoitteessa Deliveries ovat merkityksellisiä:

  • Tilauksen arvioidut hiilidioksidipäästöt (automaattisesti lasketut) löytyvät osoitteesta calculatedEmissionForecast.

  • Tilauksen arvioidut hiilidioksidipäästöt (käsin täytetty) löytyvät osoitteesta emissionForecast.

    Jos arvioidut hiilidioksidipäästöt on syötetty manuaalisesti, manuaalisesti syötetty arvo korvaa Opterin laskeman arvon. Tilastojen API:ssä tämä tarkoittaa, että jos sekä emissionForecast että calculatedEmissionForecast on olemassa arvoja, kannattaa käyttää emissionForecast.

Lisätietoa: jäljempänä olevassa taulukossa ja osoitteessa Miten Opter lasketut hiilidioksidipäästöt.

Kuljetuksen lasketut hiilidioksidipäästöt ovat tarkempi laskelma kuin tilauksen lasketut hiilidioksidipäästöt, koska myös tämä laskelma perustuu tietoihin todellisesta ajoneuvosta ja kuljetuksen etäisyydestä. Lisätietoa: Miten Opter lasketut hiilidioksidipäästöt.

Kaikki kuljetuksia koskevat tiedot haetaan, jos asetat includeShipments arvoksi "true".

Seuraavat kentät osoitteessa Shipments ovat merkityksellisiä:

  • Lasketut hiilidioksidipäästöt kuljetusta löytyvät osoitteesta emissionEstimate.

  • Järjestys, johon kuljetus kuuluu, löytyy osoitteesta deliveryId (tilausnumero) .

  • Kuljetukseen liittyvä ajoneuvo löytyy osoitteesta vehicleId.

    Ajoneuvon kutsunumero löytyy osoitteesta vehicleCode ja ajoneuvon nimi osoitteesta vehicleName.

Lisätietoa:: jäljempänä oleva taulukko.

Jos haluat nähdä tilauksen lasketut hiilidioksidipäästöt, ohjelmoi ratkaisu niin, että tilaukseen sisältyvien kuljetusten lasketut hiilidioksidipäästöt lasketaan yhteen. Katso edellä oleva kohta Kuljetuksen lasketut hiilidioksidipäästöt.

Jos halutaan tehdä omia hiilidioksidipäästölaskemia, niihin voi käyttää esimerkiksi seuraavia tietoja:

  • Tilauksen paino ja hinnoittelupaino, ne ovat saatavilla osoitteissa calculatedWeight ja pricingWeight, ja ne haetaan, jos includeDeliveries on asetettu arvoon "true".

  • Etäisyys ja ajoneuvo kuljetuksessa, ne löytyvät osoitteista calculatedDistance ja vehicleId, ja ne haetaan, jos includeShipments on asetettu arvoon "true".

  • Hiilidioksidipäästöt (g/km), polttoaineenkulutus, polttoaine, ympäristöluokka ja tilavuus muunnettuna hinnoittelupainoksi (kg), ne löytyvät osoitteista emissionInGramPerKilometer, fuelConsumption, fuelName, emissionClass ja EmissionPricingWeightCapacity, ja ne haetaan, jos includeVehicle asetetaan arvoksi "true".

Lisätietoa:: jäljempänä oleva taulukko.

Esimerkkejä mahdollisesti hyödyllisistä kentistä:

Kentän nimi Opterissa Kentän nimi tilasto-API:ssä Kuvaus

Arvioidut hiilidioksidipäästöt (g) (aiemmin Hiilidioksidipäästöt (g))

Näytetään tilausten vastaanotossa kohdassa Tiedot.

calculatedEmissionForecast

Kirjoita includeDeliveries = "true".

Kentässä näytetään arvio eli alustava laskelma tilauksen hiilidioksidipäästöistä grammoina.

(Tämä arvo korvataan, jos Hiilidioksidipäästöt syötetään manuaalisesti kenttään Arvioidut hiilidioksidipäästöt (g) Tilausten vastaanotto yhteydessä, ks. rivi jäljempänä).

Arvioidut hiilidioksidipäästöt (g) (aiemmin Hiilidioksidipäästöt (g))

Näytetään tilausten vastaanotossa kohdassa Tiedot.

emissionForecast

Kirjoita includeDeliveries = "true".

Jos arvioidut hiilidioksidipäästöt on syötetty manuaalisesti, manuaalisesti syötetty arvo korvaa Opterin laskelman tilauksen arvioiduista hiilidioksidipäästöistä. (Katso edellä oleva rivi.)

Hiilidioksidipäästöt, laskettu (g)

Näytetään kohdassa Yksityiskohdat kuljetuksen tiedoissa tilausten vastaanotossa.

emissionEstimate

Kirjoita includeShipments = "true".

Osoitteessa deliveryId näet sen tilauksen numeron, johon kuljetus kuuluu.

vehicleId osoittaa, mikä ajoneuvo on yhdistetty kuljetukseen.

Kentässä näkyy laskelma kuljetuksen hiilidioksidipäästöistä.

Hiilidioksidipäästöt (g/km)

Näytetään ajoneuvorekisterin välilehdellä Päästöt.

 emissionInGramPerKilometer

Kirjoita includeVehicle = "true".

 Ajoneuvon hiilidioksidipäästöt grammoina kilometriä kohti.

Polttoaine

Näytetään ajoneuvorekisterin välilehdellä Päästöt.

fuelName

Kirjoita includeVehicle = "true".

Ajoneuvon käyttämä polttoainetyyppi, esimerkiksi diesel.

Polttoaineen kulutus (100 km:lla)

Näytetään ajoneuvorekisterin välilehdellä Päästöt.

 fuelConsumption

Kirjoita includeVehicle = "true".

 Ajoneuvon polttoaineenkulutus valitussa yksikössä 100:aa kilometriä kohden. (Yksikkö asetetaan polttoainerekisterissä.)

Kapasiteetti muutettuna laskutuspainoksi (kg)

Näytetään ajoneuvorekisterin välilehdellä Päästöt.

emissionPricingWeightCapacity

Kirjoita includeVehicle = "true".

Katso vaihe 1 osoitteessa CO2-päästölaskelmien asetukset.

Ympäristöluokka

Näytetään ajoneuvorekisterin välilehdellä Yleinen.

 emissionClass

Kirjoita includeVehicle = "true".

 Ajoneuvon ympäristöluokka, esimerkiksi ”Euro 5”.

Edellinen

Hiilidioksidipäästöt grammoina, yleiskatsaus.

Katso myös