POST
/v1/routes/optimizeOtimizador de Rotas Viárias & Entregas (TSP)
Calcula a sequência perfeita de visitas (Problema do Caixeiro Viajante) considerando sentidos reais de trânsito, distância viária e tempo estimado. Retorna a ordem ótima e a geometria GeoJSON.
Exemplos de Código
curl -X POST "https://api.geocep.api.br/v1/routes/optimize" \
-H "Content-Type: application/json" \
-d '{
"origem": { "latitude": -23.550520, "longitude": -46.633308, "descricao": "Centro SP" },
"paradas": [
{ "latitude": -23.561414, "longitude": -46.655881, "descricao": "Av. Paulista" },
{ "latitude": -23.587416, "longitude": -46.657634, "descricao": "Parque Ibirapuera" }
],
"retornar_a_origem": false
}'🌐 Modo público: Gratuito até 100 requisições/hora por IP sem cadastro.HTTPS / TLS 1.3
Exemplo de Resposta (200 OK)
{
"status": "success",
"data": {
"resumo": {
"total_paradas": 2,
"distancia_total_km": 5.5,
"tempo_estimado_minutos": 16.5
},
"ordem_otimizada": [
{
"posicao": 1,
"endereco": "Av. Paulista",
"coordenadas": { "latitude": -23.561414, "longitude": -46.655881 },
"distancia_trecho_km": 2.6,
"tempo_trecho_min": 7.8
},
{
"posicao": 2,
"endereco": "Parque Ibirapuera",
"coordenadas": { "latitude": -23.587416, "longitude": -46.657634 },
"distancia_trecho_km": 2.9,
"tempo_trecho_min": 8.7
}
],
"geometria_geojson": {
"type": "LineString",
"coordinates": [
[-46.633308, -23.55052],
[-46.655881, -23.561414],
[-46.657634, -23.587416]
]
}
}
}