From 9bb9b7412db128ab4a4bb4dcd54cb447d1702d6c Mon Sep 17 00:00:00 2001
From: Delthia <git@delthia.com>
Date: Sat, 4 Jan 2025 22:39:04 +0100
Subject: Documentación api itranvias
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/urban/coruna/paradas.md | 50 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 docs/urban/coruna/paradas.md

(limited to 'docs/urban/coruna/paradas.md')

diff --git a/docs/urban/coruna/paradas.md b/docs/urban/coruna/paradas.md
new file mode 100644
index 0000000..9824e28
--- /dev/null
+++ b/docs/urban/coruna/paradas.md
@@ -0,0 +1,50 @@
+# Paradas
+
+Esta sección describe cómo obtener los próximos buses para una parada y, por tanto, son datos en tiempo real.
+
+Para obtener los datos se puede utilizar la ruta
+
+```
+https://itranvias.com/queryitr_v3.php?&func=0&dato=10
+```
+
+Donde el parámetro `dato` es el identificador de la parada para la que se quieren consultar los buses. La respuesta tendrá esta forma:
+
+```json
+{
+    "resultado": "OK",
+    "fecha_peticion": "20230922152056",
+    "peticion": "jbuses?parada=100&version=2",
+    "tama\u00f1o": 700,
+    "buses": {
+        "parada": 100,
+        "lineas": [
+            {
+                "linea": 500,
+                "buses": [
+                    {
+                        "bus": 385,
+                        "tiempo": "<1",
+                        "distancia": "186",
+                        "estado": 1,
+                        "ult_parada": 203
+                    },
+                    ...
+                ],
+                ...
+            },
+            ...
+        ]
+    }
+}
+```
+
+El contenido principal se encuentra bajo la clave `buses['paradas']` y, donde existe una entrada para cada línea **activa** (esto es importante, no incluirá aquellas líneas que pasan por la parada pero para las que ya no hay buses activos con ese destino) y, dentro de la clave `buses`, una entrada de diccionario para cada bus con la información:
+
+- Identificador del bus: `id`
+- Tiempo que tardará en llegar a la parada: `tiempo`. En minutos pero el valor será _<1_ cuando el bus esté a punto de llegar
+- Distancia del bus a la parada en metros: `distancia`
+- Estado del bus: `estado`, con los siguientes valores:
+    - 0: El bus está en la parada
+    - 1: El bus está en movimiento
+- Última parada del recorrido por la que pasó el bus: `ult_parada`
-- 
cgit v1.3