logo
Api Pedágios

Introducao

API Pedágios

Utilize o serviço API Pedágios para otimizar suas rotas e calcular custos de forma eficiente. Com nossa API, você pode:

  • Calcular Pedágios: Obtenha os custos de pedágio para sua rota especificada.
  • Calcular Custos Adicionais: Inclua despesas com combustível e custos com motorista na sua estimativa de custos de viagem.
  • Encontrar Rotas Otimizadas: Determine as rotas mais baratas, mais rápidas e outras opções ideais para suas necessidades de transporte.

Integrando nossa API ao seu aplicativo ou website, você oferece aos seus usuários uma ferramenta poderosa para o planejamento de rotas eficiente e econômico.

Como usar a API Pedágios

Registre-se para obter uma chave API gratuita usando seu e-mail e senha. Sugerimos o uso do Postman para testar a API antes de integrá-la aos seus produtos. A API Pedágios é uma API REST com URLs orientadas a recursos previsíveis, utiliza códigos de resposta HTTP padrão e autenticação para aceitar corpos de solicitação codificados por formulário e retornar respostas codificadas em JSON.

Autenticação

A autenticação para a API é realizada através do HTTP Autenticação Básica. Sua chave de API serve como o valor do nome de usuário no auth básico. Não é necessário fornecer uma senha.

As chaves de API da possuem privilégios. Não compartilhe chaves de API em áreas publicamente acessíveis, como GitHub, ou no código do lado do cliente em um navegador.

Obtendo uma chave de API

Pedágio por coordenadas

Documentação da API

Api por coordenadas permite enviar Latitude e Longitudes de cidades para calcular pedágios.

A API permite que você envie solicitações POST para nosso servidor, fornecendo dados específicos que serão processados e retornados.

URL Base

URL Base: https://www.calcularpedagio.com.br/api/coordenadas/v3

Todas as solicitações à API devem ser feitas para esta URL base.

Autenticação

Para autenticar as solicitações, você deve incluir um token no cabeçalho Authorization. Este token é sua chave de API, fornecida ao se inscrever em nosso serviço.

Cabeçalho:

api_key:   Sua chave API_KEY aqui 

Corpo da Requisição

O corpo da requisição deve ser um objeto JSON com a seguinte estrutura: (Latitude,longitude)


{
    "pontos": 
        [ 
            [-28.0656, -52.0092],  // Tapejara, RS
            [-12.9714, -38.5014]   // Salvador, BA
        ]
}
        

Resposta

A API responderá com um objeto JSON contendo os dados processados.

Exemplo de Resposta:


    "status": "OK",
    "dados": {
        "pais": "Brasil",
        "moeda": "BRL",
        "pedagiosRota": [
            {
                "id": 550091600,
                "ladoCobranca": "ambos",
                "status": "ok",
                "sistemasTag": [],
                "pais": "Brazil",
                "estado": "PR",
                "rodovia": "BR-373/BR-153",
                "nomeRodovia": "BR-373/BR-153",
                "dinheiro": "not available",
                "localidade": "Imbituva",
                "moeda": "BRL",
                "custosDinheiro": {
                    "moto2eixos": null,
                    "auto2eixos": 10,
                    "auto3eixos": 15,
                    "auto4eixos": 20,
                    "valorPorEixoCaminhao": 10,
                    "onibus2Eixos": 20,
                    "motorHome2eixos": 10,
                    "motorHome3eixos": 15,
                    "motorHome4eixos": 20
                },
                "custoTag": {
                    "moto2eixos": null,
                    "auto2eixos": 10,
                    "auto3eixos": 15,
                    "auto4eixos": 20,
                    "valorPorEixoCaminhao": 10,
                    "onibus2Eixos": 20,
                    "motorHome2eixos": 10,
                    "motorHome3eixos": 15,
                    "motorHome4eixos": 20
                },
                "atualizado": "2024-10-14",
                "ultimaAlteracao": "2024-10-14"
            },
            ...
        ],
        "custoTotalPedagiosDinheiro": {
            "moto2eixos": 68.3,
            "auto2eixos": 56.8,
            "auto3eixos": 123.7,
            "auto4eixos": 155.6,
            "valorPorEixoCaminhao": 56.8,
            "onibus2Eixos": 113.6,
            "motorHome2eixos": 63.8,
            "motorHome3eixos": 123.7,
            "motorHome4eixos": 155.6
        },
        "custoTotalPedagiosTag": {
            "moto2eixos": 63,
            "auto2eixos": 56.3,
            "auto3eixos": 122.9,
            "auto4eixos": 154.5,
            "valorPorEixoCaminhao": 56.3,
            "onibus2Eixos": 112.5,
            "motorHome2eixos": 63.3,
            "motorHome3eixos": 122.9,
            "motorHome4eixos": 154.5
        }
    },
    "polyline": {
        "coordinates": [
            [
                -52.009913,
                -28.065368
            ],
            [
                -52.01018,
                -28.065105
            ],
        ...
    }
}
          

Tratamento de Erros

Se a solicitação falhar, uma resposta de erro será retornada. O erro incluirá uma mensagem descrevendo o problema.

Exemplo de Resposta de Erro:

{
  "error": "Token de autenticação inválido"
}

Códigos de Status

A API pode retornar os seguintes códigos de status HTTP:

  • 200 OK: A solicitação foi bem-sucedida.
  • 400 Bad Request: A solicitação não pôde ser entendida ou estava faltando parâmetros obrigatórios.
  • 401 Unauthorized: Falha na autenticação.
  • 500 Internal Server Error: Ocorreu um erro no servidor.

Escolha a linguagem de programação:

Exemplo Node JS node.js
      const axios = require("axios");
      
      const urlSite =
      "https://www.calcularpedagio.com.br/api/coordenadas/v3";
      const api_key = "Sua chave API_KEY aqui";
      
      const dados = {
        "pontos":  
        [-29.5008, -51.9484],
        [-29.4400, -51.9700],
        [-29.2964, -51.5026],
        [-29.2562, -51.5341]
      };
      
      const configuracao = {
        headers: {
            'Content-Type': 'application/json',
            'Authorization': `Bearer ${api_key}` 
            // Use sua chave de API correta aqui
        }
      };
      
      axios.post(urlSite, dados, configuracao)
        .then(response => {
            console.log('Resposta:', response.data);
        })
        .catch(error => {
            console.error(
            'Erro:', error.response ? error.response.data : error.message);
        });
                

Pedágio por Pontos

Documentação da API

Api por Pontos permite enviar os nomes das cidades para calcular custos de pedágios.

A API permite que você envie solicitações POST para nosso servidor, fornecendo dados específicos que serão processados e retornados.

URL Base

URL Base: https://www.calcularpedagio.com.br/api/pontos/v3

Todas as solicitações à API devem ser feitas para esta URL base.

Autenticação

Para autenticar as solicitações, você deve incluir um token no cabeçalho Authorization. Este token é sua chave de API, fornecida ao se inscrever em nosso serviço.

Cabeçalho:

api_key:   Sua chave API_KEY aqui 

Corpo da Requisição

O corpo da requisição deve ser um objeto JSON com a seguinte estrutura: (Latitude,longitude)


{
  "pontos": [
    "Gramado/RS",
    "Passo Fundo/RS",
    "São Paulo/SP"
  ]
}
        

Resposta

A API responderá com um objeto JSON contendo os dados processados.

Exemplo de Resposta:


{
    "status": "OK",
    "dados": {
        "pais": "Brasil",
        "moeda": "BRL",
        "pedagiosRota": [
            {
                "id": 550091600,
                "ladoCobranca": "ambos",
                "status": "ok",
                "sistemasTag": [],
                "pais": "Brazil",
                "estado": "PR",
                "rodovia": "BR-373/BR-153",
                "nomeRodovia": "BR-373/BR-153",
                "dinheiro": "not available",
                "localidade": "Imbituva",
                "moeda": "BRL",
                "custosDinheiro": {
                    "moto2eixos": null,
                    "auto2eixos": 10,
                    "auto3eixos": 15,
                    "auto4eixos": 20,
                    "valorPorEixoCaminhao": 10,
                    "onibus2Eixos": 20,
                    "motorHome2eixos": 10,
                    "motorHome3eixos": 15,
                    "motorHome4eixos": 20
                },
                "custoTag": {
                    "moto2eixos": null,
                    "auto2eixos": 10,
                    "auto3eixos": 15,
                    "auto4eixos": 20,
                    "valorPorEixoCaminhao": 10,
                    "onibus2Eixos": 20,
                    "motorHome2eixos": 10,
                    "motorHome3eixos": 15,
                    "motorHome4eixos": 20
                },
                "atualizado": "2024-10-14",
                "ultimaAlteracao": "2024-10-14"
            },
            ...
        ],
        "custoTotalPedagiosDinheiro": {
            "moto2eixos": 68.3,
            "auto2eixos": 56.8,
            "auto3eixos": 123.7,
            "auto4eixos": 155.6,
            "valorPorEixoCaminhao": 56.8,
            "onibus2Eixos": 113.6,
            "motorHome2eixos": 63.8,
            "motorHome3eixos": 123.7,
            "motorHome4eixos": 155.6
        },
        "custoTotalPedagiosTag": {
            "moto2eixos": 63,
            "auto2eixos": 56.3,
            "auto3eixos": 122.9,
            "auto4eixos": 154.5,
            "valorPorEixoCaminhao": 56.3,
            "onibus2Eixos": 112.5,
            "motorHome2eixos": 63.3,
            "motorHome3eixos": 122.9,
            "motorHome4eixos": 154.5
        }
    },
    "polyline": {
        "coordinates": [
            [
                -52.009913,
                -28.065368
            ],
            [
                -52.01018,
                -28.065105
            ],
        ...
    }
}
          

Tratamento de Erros

Se a solicitação falhar, uma resposta de erro será retornada. O erro incluirá uma mensagem descrevendo o problema.

Exemplo de Resposta de Erro:

{
  "error": "Token de autenticação inválido"
}

Códigos de Status

A API pode retornar os seguintes códigos de status HTTP:

  • 200 OK: A solicitação foi bem-sucedida.
  • 400 Bad Request: A solicitação não pôde ser entendida ou estava faltando parâmetros obrigatórios.
  • 401 Unauthorized: Falha na autenticação.
  • 500 Internal Server Error: Ocorreu um erro no servidor.

Escolha a linguagem de programação:

Exemplo Node JS node.js
const axios = require("axios");
        
const urlSite = "https://www.calcularpedagio.com.br/api/pontos/v3";
const urlSite = "https://www.calcularpedagio.com.br/api/pontos/multiplosTrajetos/v3";
const api_key = "";
        
const dados = {
     "Inicio": [Tapejara/RS], 
    "Paradas": [[ 'Passo Fundo/RS' ], [ 'marau/RS' ]],  // Se não tiver parada é só enviar um array vazio []
    "Final": [ 'Porto Alegre/RS' ]
};
        
const configuracao = {
    headers: {
            'Content-Type': 'application/json',
            'Authorization': `Bearer ${api_key}` 
            
        }
};
        
axios.post(urlSite, dados, configuracao)
    .then(response => {
        console.log('Resposta:', response.data);
    })
    .catch(error => {
    console.error('Erro:', error.response ? error.response.data : error.message);
});
                

Contato

Tem mais alguma dúvida? Estamos disponíveis para retirar qualquer dúvida, entre em contato clicando aqui.