Sobre esta API

Calcule distâncias em linha reta (geodésica) ou por rota rodoviária entre dois CEPs. Suporte a múltiplas unidades (km, milhas, metros) e cálculo em lote. Utiliza geocodificação via OpenStreetMap Nominatim com cache persistente em SQLite por 30 dias. Cálculo de rota via OSRM. Ideal para logística, delivery, planejamento de rotas, geolocalização, aplicativos de transporte e sistemas de distribuição.

Principais recursos

Linha reta

Distância geodésica entre dois pontos

Rota rodoviária

Distância por estradas com OSRM

Múltiplas unidades

Km, milhas e metros

Cálculo em lote

Até 10 CEPs por vez

99.9% Uptime

Disponibilidade garantida

SSL Seguro

Todas as requisições criptografadas

Cache persistente

Cache de coordenadas em SQLite por 30 dias

Geocodificação

Busca de coordenadas via OpenStreetMap

Documentação adicional

Dados de geolocalização utilizando OpenStreetMap Nominatim. Cache de 30 dias para coordenadas (SQLite). Cálculo de rota via OSRM. Suporte a múltiplos CEPs em lote (até 10x10). Unidades: km, milhas, metros. Modos: reta (geodésica), rota (rodoviária) ou ambos. Cache em Redis para não autenticados (1 hora).

Informações técnicas

Endpoint distancia.apibrasil.pro
Cache 1 hora
Preço Gratuito
Autenticação API Key (Bearer)
Formato JSON
Rate Limit 100 req/min
Limite Grátis 1,000 req/mês

Documentação

Endpoints da API Distância

Exemplos de requisições, parâmetros e respostas para cada endpoint.

GET /distancia

Calcula distância entre dois CEPs

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`cep_origem`	string	✅ Sim	CEP origem (XXXXX-XXX ou XXXXXXXX)
`cep_destino`	string	✅ Sim	CEP destino (XXXXX-XXX ou XXXXXXXX)
`unidade`	string	❌ Não	km, milhas, metros ou todos (padrão: todos)
`modo`	string	❌ Não	reta, rota ou ambos (padrão: reta)

curl -X GET "https://distancia.apibrasil.pro/distancia?cep_origem=01001000&cep_destino=20040030&unidade=todos&modo=ambos" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}

POST /distancia/multipla

Calcula distâncias entre múltiplos CEPs (até 10x10)

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`origens`	array	✅ Sim	Array de CEPs origem (máx 10)
`destinos`	array	✅ Sim	Array de CEPs destino (máx 10)

curl -X POST "https://distancia.apibrasil.pro/distancia/multipla" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111" -H "Content-Type: application/json" -d '{"origens":["01001000","20040030"],"destinos":["70040000","80010000"]}'

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}

GET /geocode/{cep}

Retorna coordenadas (latitude/longitude) de um CEP

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`cep`	string	✅ Sim	CEP para geocodificação

curl -X GET "https://distancia.apibrasil.pro/geocode/01001000" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}

GET /validar/{cep}

Valida se um CEP existe e é válido

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`cep`	string	✅ Sim	CEP para validação

curl -X GET "https://distancia.apibrasil.pro/validar/01001000" -H "Authorization: Bearer sk_live_dcaddc95473df193c89609c4f6b26d0d9748185b79aa4111"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}

GET /api/health

Health check da API

curl -X GET "https://distancia.apibrasil.pro/api/health"

{
  "success": true,
  "data": {
    "exemplo": "Dados da API Distância"
  }
}

Pronto para começar?

Obtenha sua API Key e comece a integrar Distância hoje mesmo.

Acessar Dashboard Ver planos

Planos

Escolha o plano ideal para seu negócio

Comece gratuitamente com 1.000 créditos por mês ou assine um plano com mais requisições.

Gratuito R$ 0 /mês

1,000 requisições por mês. Com API Key exclusiva.

1,000 créditos/mês
Todas as APIs disponíveis
API Key exclusiva
Dashboard de consumo
Suporte prioritário

Cadastrar Grátis

Starter R$ 29,90 /mês

10,000 requisições por mês com API Key exclusiva.

10,000 créditos/mês
Todas as APIs disponíveis
API Key exclusiva
Dashboard de consumo
Suporte básico

Assinar

Mais Popular

Professional R$ 59,90 /mês

25,000 requisições por mês com API Key exclusiva.

25,000 créditos/mês
Todas as APIs disponíveis
API Key exclusiva
Dashboard de consumo
Suporte prioritário

Assinar

Business R$ 99,90 /mês

50,000 requisições por mês com API Key exclusiva.

50,000 créditos/mês
Todas as APIs disponíveis
API Key exclusiva
Dashboard de consumo
Suporte prioritário

Assinar

🌟 Enterprise

Precisa de um plano personalizado?

Créditos ilimitados, suporte 24/7 dedicado, SLA 99.9% e consultoria personalizada.

Falar com Vendas

Distância

Sobre esta API

Principais recursos

Linha reta

Rota rodoviária

Múltiplas unidades

Cálculo em lote

99.9% Uptime

SSL Seguro

Cache persistente

Geocodificação

Documentação adicional

Informações técnicas

Precisa de ajuda?

Teste a API Distância

Testar Distância

Endpoints da API Distância

Parâmetros

Parâmetros

Parâmetros

Parâmetros

Pronto para começar?

Escolha o plano ideal para seu negócio

Precisa de um plano personalizado?