Añadir el resto de urbanos de Galicia

4 files changed, 126 insertions, 0 deletions

diff --git a/docs/urban/ferrol.md b/docs/urban/ferrol.md
new file mode 100644
index 0000000..3a48784
--- /dev/null
+++ b/docs/urban/ferrol.md
@@ -0,0 +1,16 @@
+# Urbano de Ferrol
+
+El transporte urbano de Ferrol consiste en un servicio de autobuses urbanos prestado por la [UTE Ferrolbus (ALSA)](https://www.alsaferrol.es/), en régimen de concesión por parte de la Xunta de Galicia, denominada XG642.
+
+## Datos estáticos
+
+Los datos de las líneas de autobuses urbanos de Ferrol 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 ALSA.
+
+!!! 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
+
+Es posible obtener información en tiempo real usando las APIs de [ALSA](../autonomic/operator/alsa.md) o [Xunta](../autonomic/index.md).
+Visite los respectivos artículos para obtener información sobre las mismas.
\ No newline at end of file
diff --git a/docs/urban/lugo.md b/docs/urban/lugo.md
new file mode 100644
index 0000000..7c0f266
--- /dev/null
+++ b/docs/urban/lugo.md
@@ -0,0 +1,44 @@
+# Urbano de Lugo
+
+El transporte urbano de Lugo consiste en un servicio de autobuses urbanos prestado por [AULUSA (Grupo Monbus)](http://urbanoslugo.com/), en régimen de concesión por parte del concello de Lugo.
+
+## Datos estáticos
+
+No existe un feed público en un formato estándar (como lo es GTFS) para acceder a las paradas, líneas y horarios.
+
+
+## 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 APIs de AULUSA, extraídas de la [web oficial de los QRs](https://info.urbanoslugo.com/qr-demo-paradas/uilP)
+
+### Estimaciones para una parada
+
+Llamando al siguiente endpoint, se pueden obtener las estimaciones de llegada para una parada, ordenadas por tiempo de manera ascendente. Poniendo en el parámetro `sms` un código que de momento está pendiente de investigar como obtenerlos se obtienen los datos.
+
+```http
+GET http://indra.sae.monbus.es:8080/EstimacionWebLUGO/estimarWebXml?sms=5006
+
+{
+  "id": 691,
+  "codigo": "691",
+  "nombre": "Hórreo (E. Intermodal)",
+  "zona": "Zona RENFE",
+  "coordenadas": {
+    "latitud": 42.8706512,
+    "longitud": -8.5461194
+  },
+  "lineas": [
+    {
+      "id": 33,
+      "sinoptico": "LP3",
+      "nombre": "San Roque / Santa Lucía / Pajuela",
+      "estilo": "#75bd96",
+      "proximoPaso": "2025-01-05 20:41",
+      "minutosProximoPaso": 0
+    },
+    { ... }
+  ]
+}
+```
\ No newline at end of file
diff --git a/docs/urban/ourense.md b/docs/urban/ourense.md
new file mode 100644
index 0000000..2929d79
--- /dev/null
+++ b/docs/urban/ourense.md
@@ -0,0 +1,51 @@
+# Urbano de Ourense
+
+El transporte urbano de Ourense consiste en un servicio de autobuses urbanos prestado por [Avanza](https://ourense.avanzagrupo.com/), en régimen de concesión por parte del Concello de Ourense, en precario desde 2015.
+
+## Datos estáticos
+
+Los datos de las líneas de autobuses urbanos de Vigo se pueden obtener en formato GTFS desde su propia web o desde el [NAP](../other/nap.md) del Ministerio de Transportes y Movilidad Sostenible. La URL del dataset es <https://ourense.avanzagrupo.com/gt/gtfs-urbano-ourense.zip>, sin necesidad de autenticación, en el caso del de su web o  <https://nap.transportes.gob.es/Files/Detail/1387>, en el caso del ofrecido en el NAP.
+
+!!! note "Nota"
+
+	Los datos de GTFS de Avanza Ourense no parecen actualizarse con regularidad, presentando información errónea con líneas antiguas y horarios que no aplican en los días correspondientes (nocturnos y servicios especiales).
+
+## 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 del Concello de Vigo, extraídas de los QRs de las paradas
+
+
+## _Scraping_
+
+De manera alternativa, se pueden obtener los datos de avisos y tiempo real mediante Web Scraping, muy similar a la API de Vitrasa.
+
+### Avisos
+
+La URL es `https://ourense.avanzagrupo.com/avisos` y el HTML de los avisos se puede obtener, por ejemplo, con el siguiente JavaScript:
+
+```js
+document
+	.querySelectorAll("#v-pills-tabContent .tab-pane")
+	.values()
+	.map(p => p.innerHTML)
+```
+
+### Estimaciones de una parada
+
+La URL es `https://consultasqrou.avanzagrupo.com/default.aspx/?parada=45` , cambiando "parada" por el ID de la parada a consultar. Para sacar las estimaciones, se puede usar, por ejemplo, este JavaScript:
+
+```js
+document.querySelectorAll("#GridView1 > tbody > tr")
+	.values()
+	.map(tr => tr.querySelectorAll("td"))
+	.filter(l => l.length === 3)
+```
+
+Es importante filtrar los `td` donde solo hay tres elementos, porque la "UI" utiliza tablas para todo el diseño, incluyendo la paginación en la parte inferior. Esos tres elementos corresponden, en este orden a "linea", "ruta", "minutos". 
+
+!!! note "Nota"
+
+	Usar la paginación es posible, pero complicado, ya que hay que procesar la primera página, y sacar variables como ViewState, y hacer un POST para obtenerla. Por ello, es mucho más sencillo y eficiente usar la API descrita anteriormente.
+    La web lleva meses caída.
diff --git a/docs/urban/pontevedra.md b/docs/urban/pontevedra.md
new file mode 100644
index 0000000..1e51e96
--- /dev/null
+++ b/docs/urban/pontevedra.md
@@ -0,0 +1,15 @@
+# Urbano de Pontevedra
+
+El transporte urbano de Pontevedra consiste en un servicio de autobuses urbanos prestado por [Autocares Rías Baixas](https://www.autocaresriasbaixas.com/descargas.aspx?grupo=113), en régimen de concesión por parte de la Xunta de Galicia, denominada XG628.
+
+## Datos estáticos
+
+Los datos de las líneas de autobuses urbanos de Pontevedra 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/1518>, en el caso del ofrecido por Rías Baixas; y  <https://nap.transportes.gob.es/Files/Detail/1386>, en el caso del ofrecido por ALSA.
+
+!!! warning "Aviso"
+    Estos archivos contienen la totalidad de líneas operadas por Rías Baixas en Galicia y en el caso de los de la Xunta, todos los autobuses gestionados por esta administración.
+
+
+## Datos en tiempo real
+
+La agencia dispone de un sistema de tiempo real que emplean algunas aplicaciones de terceros, aunque aún no disponemos acceso a el mismo. Además la [Xunta](../autonomic/index.md) también tiene su sistema de tiempo real, pero tampoco está disponible aún para esta concesión.
\ No newline at end of file