Casos de uso

Horario de la parada de tu negocio, embebido en tu web

Un hotel, un centro comercial o el propio hospital junto a la parada "Manuel Siurot (Hospital V.Rocio)" quiere mostrar en su web "próximas salidas desde aquí" sin mantener ellos el dato. Con /v1/paradas/:codigo sacas el nombre y las líneas que paran ahí; con /v1/lineas/:id/horario sacas las salidas programadas de cada una y calculas tú, en tu backend o en el cliente, cuál es la siguiente a partir de la hora actual — el mismo cálculo que el ejemplo de inicio rápido.

Límite honesto: esto es horario programado, no el autobús moviéndose en el mapa en tiempo real — para eso haría falta /v1/paradas/:codigo/tiempos, que todavía no está resuelto (ver por qué). Un widget de "según el horario, el próximo pasa a las 18:24" es honesto y ya es información útil; "el bus llega en 3 minutos, en directo" todavía no se puede prometer.

Alertas de avisos e incidencias por línea

Un bot al que la gente le escribe "línea 02" y responde con el estado actual — o que avisa proactivamente cuando hay un corte o desvío en las líneas que sigue un grupo. Sondea /v1/avisos cada pocos minutos (respeta el límite de 60 peticiones/minuto: con cachear la respuesta 60-120 segundos de tu lado sobra de sobra), filtra por las líneas que afecta cada aviso y manda el mensaje solo cuando hay algo nuevo. /v1/lineas te da el catálogo para el comando de "líneas disponibles" o para validar que la línea que pide alguien existe de verdad.

"¿Cuándo salgo?" para una facultad o una empresa

Una intranet de universidad o de empresa con una página de "cómo llegar" que calcula, según la hora de la próxima clase o reunión, cuándo hay que salir para coger el bus. Por ejemplo, la parada "Reina Mercedes (E.S.I. Informática)" de la línea 06: con /v1/lineas/06/horario tienes las salidas del día y con /v1/paradas localizas las paradas cercanas al edificio en cuestión por sus coordenadas. Combinado con el tiempo de trayecto a pie (que calculas tú, no lo da la API), sale un "sal a las 08:47 para llegar a las 09:00" sin que nadie tenga que mirar un cartel en la calle.