Ferramentas · endpoints abertos

Endpoints abertos das ferramentas

Os mesmos dados das ferramentas, por URL, em JSON e GeoJSON, sem chave e sem cadastro. Use em roteirizadores, TMS, GIS, planilhas ou scripts.

Formato

GeoJSON (RFC 7946) e JSON, em WGS 84 (EPSG:4326), com longitude e latitude em graus decimais. CSV e TXT trazem um par por linha.

Limites

60 requisições por minuto por IP. Respostas de fontes externas ficam em cache no servidor por até 30 dias. Sem garantia de disponibilidade: é um serviço gratuito.

Atribuição

Cite as fontes indicadas em cada resposta (IBGE, prefeituras, © OpenStreetMap contributors sob ODbL). As bases próprias da Teraserv podem ser citadas com link para a ferramenta.

Coordenadas de municípios

Sugestões de municípios e distritos pelo nome (JSON).

Contorno oficial do IBGE em GeoJSON. Parâmetros: qualidade (minima, intermediaria, maxima), baixar=1.

Mesmo contorno em CSV (ou .txt), só os anéis externos. ordem=lat inverte para latitude, longitude.

Coordenadas de estados e do Brasil

Contorno de uma UF (sigla), região (regiao-sul, regiao-sudeste…) ou do país (brasil).

Coordenadas de bairros

Sugestões de bairros pelo nome, com a cidade (JSON).

Contorno do bairro (IBGE Censo 2022 ou OpenStreetMap, indicado nas propriedades) em GeoJSON, CSV ou TXT.

Áreas de restrição a caminhões

Sugestões de cidades, indicando se há base oficial (JSON).

GeoJSON com três camadas: zonas (com o status para o veículo), área livre do município e vias com limite de peso. Parâmetros do veículo: pbt (kg), capacidade (kg), comprimento (m), tipo (caminhao ou carreta), placa (último dígito).

Piso mínimo de frete (ANTT)

Piso mínimo calculado. Parâmetros: tipo (chave do tipo de carga), eixos (2 a 12), distancia (km), contratacao (composicao ou tracao), alto=1 (alto desempenho), retorno=1 e retorno_km (retorno vazio), pedagio (R$).

As quatro tabelas de coeficientes vigentes (CCD e CC por tipo de carga e eixos), com a portaria e as datas.

Preço de combustíveis (ANP)

Preço médio, mínimo, máximo e postos pesquisados na última semana, por produto. Sem parâmetros, o Brasil; só uf, o estado; uf e municipio (slug), a cidade.

Sugestões de municípios pesquisados pela ANP (JSON).

Rodovias federais (DNIT)

Trechos de uma BR com código, UF, início, fim, km inicial e final, extensão, superfície, administração e jurisdição.

Pedágios (ANTT e ARTESP)

Praças de pedágio com rodovia, km, município, coordenadas, concessionária, tarifa de automóvel e tabela por categoria, mais a data da tabela e o link da fonte. Filtros: uf, rodovia (br-116, sp-330), concessao (slug).

As mesmas praças em GeoJSON (só as que têm coordenadas no cadastro da ANTT), para mapas e roteirizadores.

Exportação em CSV (separador ponto e vírgula), uma coluna por categoria de veículo.

Sugestões de praças pelo nome, município, rodovia ou concessionária (JSON).

Pedágios de uma rota entre dois municípios ("Cidade, UF" ou código IBGE): distância, duração, praças em ordem com a tarifa da categoria (1 a 9, tabela ANTT), total e o traçado da rota (OSRM sobre OpenStreetMap). Só praças com coordenadas na fonte.

Previsão do tempo (INMET)

Previsão de cinco dias por município, com períodos (manhã, tarde, noite), temperaturas, umidade e vento.

Indicadores do Banco Central

Últimos valores de um indicador: selic, selic-acumulada, cdi, ipca, ipca-15, inpc, igp-m, tr, poupanca, dolar, euro.

Correção de um valor entre dois meses (AAAA-MM) por ipca, inpc, igp-m, selic-acumulada ou cdi, com o fator e a variação de cada mês.

Feriados e dias úteis

Dias úteis entre duas datas (de e ate), ou data final de um prazo em dias úteis (de e prazo).

Cadastros e códigos

Dados públicos de um CNPJ na Receita Federal (via BrasilAPI), com a data da consulta.

Busca de NCM por código ou descrição (JSON).

Lista completa das instituições financeiras com código COMPE e ISPB.

Cidades com base oficial de áreas de restrição

Exemplo

curl "https://www.teraserv.com.br/ferramentas/areas-de-restricao/mg/belo-horizonte/mapa.geojson?pbt=13000&capacidade=7000&comprimento=8"

Perguntas frequentes

Os endpoints precisam de chave ou cadastro?

Não. São abertos, com limite de 60 requisições por minuto por IP e cache no servidor. Para volumes maiores ou uso em produção, fale com a Teraserv.

Em que sistema de coordenadas os dados são entregues?

WGS 84 (EPSG:4326), com longitude e latitude em graus decimais, no padrão GeoJSON. Nos arquivos CSV e TXT a ordem dos pares pode ser escolhida pelo parâmetro ordem.

Com que frequência os dados são atualizados?

Dados do IBGE são consultados no uso e guardados em cache por até 30 dias. As bases próprias (municípios, bairros, áreas de restrição) têm versão e data de atualização publicadas, e os arquivos das prefeituras são verificados mensalmente.