Node.js SDKJavaScript route APInpm @transcend/sdk
Integración: SDK de TRANSCEND para Node.js
Guía de Integración SDK para Node.js
El SDK oficial de TRANSCEND permite a los desarrolladores de backend integrar las APIs de enrutamiento, peajes, tráfico y clima de forma rápida en entornos JavaScript y TypeScript.
1. Instalación y Configuración
Instale el SDK en su proyecto de Node.js:
npm install @transcend/sdk
# O usando yarn
yarn add @transcend/sdk
2. Ejemplo Práctico de Código
Inicialice el cliente y calcule una ruta para camiones con costes de peaje integrados en pocas líneas:
import { TranscendClient } from '@transcend/sdk';
// Inicialización del cliente con clave de API
const client = new TranscendClient({
apiKey: process.env.TRANSCEND_API_KEY || 'tu_api_key_aqui'
});
async function run() {
try {
const route = await client.routes.calculate({
waypoints: [
{ lat: 40.4167, lng: -3.7037 }, // Madrid
{ lat: 41.3851, lng: 2.1734 } // Barcelona
],
vehicle: {
type: 'truck',
weight: 40000, // 40t
height: 4.0 // 4 metros
}
});
console.log('Distancia total (km):', route.distance / 1000);
console.log('Peajes estimados (EUR):', route.tolls_cost);
} catch (error) {
console.error('Error de optimización:', error);
}
}
run();
3. Manejo de Errores y Tipado TypeScript
El SDK incluye tipos completos para facilitar la integración en proyectos TypeScript modernos.
Ejemplo de Captura de Excepciones
import { TranscendAPIError } from '@transcend/sdk';
try {
// llamada API
} catch (err) {
if (err instanceof TranscendAPIError) {
console.error(`API Error (${err.status}):`, err.message);
}
}
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