CO2

Ejemplo 3 – Integración con la Toll for Maps API

La API CO2 puede integrarse con la API Toll for Maps, por lo que, además de la devolución de las tarifas de peaje, también se facilitará el cálculo de las emisiones de carbono.

El proceso consiste simplemente en añadir los parámetros de la CO2 API al body de la solicitud a las Toll for Maps API.

No necesitará incluir el parámetro totalDistance, ya que la distancia recorrida estará en la respuesta de la Directions API.

El siguiente ejemplo muestra la solicitud de una ruta entre São Paulo – SP y Campinas – SP, para ser recorrida por un vehículo que utiliza gasolina como combustible y con un consumo medio de 3,7 Km/l. También le informaremos del precio del combustible, que es de 4,90 reales por litro.

Endpoint utilizado:https://api.maplink.global/toll/v1/directions?vehicleType={VEHICLE_TYPE} (Method: POST)

El body de la solicitud debe contener la respuesta de la Directions API de Google, añadida con los parámetros de la CO2 API, como se muestra en el siguiente ejemplo:

{
    //Resposta da Directions API 
    "maplink": {
        "emission": {
            "source": "GHG_PROTOCOL",
            "fuelType": "BR_GASOLINE",
            "autonomy": 3.7,
            "fuelPrice": 4.9
        }
    }
}

En la respuesta siguiente, la información sobre las emisiones de CO2 se encuentra en el objeto emission, donde:

  • fuelType – Confirmación del tipo de combustible seleccionado;
  • source – Confirmación de la fuente utilizada para el cálculo de las emisiones;
  • fuelConsumed – Cantidad de combustible consumido en la ruta (en litros);
  • totalFuelPrice – Valor total del combustible consumido en la ruta;
  • totalEmission – Cantidad de CO2 emitida en la ruta (en Kg).

La respuesta completa puede verse a continuación:

{
    "results": [
        {
            "legs": [
                {
                    "tolls": [
                        {
                            "id": "13",
                            "name": "Pedágio - Campo Limpo",
                            "address": "SP 348 - Rod. dos Bandeirantes",
                            "city": "Campo Limpo",
                            "state": {
                                "name": "São Paulo",
                                "code": "SP"
                            },
                            "country": "Brasil",
                            "concession": "Autoban",
                            "direction": "NORTH",
                            "coordinates": {
                                "latitude": -23.3260346,
                                "longitude": -46.8231453
                            },
                            "serviceTypes": [
                                {
                                    "serviceId": "48",
                                    "name": "Via Facil"
                                },
                                {
                                    "serviceId": "35353480390470101",
                                    "name": "ANTTCODE"
                                }
                            ],
                            "price": 31.80
                        },
                        {
                            "id": "73",
                            "name": "Pedágio - Valinhos Norte",
                            "address": "SP 330 - Rod. Anhanguera Km 82",
                            "city": "Valinhos",
                            "state": {
                                "name": "São Paulo",
                                "code": "SP"
                            },
                            "country": "Brasil",
                            "concession": "Autoban",
                            "direction": "NORTHWEST",
                            "coordinates": {
                                "latitude": -23.01295484,
                                "longitude": -47.0230555
                            },
                            "serviceTypes": [
                                {
                                    "serviceId": "50",
                                    "name": "Via Facil"
                                },
                                {
                                    "serviceId": "35353300820000101",
                                    "name": "ANTTCODE"
                                }
                            ],
                            "price": 31.50
                        }
                    ],
                    "legTotalCost": 63.30
                }
            ],
            "emission": {
                "fuelType": "BR_GASOLINE",
                "source": "GHG_PROTOCOL",
                "fuelConsumed": 25.06,
                "totalFuelPrice": 122.78,
                "totalEmission": 33.724
            },
            "totalCost": 63.30
        }
    ]
}