Python SDKpip transcend-sdkFastAPI logistics

Cómo Calcular Rutas de Transporte con Python · SDK Tolls Calculator

Guía paso a paso para integrar la API de rutas y peajes de Tolls Calculator en Python. Instalación, autenticación y ejemplo funcional en 10 líneas de código.

Por Jorge Parada, CTO de Cargoffer

Cómo Calcular Rutas de Transporte con Python · SDK Tolls Calculator

Integrar lógica logística compleja en un backend Python suele requerir meses de trabajo. Con el SDK de Tolls Calculator para Python, los equipos de ciencia de datos y backend pueden calcular rutas de camiones y peajes europeos en apenas 10 líneas de código. Las empresas que utilizan el SDK en sus pipelines de análisis de datos logísticos logran optimizar su red de distribución y reducir sus costes de transporte en un 10%. (Fuente: datos internos Cargoffer, 2025).

El paquete de Python transcend-sdk permite integrar las APIs de enrutamiento y costes de transporte en scripts, plataformas de análisis de datos y microservicios FastAPI o Django.

1. Instalación del Paquete

Instale la librería mediante pip:

pip install transcend-sdk

2. Ejemplo Práctico en Python

El siguiente script calcula la ruta óptima de un camión y extrae el Danger Score meteorológico del trayecto:

import os
from transcend_sdk import Tolls CalculatorClient

# Inicialización
client = Tolls CalculatorClient(api_key=os.getenv("Tolls Calculator_API_KEY", "tu_api_key"))

def calculate_optimized_trip():
    # Parámetros del trayecto
    trip = client.routes.optimize(
        origin={"lat": 40.4167, "lng": -3.7037},      # Madrid
        destination={"lat": 38.7223, "lng": -9.1393}, # Lisboa
        vehicle_profile="heavy_truck"
    )
    
    print(f"Distancia: {trip.distance_km} km")
    print(f"Coste estimado de peajes: {trip.tolls_cost_eur} EUR")
    
    # Comprobar clima para la ruta
    weather = client.weather.get_risk(route_id=trip.id)
    print(f"Peligro Climático (0-10): {weather.danger_score}")

if __name__ == "__main__":
    calculate_optimized_trip()

3. Ejemplo FastAPI

Exponga de manera sencilla un endpoint de optimización de flotas en su empresa:

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()

class RouteRequest(BaseModel):
    origin: dict
    destination: dict

@app.post("/api/v1/optimize")
def get_fleet_route(req: RouteRequest):
    try:
        res = client.routes.optimize(origin=req.origin, destination=req.destination)
        return res.to_dict()
    except Exception as e:
        raise HTTPException(status_code=500, detail=str(e))

4. Siguientes Pasos y Tutoriales Relacionados

Explora cómo combinar esta funcionalidad con otros módulos de Tolls Calculator para crear flujos de trabajo avanzados en tu LLM o Agente:

  • Optimización de Rutas (Valhalla)
  • Cálculo Dinámico de Peajes y Costes
  • Meteorología AEMET/IPMA para Rutas
  • Tráfico y Puntos Negros en Tiempo Real
  • Extracción de Datos de Facturas (OCR)
  • Búsqueda de Puntos de Interés (Parkings/Duchas)
  • Caso de Uso: Ahorro de Combustible
  • Caso de Uso: Automatización Invoice-to-Cash

Enlaces Relacionados

Preguntas frecuentes

¿Es compatible con Python 3?
Sí, el SDK está diseñado para Python 3.8 o superior, con soporte completo de type hinting.
¿Cómo gestiona la autenticación?
Se configura a través de variables de entorno o pasando directamente la API key al instanciar el cliente Tolls Calculator.
¿Soporta llamadas asíncronas?
El SDK incluye métodos basados en asyncio (aiohttp) para procesamiento masivo de rutas en paralelo sin bloquear el hilo principal.

Recursos relacionados

¿Listo para calcular peajes con datos en vivo?