Merge branch 'master' into feed_contact

Author: antrim

gtfs-realtime/CHANGES.md

@@ -19,6 +19,7 @@ The official specification, reference and documentation are written in English.
     If a voter changes her vote, it is recommended to do it by updating the original vote comment by striking through the vote and writing the new vote.
   - Votes before the start of the voting period are not considered.
 1. The proposal is accepted if there is a unanimous consensus yes with at least 3 votes.
+  - The proposer's vote does not count towards the 3 vote total. For example, if Proposer X creates a pull request and votes yes, and User Y and Z vote yes, this is counted as 2 total yes votes.
   - Votes against shall be motivated, and ideally provide actionable feedback.
   - If the vote has failed, then the advocate may choose to continue work on the proposal, or to abandon the proposal.
     Either decision of the advocate must be announced in the mailing list.
@@ -79,3 +80,6 @@ extend transit_realtime.TripDescriptor {
 |1004|Metra|[William Ashbaugh <w.l.ashbaugh@gmail.com>](mailto:w.l.ashbaugh@gmail.com)|
 |1005|Metro-North Railroad|[John Larsen](mailto:mnrappdev@mnr.org)|
 |1006|realCity|[David Varga](mailto:transit@realcity.io)|http://realcity.io|
+|1007|NSW TrainLink|[Gregory Nicholls](mailto:gregory.nicholls@transport.nsw.gov.au)|[Group discussion](https://groups.google.com/d/msg/gtfs-realtime/G75O1zyQS_Q/VtNmTJvSAwAJ)|
+|1008|SEPTA - Southeastern Pennsylvania Transportation Authority|[Gregory Apessos](mailto:GApessos@septa.org)|https://github.com/septadev|
+|1009|Swiftly|[mike@goswift.ly](mailto:mike@goswift.ly)|[Group Discussion](https://groups.google.com/forum/#!msg/gtfs-realtime/mmnZV6L-2ls/wVWdknhLBwAJ)|

gtfs-realtime/README.md

@@ -2,6 +2,8 @@ This directory contains GTFS Realtime Specification and documentation.
 
 ### Quick links
 - [GTFS Realtime protocol buffer definition](proto/gtfs-realtime.proto)
-- [Documentation](spec/en)
+- Documentation
+  - [English](spec/en)
+  - [Español](spec/es)
 - [How to change the specification?](CHANGES.md)
 

gtfs-realtime/proto/gtfs-realtime.proto

@@ -31,6 +31,10 @@ package transit_realtime;
 // obtained as a response to an appropriate HTTP GET request.
 // A realtime feed is always defined with relation to an existing GTFS feed.
 // All the entity ids are resolved with respect to the GTFS feed.
+// Note that "required" and "optional" as stated in this file refer to Protocol
+// Buffer cardinality, not semantic cardinality.  See reference.md at
+// https://github.com/google/transit/tree/master/gtfs-realtime for field
+// semantic cardinality.
 message FeedMessage {
   // Metadata about this feed and feed message.
   required FeedHeader header = 1;
@@ -47,7 +51,7 @@ message FeedMessage {
 // Metadata about a feed, included in feed messages.
 message FeedHeader {
   // Version of the feed specification.
-  // The current version is 1.0.
+  // The current version is 2.0.
   required string gtfs_realtime_version = 1;
 
   // Determines whether the current fetch is incremental.  Currently,

gtfs-realtime/spec/en/examples/alerts.asciipb

@@ -1,7 +1,7 @@
 # header information
 header {
-  # version of speed specification. Currently "1.0"
-  gtfs_realtime_version: "1.0"
+  # version of speed specification. Currently "2.0"
+  gtfs_realtime_version: "2.0"
 
   # determines whether dataset is incremental or full
   incrementality: FULL_DATASET

gtfs-realtime/spec/en/examples/trip-updates-full.asciipb

@@ -1,7 +1,7 @@
 # header information
 header {
-  # version of speed specification. Currently "1.0"
-  gtfs_realtime_version: "1.0"
+  # version of speed specification. Currently "2.0"
+  gtfs_realtime_version: "2.0"
   # determines whether dataset is incremental or full
   incrementality: FULL_DATASET
   # the moment where this dataset was generated on server

gtfs-realtime/spec/en/reference.md

@@ -1,10 +1,10 @@
 GTFS en tiempo real es una especificación de feed que permite que las empresas de tranporte público proporcionen actualizaciones en tiempo real sobre su flota a los programadores de la aplicación. Es una extensión de [GTFS](https://developers.google.com/transit/gtfs/reference) (Especificación general de feeds de transporte público), un formato de datos abierto para los horarios de transporte público y la información geográfica asociada. GTFS en tiempo real fue diseñado en torno a la facilidad de implementación, buena interoperabilidad GTFS y un enfoque en la información al pasajero.
 
-La especificación fue diseñada a través de una asociación de las empresas miembro de las [Actualizaciones del transporte público en tiempo real](https://developers.google.com/transit/google-transit#LiveTransitUpdates) iniciales, diferentes programadores de transporte público y Google. La especificación está publicada bajo la licencia [Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0).
+La especificación fue diseñada a través de la asociación de las empresas que eran inicialmente miembros de [Actualizaciones del transporte público en tiempo real](https://developers.google.com/transit/google-transit#LiveTransitUpdates), diferentes programadores de transporte público y Google. La especificación está publicada bajo la licencia [Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0).
 
 ## ¿Cómo empiezo?
 
-1.  Sigue leyendo el resumen general a continuación.
+1.  Sigue leyendo el resumen general.
 2.  Decide qué [tipos de feed](feed-types.md) proporcionarás.
 3.  Consulta los [ejemplos de feeds](examples/).
 4.  Crea tus propios feeds mediante la [referencia](reference.md).
@@ -18,9 +18,9 @@ La especificación es compatible actualmente con los siguientes tipos de informa
 *   **Alertas del servicio**: traslados de paradas o eventos imprevistos que afectan una estación, ruta o toda la red
 *   **Posiciones del vehículo**: información sobre los vehículos, incluidos la ubicación y el nivel de congestión
 
-Las actualizaciones de cada tipo se proporcionan en un feed separado. Los feeds se muestran a través de HTTP y se actualizan con frecuencia. El archivo en sí es un archivo binario normal, por lo que cualquier tipo de servidor web puede alojar y mostrar el archivo (es posible utilizar otros protocolos de transferencia también). Alternativamente, los servidores de aplicaciones web también se podrían utilizar, los cuales devolverán el feed como una respuesta a una solicitud GET de HTTP válida. No hay limitaciones en cuanto a la frecuencia ni al método exacto de cómo el feed debe ser actualizado o recuperado.
+Las actualizaciones de cada tipo se proporcionan en un feed separado. Los feeds se muestran a través de HTTP y se actualizan con frecuencia. El archivo en sí es un archivo binario normal, por lo que cualquier tipo de servidor web puede alojar y mostrar el archivo (es posible utilizar otros protocolos de transferencia también). También se podrían utilizar servidores de aplicaciones web, los cuales devolverían el feed como una respuesta a una solicitud GET de HTTP válida. No hay limitaciones en cuanto a la frecuencia ni a los métodos exactos con los que el feed debe ser actualizado o recuperado.
 
-Ya que GTFS en tiempo real te permite presentar el estado _real_ de tu flota, el feed debe ser actualizado con frecuencia, de preferencia cuando se ingresen nuevos datos de tu sistema de ubicación automática de vehículos.
+Ya que GTFS en tiempo real te permite presentar el estado _real_ de tu flota, el feed debe ser actualizado con frecuencia, preferentemente cuando se reciban nuevos datos del sistema de ubicación automática de vehículos.
 
 [Más información sobre los tipos de feed...](feed-types.md)
 
@@ -36,7 +36,7 @@ Los búferes de protocolo son un mecanismo de lenguaje y plataforma neutral para
 
 La jerarquía de los elementos y las definiciones de su tipo están especificadas en el archivo [gtfs-realtime.proto](gtfs-realtime.proto).
 
-Este archivo de texto se utiliza para generar las bibliotecas necesarias en tu lenguaje de programación seleccionado. Estas bibliotecas proporcionan las clases y funciones necesarias para generar feeds GTFS en tiempo real válidos. Las bibliotecas no solo hacen que la creación del feed sea más fácil, sino que también garantizan que solo se produzcan feeds válidos.
+Este archivo de texto se utiliza para generar las bibliotecas necesarias en el lenguaje de programación que se elija. Estas bibliotecas proporcionan las clases y funciones necesarias para generar feeds GTFS en tiempo real válidos. Las bibliotecas no solo hacen que la creación del feed sea más fácil, sino que también garantizan que solo se produzcan feeds válidos.
 
 [Más información sobre la estructura de los datos.](reference.md)
 
@@ -47,4 +47,3 @@ Para participar en los debates sobre GTFS en tiempo real y sugerir cambios y adi
 ## Google Maps y Actualizaciones de transporte público en tiempo real
 
 Una de las posibles aplicaciones que utiliza GTFS en tiempo real es [Actualizaciones de transporte público en tiempo real](https://developers.google.com/transit/google-transit#LiveTransitUpdates), una función de Google Maps que proporciona a los usuarios información de transporte público en tiempo real. Si trabajas para una empresa de transporte público que está interesada en proporcionar actualizaciones en tiempo real para Google Maps, visita la [Página de socios de Google Transit](http://maps.google.com/help/maps/transit/partners/live-updates.html).
-

gtfs-realtime/spec/es/README.md

@@ -1,4 +1,4 @@
-Los siguientes ejemplos muestran una representación textual de los feeds. Durante el desarrollo, es más conveniente producir una salida de búfer del protocolo ASCII para una depuración más fácil. Puedes comparar tu salida de texto con estos ejemplos para comprobar la validez de los datos.
+Los siguientes ejemplos muestran una representación textual de los feeds. Durante el desarrollo, es conveniente producir búferes de protocolo en formato ASCII para que la depuración resulte más sencilla. Puedes comparar tus archivos de texto resultantes con estos ejemplos para comprobar la validez de los datos:
 
 *   [Alertas de Google](alerts.asciipb)
 *   [Actualización de viaje (conjunto de datos completo)](trip-updates-full.asciipb)

gtfs-realtime/spec/es/examples/README.md

@@ -1,18 +1,18 @@
-La especificación GTFS en tiempo real admite el envío de tres tipos diferentes de datos en tiempo real. Si bien la sintaxis del archivo [gtfs-realtime.proto](gtfs-realtime.proto) permite que se mezclen distintos tipos de entidades para un feed, solo se puede usar un tipo de entidad por feed. Los resúmenes se ofrecen a continuación, con la documentación completa proporcionada en la sección correspondiente.
+La especificación GTFS en tiempo real admite el envío de tres tipos diferentes de datos en tiempo real. Si bien la sintaxis del archivo [gtfs-realtime.proto](gtfs-realtime.proto) permite que se mezclen distintos tipos de entidades para un único feed, solo se puede usar un tipo de entidad por feed. Puedes encontrar resúmenes más abajo, teniendo la documentación completa en la sección correspondiente.
 
 ## Actualizaciones de viaje
 
 #### "El autobús X tiene una demora de cinco minutos".
 
-Las actualizaciones de viaje ofrecen información acerca de fluctuaciones en el horario. Esperamos recibir actualizaciones de viaje para todos los viajes programados cuya duración se puede predecir en tiempo real. Estas actualizaciones ofrecerían un horario de llegada o salida para las diferentes paradas de la ruta. Las actualizaciones de viaje también pueden brindar información en situaciones más complejas, como cuando los viajes se cancelan o agregan al programa, o como cuando su trayecto se modifica.
+Las actualizaciones de viaje ofrecen información acerca de fluctuaciones en el horario. Esperamos recibir actualizaciones de viaje de todos los viajes programados cuya duración se puede predecir en tiempo real. Estas actualizaciones ofrecerían un horario de llegada o salida para las diferentes paradas de la ruta. Las actualizaciones de viaje también pueden brindar información en situaciones más complejas, como cuando los viajes se cancelan o agregan al programa, o como cuando su trayecto se modifica.
 
 [Más información acerca de las Actualizaciones de viaje...](trip-updates.md)
 
 ## Alertas de servicio
 
 #### "La estación Y está cerrada por tareas de construcción".
 
-Las alertas de servicio ofrecen información acerca de los problemas más graves que puede sufrir una entidad en particular. En general, se expresan a través de una descripción textual de la interrupción.
+Las alertas de servicio ofrecen información acerca de problemas más graves que puede sufrir una entidad en particular. En general, se expresan a través de una descripción textual de la interrupción.
 
 Pueden representar los problemas que sufren:
 
@@ -31,6 +31,6 @@ Una alerta de servicio a menudo consiste en una descripción textual del problem
 
 La posición de un vehículo ofrece datos básicos acerca de un vehículo en particular de la red.
 
-La información más importante consiste en la latitud y longitud donde se encuentra el vehículo. Sin embargo, también podemos usar datos acerca de las lecturas del cuentakilómetros y velocidad actuales del vehículo.
+La información más importante consiste en la latitud y longitud donde se encuentra el vehículo. Sin embargo, también podemos usar las lecturas de cuentakilómetros y velocidad actuales del vehículo.
 
 [Más información acerca las actualizaciones de las Posiciones de los vehículos...](vehicle-positions.md)

gtfs-realtime/spec/es/feed-types.md

@@ -158,7 +158,7 @@ message TripUpdate {
   // La incertidumbre se aplica de la misma forma tanto al tiempo como a la
   // demora.  La incertidumbre especifica el error esperado en una demora real
   // (pero ten en cuenta, que todavía no definimos su significado estadístico
-  // preciso). Es posible que la incertidumbre sea 0, por ejemplo, para los
+  // concreto). Es posible que la incertidumbre sea 0, por ejemplo, para los
   // trenes que funcionan con un control de horarios por computadora.
   message StopTimeEvent {
     // La demora (en segundos) puede ser positiva (significa que el vehículo