RedTransporteAPI

CLI tool for managing local GTFS data, querying stops, routes, real-time predictions, and planning public transit trips in Chile's Red de Transporte system.

iroaK@iiroak

Install

openclaw skills install @iiroak/redtransportecl

name: redtransportecl
description: Usa la CLI `red-transporte` para consultar paraderos, recorridos, predicciones en tiempo real, GTFS local y utilidades geoespaciales de RED Chile.
metadata:
{
"openclaw":
{
"requires": { "bins": ["red-transporte"] }
}
}

RedTransporteAPI CLI — SKILL

Esta skill esta enfocada exclusivamente en el uso de la CLI red-transporte.

Requisitos

Python 3.9 o superior
Instalar dependencias del proyecto
Descargar GTFS local antes de consultas que usan datos estaticos

bash

pip install ".[all]"
red-transporte gtfs update

Sintaxis general

bash

red-transporte [--json] [--verbose|-v] <comando> [opciones]

Flags globales

--json: imprime salida JSON cruda.
--verbose o -v: activa logging en nivel debug.

Ejemplo:

bash

red-transporte --json stop PA433
red-transporte -v predict PA433

Comandos CLI detallados

1) `gtfs`

Gestiona datos GTFS locales.

Subcomandos:

gtfs update [--force]
- Descarga/actualiza el GTFS vigente desde DTPM.
- --force: fuerza re-descarga aunque exista version local.
gtfs status
- Muestra estado de los datos GTFS locales.

Ejemplos:

bash

red-transporte gtfs update
red-transporte gtfs update --force
red-transporte --json gtfs status

2) `stop`

Obtiene informacion completa de un paradero.

Uso:

bash

red-transporte stop <code>

Argumentos:

<code>: codigo del paradero (ejemplo: PA433).

Ejemplos:

bash

red-transporte stop PA433
red-transporte --json stop PA433

3) `search`

Busca paraderos por texto.

Uso:

bash

red-transporte search <query> [--limit N]

Argumentos y opciones:

<query>: texto de busqueda.
--limit: maximo de resultados (default: 10).

Ejemplos:

bash

red-transporte search "providencia"
red-transporte search "macul" --limit 5

4) `nearby`

Lista paraderos cercanos a una coordenada.

Uso:

bash

red-transporte nearby <lat> <lon> [--radius KM]

Argumentos y opciones:

<lat>: latitud (float).
<lon>: longitud (float).
--radius: radio en kilometros (default: 0.5).

Ejemplos:

bash

red-transporte nearby -33.4372 -70.6506
red-transporte nearby -33.4372 -70.6506 --radius 1.0

5) `station`

Devuelve la estacion de metro/tren mas cercana.

Uso:

bash

red-transporte station <lat> <lon>

Argumentos:

<lat>: latitud (float).
<lon>: longitud (float).

Ejemplo:

bash

red-transporte station -33.45 -70.65

6) `route`

Muestra informacion de un recorrido.

Uso:

bash

red-transporte route <route_id>

Argumentos:

<route_id>: ID o nombre corto del recorrido (ejemplo: 506, D12).

Ejemplos:

bash

red-transporte route 506
red-transporte route D12

7) `routes`

Lista recorridos, opcionalmente filtrados por modo.

Uso:

bash

red-transporte routes [--mode bus|metro|rail|tram]

Opciones:

--mode: filtra por modo de transporte.

Ejemplos:

bash

red-transporte routes
red-transporte routes --mode metro
red-transporte routes --mode bus

8) `predict`

Consulta predicciones en tiempo real para un paradero.

Uso:

bash

red-transporte predict <code>

Argumentos:

<code>: codigo del paradero.

Ejemplos:

bash

red-transporte predict PA433
red-transporte --json predict PA433

9) `stats`

Entrega estadisticas globales del sistema.

Uso:

bash

red-transporte stats

Ejemplo:

bash

red-transporte --json stats

10) `suggest`

Sugiere recorridos entre dos puntos geograficos (basico, sin tiempos).

Uso:

bash

red-transporte suggest <from_lat> <from_lon> <to_lat> <to_lon> [--radius KM]

Argumentos y opciones:

<from_lat>: latitud origen.
<from_lon>: longitud origen.
<to_lat>: latitud destino.
<to_lon>: longitud destino.
--radius: radio de busqueda en kilometros (default: 0.5).

Ejemplos:

bash

red-transporte suggest -33.4372 -70.6506 -33.4189 -70.6024
red-transporte suggest -33.4372 -70.6506 -33.4189 -70.6024 --radius 0.8

11) `server`

Inicia el servidor HTTP de la API.

Uso:

bash

red-transporte server

Salida esperada:

API disponible localmente (por defecto) en http://localhost:8000.
Documentacion Swagger en http://localhost:8000/docs.

Flujo recomendado de uso CLI

Descargar GTFS: red-transporte gtfs update
Verificar estado: red-transporte gtfs status
Consultar paraderos/recorridos: stop, search, route, routes
Consultar tiempo real: predict
Consultas geoespaciales: nearby, station, suggest

Planificador de rutas RAPTOR (API)

El endpoint /routing/plan usa el algoritmo RAPTOR para calcular rutas optimas de transporte publico entre dos coordenadas. Este endpoint solo esta disponible via la API HTTP (no via CLI).

Endpoint

text

GET /routing/plan

Parametros

Parametro	Tipo	Default	Descripcion
`from_lat`	float	(requerido)	Latitud del origen
`from_lon`	float	(requerido)	Longitud del origen
`to_lat`	float	(requerido)	Latitud del destino
`to_lon`	float	(requerido)	Longitud del destino
`departure_time`	str	`08:00:00`	Hora de salida en formato HH:MM:SS
`day`	str	`L`	Dia: `L`=laboral, `S`=sabado, `D`=domingo
`max_results`	int	`3`	Maximo de alternativas (1-5)
`max_transfers`	int	`2`	Maximo de transbordos (0-3)
`fare_type`	str	`normal`	Tipo tarifa: `normal`, `estudiante`, `adulto_mayor`

Ejemplo de uso

bash

# Estacion Central a Puente Alto, laboral 09:00
curl "http://localhost:8000/routing/plan?from_lat=-33.4525&from_lon=-70.6783&to_lat=-33.586&to_lon=-70.576&departure_time=09:00:00&day=L"

# Plaza Italia a La Moneda, tarifa estudiante
curl "http://localhost:8000/routing/plan?from_lat=-33.4372&from_lon=-70.634&to_lat=-33.4422&to_lon=-70.6537&fare_type=estudiante"

# Sin transbordos (solo rutas directas)
curl "http://localhost:8000/routing/plan?from_lat=-33.4372&from_lon=-70.634&to_lat=-33.5195&to_lon=-70.598&max_transfers=0"

Respuesta

La respuesta contiene una lista de planes de viaje (plans), cada uno con:

total_time_secs / total_time_human: tiempo total del viaje
departure_time / arrival_time: hora de salida y llegada
walk_time_secs, ride_time_secs, wait_time_secs: desglose de tiempos
transfers: numero de transbordos
total_walk_m: metros caminados en total
fare: tarifa calculada con desglose
legs: lista de tramos del viaje (caminar, bus, metro, etc.)
summary: resumen legible del viaje

Cada leg tiene:

mode: walk, bus, metro, rail
route_name: nombre del recorrido (ej: L1, 506, 210)
board_stop_name / alight_stop_name: paradero de subida y bajada
num_stops: cantidad de paradas
duration_secs: duracion del tramo
wait_secs: tiempo de espera antes de abordar
walk_distance_m: distancia caminada (solo para legs de caminata)

RAPTOR: como funciona

RAPTOR (Round-Based Public Transit Optimized Router) busca rutas por rondas:

Ronda 1: mejor ruta directa (0 transbordos)
Ronda 2: mejor ruta con 1 transbordo
Ronda 3: mejor ruta con 2 transbordos

Solo devuelve una ronda si es estrictamente mas rapida que la anterior (Pareto-optimo). Ejemplo: si con 2 transbordos llegas en 1h09 pero sin transbordos en 1h20, ambas opciones se muestran.

El tiempo de espera se calcula como: headway/2 (promedio) + 30 segundos de penalizacion por abordaje. Los headways vienen de las frecuencias reales del GTFS por hora y dia.

Tarifa integrada RED

El calculo de tarifa sigue las reglas oficiales de red.cl.

Tarifas base adulto normal:

Modo	Punta (07-09 / 18-20)	Valle (09-18 / 20-20:44 / fds)	Baja (06-07 / 20:45-23)
Bus	$795	$795	$795
Metro/Tren	$895	$815	$735

Reglas de transbordo:

Maximo 2 transbordos en ventana de 120 minutos
Tarifa integrada = maximo entre bus ($795) y metro (segun periodo)
Bus → Metro: pagas la diferencia hasta tarifa metro
Metro → Bus: bus incluido ($0 adicional)
Bus → Bus: segundo bus incluido ($0 adicional)
Solo el primer tramo paga completo; los demas estan incluidos

Tarifas especiales:

fare_type	Tarifa
`normal`	segun tabla de arriba
`estudiante`	$260 plana
`adulto_mayor`	$390 plana

Desglose en respuesta: El campo fare.breakdown muestra por cada tramo de transporte:

mode: tipo de vehiculo
route: nombre del recorrido
fare_mode: tarifa teorica del modo
paid: monto pagado en ese tramo ($0 si es transbordo incluido)

Notas operativas CLI

Si no existe GTFS local, varios comandos fallaran hasta ejecutar red-transporte gtfs update.
predict consulta fuentes en tiempo real y puede variar entre llamadas.
Para integraciones de scripts, usar siempre --json.
El planificador RAPTOR solo esta disponible via la API HTTP (/routing/plan), no via CLI.

RedTransporteAPI

Install

name: redtransportecl description: Usa la CLI red-transporte para consultar paraderos, recorridos, predicciones en tiempo real, GTFS local y utilidades geoespaciales de RED Chile. metadata: { "openclaw": { "requires": { "bins": ["red-transporte"] } } }

RedTransporteAPI CLI — SKILL

Requisitos

Sintaxis general

Flags globales

Comandos CLI detallados

1) gtfs

2) stop

3) search

4) nearby

5) station

6) route

7) routes

8) predict

9) stats

10) suggest

11) server

Flujo recomendado de uso CLI

Planificador de rutas RAPTOR (API)

Endpoint

Parametros

Ejemplo de uso

Respuesta

RAPTOR: como funciona

Tarifa integrada RED

Notas operativas CLI

name: redtransportecl
description: Usa la CLI `red-transporte` para consultar paraderos, recorridos, predicciones en tiempo real, GTFS local y utilidades geoespaciales de RED Chile.
metadata:
{
"openclaw":
{
"requires": { "bins": ["red-transporte"] }
}
}

1) `gtfs`

2) `stop`

3) `search`

4) `nearby`

5) `station`

6) `route`

7) `routes`

8) `predict`

9) `stats`

10) `suggest`

11) `server`