Update alsa.md

1 files changed, 266 insertions, 1 deletions

diff --git a/docs/autonomic/operator/alsa.md b/docs/autonomic/operator/alsa.md
index 1795ef9..35bc3dd 100644
--- a/docs/autonomic/operator/alsa.md
+++ b/docs/autonomic/operator/alsa.md
@@ -1,3 +1,268 @@
 # ALSA
 
-Bus interurbano operado por ALSA.
+La empresa ALSA opera en la actualidad 3 concesiones de autobús de la Xunta de Galicia: XG642 (Metropolitano de Ferrol), XG719 (Barreiros-Ribadeo, con anexos) y XG881 (Leste da comarca da Coruña). También opera varias rutas nacionales e internacionales con parada en las estaciones gallegas.
+
+## Datos estáticos
+
+Los datos de las líneas de autobuses de ALSA se pueden obtener en formato GTFS desde el [NAP](../other/nap.md) del Ministerio de Transportes y Movilidad Sostenible. La URL del dataset es <https://nap.transportes.gob.es/Files/Detail/932>, en el caso del ofrecido por ALSA; y  <https://nap.transportes.gob.es/Files/Detail/1386>, en el caso del ofrecido por la Xunta de Galicia.
+
+!!! warning "Aviso"
+    Estos archivos contienen la totalidad de líneas operadas por ALSA en España y en el caso de los de la Xunta, todos los autobuses gestionados por esta administración.
+
+## Datos en tiempo real
+
+No existe un feed público en un formato estándar (como lo son GTFS-RealTime o SIRI) para acceder a las estimaciones de llegada de los autobuses urbanos en tiempo real. Por tanto, no hay forma de obtener las estimaciones de llegadas a las paradas, ni alertas de servicio ni posiciones de los vehículos.
+
+La única forma de acceder a estos datos (de manera individualizada) es aprovechando distintas API de ALSA o [Xunta](../autonomic/index.md), extraídas de las apps Alsa Regional y Transporte Público de Galicia, respectivamente.
+
+## Parámetros para usar la API
+
+Para usar la API de Alsa es necesario hacer peticiones HTTPS POST con diferentes parámetros. El `Content-Type` tendrá siempre el valor `application/json` y en el body los siguientes datos:
+
+```http
+{
+  "authentication": {
+    "date": 20221104,
+    "operation": 174032,
+    "provider": "ABAMOBILE",
+    "time": 153335,
+    "token": "1966E8D2D03754E63DA035CD1A83355ECA6172830A838BD1"
+  },
+  "company": 542,
+  "conceCod": 1546
+}
+```
+En el parámetro `company` es necesario poner `541` para Ferrol y `542` para A Coruña, y en `conceCod` los valores `1368` para Ferrol y `1546` para A Coruña.
+
+## Paradas
+
+Llamando por HTTP POST con los parámetros adecuados a la siguiente URL se obtienen todas las paradas con su id, nombre largo, nombre corto y coordenadas (EN RADIANES).
+
+```http
+POST https://apps.alsa.es/rest/api/apps/v1/getStops/
+
+{
+    "status": "ok",
+    "info": [
+        {
+            "oriCod": "15002",
+            "paraCod": "2",
+            "origen": "PLAZA DE OURENSE PLAZA DE OURENSE",
+            "latGPS": "0.75684979",
+            "lonGPS": "-0.14669449",
+            "find": "PLAZA DE OURENSE"
+        },
+        {...}
+    ]
+
+}
+```
+
+Existen otras variantes como OriStops o DestiStops.
+
+```http
+POST https://apps.alsa.es/rest/api/apps/v1/getOriStops/
+
+{
+    "status": "ok",
+    "info": [
+        {
+            "oriCod": "15001",
+            "origen": "ENTREXARDINS",
+            "latGPS": "0.75690374",
+            "lonGPS": "-0.14665775",
+            "find": "ENTREXARDINS"
+        },
+        {...}
+    ]
+
+}
+```
+
+```http
+POST https://apps.alsa.es/rest/api/apps/v1/getDestiStops/
+
+{
+    "status": "ok",
+    "info": [
+{
+            "desCod": "15001",
+            "destino": "ENTREXARDINS",
+            "latGPS": "0.75690374",
+            "lonGPS": "-0.14665775",
+            "find": "ENTREXARDINS"
+        },
+        {...}
+    ]
+
+}
+```
+
+## Líneas
+
+Llamando por HTTP POST con los parámetros adecuados a la siguiente URL se obtienen todas las líneas con su id, nombre largo, nombre corto y color representativo.
+
+```http
+POST https://apps.alsa.es/rest/api/urb/v1/getLines/
+
+{
+    "status": "ok",
+    "info": [
+        {
+            "id": 11149,
+            "name": "A1 ENTREXARDÍNS-LABORAL-A BARCALA-CAMBRE-A PATIÑA-OS CAMPONS",
+            "shortName": "A1",
+            "color": "008DD2",
+            "colorText": "FFFFFF"
+        },
+        {...}
+    ]
+
+}
+```
+
+### Rutas
+
+Llamando por HTTP POST con los parámetros adecuados (los de siempre y además junto a `conceCod` hay que añadir el valor `lineId` que corresponda) a la siguiente URL se obtienen todas las rutas de una línea con su respectivo id, nombre, sentido (tipo) y color.
+
+```http
+POST https://apps.alsa.es/rest/api/urb/v1/getJourneys/
+
+{
+    "status": "ok",
+    "info": [
+        {
+            "id": 101,
+            "name": "Entrexardins-Cambre-Os Campons",
+            "type": "I",
+            "lineId": 11149,
+            "color": "008DD2",
+            "colorText": "FFFFFF"
+        },
+        {
+            "id": 101,
+            "name": "Os Campons-Cambre-Entrexardins",
+            "type": "I",
+            "lineId": 11176,
+            "color": "008DD2",
+            "colorText": "FFFFFF"
+        }
+    ]
+
+}
+```
+!!! warning "Aviso"
+    Muchas líneas usan distintos id para la ida y para la vuelta.
+
+### Detalles ruta    
+
+Llamando por HTTP POST con los parámetros adecuados (los de siempre y además junto a `conceCod` hay que añadir el valor `lineId` y `journeyId` que corresponda) a la siguiente URL se obtienen los vehículos recorriendo la ruta y las paradas con su respectivo id, nombre, sentido (stopLocationId), orden, coordenadas (EN RADIANES) y líneas con enlace.
+
+```http
+POST https://apps.alsa.es/rest/api/urb/v1/getJourneys/
+
+{
+    "status": "ok",
+    "info": [
+        {
+            "vehicles": null,
+            "jouneyStops": [
+                {
+                    "order": 1,
+                    "name": "ENTREXARDINS",
+                    "locationId": 15001,
+                    "stopLocationId": 1,
+                    "latitude": "0.75690374",
+                    "longitude": "-0.14665775",
+                    "connections": [
+                        11101,
+                        11102,
+                        11103,
+                        11104,
+                        11107,
+                        11110,
+                        11113,
+                        11126,
+                        11127,
+                        11134,
+                        11135,
+                        11149,
+                        11152,
+                        11153,
+                        11154,
+                        11155,
+                        11158,
+                        11160,
+                        11163,
+                        11164,
+                        11167,
+                        11168,
+                        11176,
+                        11113
+                    ]
+                },
+        {...}
+    ]
+
+}
+```    
+### Forma de ruta
+
+Llamando por HTTP POST con los parámetros adecuados (los de autentificación y en lugar de `company` y `conceCod` usaremos `itiCod` y `linCod`) a la siguiente URL se obtiene la forma en geojson sobre una ruta concreta.
+
+```http
+POST https://apps.alsa.es/rest/api/apps/v1/getShape/
+
+{
+    "status": "ok",
+    "info": {
+        "valid": "20250107030000",
+        "geojson": {
+            "type": "LineString",
+            "coordinates": [
+                [
+                    -8.402852,
+                    43.367434
+                ],
+                [...]
+            ]
+        }
+    }
+}
+```
+### Estimaciones para una parada
+
+Llamando por HTTP POST con los parámetros adecuados (los de siempre y además junto a `conceCod` hay que añadir el valor `lineId`, `locale` que pueden usarse los valores `es`,`gl`,`ca`, `en` y `fr`; `locationId`, `stopLocationId` y `records`) a la siguiente URL se pueden obtener las estimaciones de llegada para una parada, ordenadas por tiempo de manera ascendente, junto a datos de la parada como su nombre y la ubicación.
+
+```http
+POST https://apps.alsa.es/rest/api/urb/v1/getDeparturesStop/
+
+{
+    "status": "ok",
+    "info": [
+        {
+            "date": "06/01/2025",
+            "time": "05:50:00",
+            "destId": "15132",
+            "destName": "OS CAMPONS (H.ALBA)",
+            "latGPS": "0.75690374",
+            "lonGPS": "-0.14665775",
+            "lineId": "11149",
+            "lineName": "A1 ENTREXARDÍNS-LABORAL-A BARCALA-CAMBRE-A PATIÑA-OS CAMPONS",
+            "lineShortName": "A1",
+            "color": "008DD2",
+            "colorText": "FFFFFF",
+            "itiId": "101",
+            "expeId": "15",
+            "oriId": "15001",
+            "oriName": "ENTREXARDINS",
+            "visit": 0,
+            "est": 0,
+            "estText": "SIN ESTIMACIÓN EN ESTE MOMENTO",
+            "estCol": "0,0,0,1.00"
+        },
+        {...}
+    ]
+
+}
+```
\ No newline at end of file