CO2

Exemplo 3 – Integração com a Toll for Maps API

A CO2 API pode ser integrada com a Toll for Maps API, assim além do retorno das tarifas de pedágios, será fornecido também o cálculo da emissão de carbono.

O processo consiste em apenas adicionar os parâmetros da CO2 API no body da requisição para a Toll for Maps APIs. 

Não será necessário incluir o parâmetro totalDistance, pois essa a distância percorrida já estará na resposta da Directions API.

O exemplo a seguir exibe uma requisição de um rota entre São Paulo – SP e Campinas – SP, a ser percorrida por veículo utilizando gasolina como combustível e com consumo médio de 3,7 Km/l. Também informaremos o preço do combustível sendo R$ 4,90 por litro.

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

No body da requisição deverá ser informado a resposta da Directions API (Google), acrescentado com os parâmetros da CO2 API, conforme o exemplo abaixo:

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

Na resposta abaixo, as informações referentes à emissão de CO2 encontram-se no objeto emission, onde:

  • fuelType – Confirmação do tipo de combustível selecionado;
  • source – Confirmação da fonte utilizada para o cálculo de emissão;
  • fuelConsumed – Quantidade de combustível consumido na rota (em litros);
  • totalFuelPrice – Valor total de combustível consumido na rota;
  • totalEmission – Quantidade CO2 emitido na rota (em Kg).

A resposta completa pode ser conferida a seguir:

{
    "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
        }
    ]
}