Python SDKpip transcend-sdkFastAPI logistics
Integración: SDK de TRANSCEND para Python
Guía de Integración SDK para Python
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 TranscendClient
# Inicialización
client = TranscendClient(api_key=os.getenv("TRANSCEND_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 TRANSCEND 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