[Monthly update] Nov-Dec 2024 (#559)

* Update EN Schedule Reference * Update EN schedule revision history * Update EN realtime revision history * update EN realtime reference * update EN proto * update FR proto * update FR realtime reference * update FR realtime revision history * update FR schedule revision history * update FR schedule reference * Small fixes for FR realtime revision history * update JA schedule reference * update JA schedule revision history * update JA realtime reference * update JA realtime revision history * update JA realtime proto * update ES realtime reference * update ES realtime revision history * update ES schedule revision history * update ES proto * update ES schedule reference * Formatting fixes in schedule reference (all langs) * Adjust ES schedule revision history title
MobilityData · Dec 19, 2024 · 325027e · 325027e
1 parent 642fe3a
commit 325027e
Show file tree

Hide file tree

Showing 24 changed files with 275 additions and 117 deletions.
diff --git a/docs/en/documentation/realtime/change-history/revision-history.md b/docs/en/documentation/realtime/change-history/revision-history.md
@@ -2,6 +2,10 @@
 
 ### Revision History
 
+#### December 2024
+
+* Added new string field that matches feed_info.feed_version from the GTFS Schedule feed that the realtime data is based on. See [discussion](https://github.com/google/transit/pull/434).
+
 #### October 2024
 
 * Clarification and small changes for Trip Modifications. See [discussion](https://github.com/google/transit/pull/497).

diff --git a/docs/en/documentation/realtime/gtfs-realtime.proto b/docs/en/documentation/realtime/gtfs-realtime.proto
@@ -73,6 +73,11 @@ message FeedHeader {
   // January 1st 1970 00:00:00 UTC).
   optional uint64 timestamp = 3;
 
+  // String that matches the feed_info.feed_version from the GTFS feed that the real
+  // time data is based on. Consumers can use this to identify which GTFS feed is
+  // currently active or when a new one is available to download.
+  optional string feed_version = 4;
+
   // The extensions namespace allows 3rd-party developers to extend the
   // GTFS Realtime specification in order to add and evaluate new features and
   // modifications to the spec.

diff --git a/docs/en/documentation/realtime/proto.md b/docs/en/documentation/realtime/proto.md
@@ -77,6 +77,11 @@ message FeedHeader {
   // January 1st 1970 00:00:00 UTC).
   optional uint64 timestamp = 3;
 
+  // String that matches the feed_info.feed_version from the GTFS feed that the real
+  // time data is based on. Consumers can use this to identify which GTFS feed is
+  // currently active or when a new one is available to download.
+  optional string feed_version = 4;
+
   // The extensions namespace allows 3rd-party developers to extend the
   // GTFS Realtime specification in order to add and evaluate new features and
   // modifications to the spec.

diff --git a/docs/en/documentation/realtime/reference.md b/docs/en/documentation/realtime/reference.md
@@ -107,6 +107,7 @@ Metadata about a feed, included in feed messages.
 | **gtfs_realtime_version** | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | Required | One | Version of the feed specification. The current version is 2.0. |
 | **incrementality** | [Incrementality](#enum-incrementality) | Required | One |
 | **timestamp** | [uint64](https://protobuf.dev/programming-guides/proto2/#scalar) | Required | One | This timestamp identifies the moment when the content of this feed has been created (in server time). In POSIX time (i.e., number of seconds since January 1st 1970 00:00:00 UTC). To avoid time skew between systems producing and consuming realtime information it is strongly advised to derive timestamp from a time server. It is completely acceptable to use Stratum 3 or even lower strata servers since time differences up to a couple of seconds are tolerable. |
+| **feed_version** | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | Optional | One | String that matches the `feed_info.feed_version` from the GTFS feed that the realtime data is based on. Consumers can use this to identify which GTFS feed is currently active or when a new one is available to download. |
 
 ### _enum_ Incrementality
 

diff --git a/docs/en/documentation/schedule/change-history/revision-history.md b/docs/en/documentation/schedule/change-history/revision-history.md
@@ -2,6 +2,9 @@
 
 ### Revision History
 
+#### December 2024
+* Added `fare_leg_join_rules.txt` and introduced the concept of Effective Fare Leg. See [discussion](https://github.com/google/transit/pull/439).
+
 #### September 2024
 * Clarify presence and use of from/to_stop_id & from/to_trip_id fields in transfers.txt. See [discussion](https://github.com/google/transit/pull/455).
 * Added validity rules for polygons in GeoJSON files. See [discussion](https://github.com/google/transit/pull/476)

diff --git a/docs/en/documentation/schedule/reference.md b/docs/en/documentation/schedule/reference.md
diff --git a/docs/es/documentation/realtime/change-history/revision-history.md b/docs/es/documentation/realtime/change-history/revision-history.md
@@ -2,21 +2,25 @@
 
 ## Historial de revisiones
 
+#### Diciembre de 2024
+
+* Se agregó un nuevo campo de string que coincide con feed_info.feed_version de la fuente de GTFS Schedule en la que se basan los datos en tiempo real. Consulte la [discusión](https://github.com/google/transit/pull/434).
+
 #### Octubre de 2024
 
  * Aclaraciones y pequeños cambios para las modificaciones de viaje (Trip Modifications). Consulte la [discusión](https://github.com/google/transit/pull/497).
 
 #### Marzo 2024 
 
- * Modificaciones de viaje adoptadas. Consulte la [discusión](https://github.com/google/transit/pull/403). 
+ * Modificaciones de viaje (trip modifications) adoptado. Consulte la [discusión](https://github.com/google/transit/pull/403). 
 
 #### Noviembre 2022 
 
  * Se agregó soporte para viajes DELETED. Consulte la [discusión](https://github.com/google/transit/pull/352). 
 
 #### Julio 2022 
 
- * Añadir cause_detail y effect_detail. Ver [discusión](https://github.com/google/transit/pull/332) 
+ * Se agregó cause_detail y effect_detail. Ver [discusión](https://github.com/google/transit/pull/332) 
  * Se agregó la capacidad de especificar un valor accesible para sillas de ruedas en un TripUpdate. VehicleDescriptor. Consulte la [discusión](https://github.com/google/transit/pull/340). 
 
 #### Septiembre 2021 
@@ -25,38 +29,38 @@
 
 #### Agosto de 2021 
 
- * Agregar GTFS-NewShapes como experimental. Consulte la [discusión](https://github.com/google/transit/pull/272). 
+ * Se agregó GTFS-NewShapes como experimental. Consulte la [discusión](https://github.com/google/transit/pull/272). 
 
 #### Abril de 2021 
 
- * Agregar return_occupancy_status a TripUpdate. Consulte la [discusión](https://github.com/google/transit/pull/260). 
+ * Se agregó return_occupancy_status a TripUpdate. Consulte la [discusión](https://github.com/google/transit/pull/260). 
 
 #### Febrero 2021 
 
  * Aclaración de las descripciones de ocupación de GTFS Realtime. Consulte la [discusión](https://github.com/google/transit/pull/259). 
 
 #### Septiembre 2020 
 
- * Soporta aglomeración de varios autos. Consulte la [discusión](https://github.com/google/transit/pull/237). 
+ * Soporte para la aglomeración de varios autos (multi-car crowding). Consulte la [discusión](https://github.com/google/transit/pull/237). 
 
 #### Abril 2020 
 
- *Asignaciones de parada de soporte. Consulte la [discusión](https://github.com/google/transit/pull/219). 
+ * Soporte para asignaciones de parada. Consulte la [discusión](https://github.com/google/transit/pull/219). 
 
 #### Julio 2020 
 
- * Soporta viajes DUPLICADOS. Consulte la [discusión](https://github.com/google/transit/pull/221). 
+ * Soporte para viajes DUPLICADOS. Consulte la [discusión](https://github.com/google/transit/pull/221). 
  * Alerta tts_header_text, tts_description_text ya no es experimental. Consulte la [discusión](https://github.com/google/transit/pull/229). 
- * Etiquete los viajes GTFS-RT AGREGADOS como no completamente especificados. Consulte la [discusión](https://github.com/google/transit/pull/230). 
+ * Etiqueta los viajes GTFS-RT AGREGADOS como no completamente especificados. Consulte la [discusión](https://github.com/google/transit/pull/230). 
 
 #### Abril 2020 
 
- * Marcar SeverityLevel como final. Consulte la [discusión](https://github.com/google/transit/pull/214). 
+ * Marca SeverityLevel como final. Consulte la [discusión](https://github.com/google/transit/pull/214). 
  * Agregar porcentaje_ocupación. Consulte la [discusión](https://github.com/google/transit/pull/213). 
 
 #### 12 de marzo de 2020 
 
- *Recomendar proporcionar predicciones de TripUpdate para el próximo viaje en bloque. Consulte la [discusión](https://github.com/google/transit/pull/206). 
+ * Recomendar proporcionar predicciones de TripUpdate para el próximo viaje en bloque. Consulte la [discusión](https://github.com/google/transit/pull/206). 
 
 #### Agosto de 2019 
 
@@ -65,13 +69,13 @@
 
 #### Mayo de 2019 
 
- * Agregar efecto de alerta de problema de accesibilidad. Consulte la [discusión](https://github.com/google/transit/pull/164). 
+ * Se agregó efecto de alerta de problema de accesibilidad. Consulte la [discusión](https://github.com/google/transit/pull/164). 
 
 #### Febrero de 2019 
 
- * Agregar opción de efecto NO_EFFECT para alerta de servicio GTFS en tiempo real. Consulte la [discusión](https://github.com/google/transit/pull/137). 
- * Agregar un nuevo campo opcional SeverityLevel al feed de alertas de servicio. Consulte la [discusión](https://github.com/google/transit/pull/136). 
- * Agregar nuevos campos opcionales para la funcionalidad de Texto a Voz en el feed de alertas de servicio. Consulte la [discusión](https://github.com/google/transit/pull/135). 
+ * Se agregó opción de efecto NO_EFFECT para alerta de servicio GTFS en tiempo real. Consulte la [discusión](https://github.com/google/transit/pull/137). 
+ * Se agregó un nuevo campo opcional SeverityLevel al feed de alertas de servicio. Consulte la [discusión](https://github.com/google/transit/pull/136). 
+ * Se agregó nuevos campos opcionales para la funcionalidad de Texto a Voz en el feed de alertas de servicio. Consulte la [discusión](https://github.com/google/transit/pull/135). 
 
 #### Abril 2018 
 

diff --git a/docs/es/documentation/realtime/gtfs-realtime.proto b/docs/es/documentation/realtime/gtfs-realtime.proto
@@ -73,6 +73,11 @@ message FeedHeader {
   // January 1st 1970 00:00:00 UTC).
   optional uint64 timestamp = 3;
 
+  // String that matches the feed_info.feed_version from the GTFS feed that the real
+  // time data is based on. Consumers can use this to identify which GTFS feed is
+  // currently active or when a new one is available to download.
+  optional string feed_version = 4;
+
   // The extensions namespace allows 3rd-party developers to extend the
   // GTFS Realtime specification in order to add and evaluate new features and
   // modifications to the spec.

diff --git a/docs/es/documentation/realtime/proto.md b/docs/es/documentation/realtime/proto.md
@@ -77,6 +77,11 @@ message FeedHeader {
   // January 1st 1970 00:00:00 UTC).
   optional uint64 timestamp = 3;
 
+  // String that matches the feed_info.feed_version from the GTFS feed that the real
+  // time data is based on. Consumers can use this to identify which GTFS feed is
+  // currently active or when a new one is available to download.
+  optional string feed_version = 4;
+
   // The extensions namespace allows 3rd-party developers to extend the
   // GTFS Realtime specification in order to add and evaluate new features and
   // modifications to the spec.

diff --git a/docs/es/documentation/realtime/reference.md b/docs/es/documentation/realtime/reference.md
@@ -107,6 +107,7 @@
  | **gtfs_realtime_version** | [string](https://protobuf.dev/programming-guides/proto2/#scalar) | Obligatorio | Uno | Versión de la especificación del feed. La versión actual es 2.0. | 
  | **incrementality** | [Incrementality](#enum-incrementality) | Obligatorio | Uno | 
  | **timestamp** | [uint64](https://protobuf.dev/programming-guides/proto2/#scalar) | Obligatorio | Uno | Esta marca de tiempo identifica el momento en que se creó el contenido de este feed (en hora del servidor). En hora POSIX (es decir, número de segundos desde el 1 de enero de 1970 a las 00:00:00 UTC). Para evitar el desfase temporal entre los sistemas que producen y consumen información en tiempo real, se recomienda encarecidamente derivar la marca de tiempo de un servidor de tiempo. Es completamente aceptable utilizar servidores de estrato 3 o incluso de estratos inferiores, ya que las diferencias horarias de hasta un par de segundos son tolerables. | 
+ |**feed_version**| [string](https://protobuf.dev/programming-guides/proto2/#scalar) | Opcional | Una | Cadena que coincide con `feed_info.feed_version` de la fuente GTFS en la que se basan los datos en tiempo real. Los consumidores pueden usar esto para identificar qué fuente GTFS está activa actualmente o cuándo hay una nueva disponible para descargar. |
 
 ### _enum_ Incrementality 
 

diff --git a/docs/es/documentation/schedule/change-history/revision-history.md b/docs/es/documentation/schedule/change-history/revision-history.md
@@ -1,7 +1,10 @@
-# Calendario GTFS
+# GTFS Schedule
 
 ### Historial de revisiones
 
+#### Diciembre de 2024
+* Se agregó `fare_leg_join_rules.txt` e introdujo el concepto de tramo de tarifa efectiva. Consulte [discusión](https://github.com/google/transit/pull/439).
+
 #### Septiembre de 2024
 * Aclarar la presencia y el uso de los campos from/to_stop_id y from/to_trip_id en transfers.txt. Ver [discusión](https://github.com/google/transit/pull/455).
 * Se agregaron reglas de validez para polígonos en archivos GeoJSON. Ver [discusión](https://github.com/google/transit/pull/476)