Glosario
Los datos de tránsito llevan un vocabulario propio, y Drupal también. Cada término que usa este sitio se define aquí una vez, con las palabras más sencillas que se mantienen precisas.
La especificación
- GTFS
-
General Transit Feed Specification. Un formato publicado para horarios de tránsito: un archivo zip de archivos de texto separados por comas, uno por tipo de registro. La referencia está en gtfs.org.
- GTFS-Realtime
-
A menudo abreviado como GTFS-RT. El formato complementario para datos en vivo — dónde está un vehículo ahora, cuándo llegará, qué está interrumpido. Codificado como Protocol Buffers en lugar de texto.
- GTFS+
-
Un conjunto de extensiones usado por la Metropolitan Transportation Commission y los operadores del Área de la Bahía que reportan a ella. Añade archivos que la especificación base no define, como nombres de dirección y las tablas que vinculan un feed en tiempo real con uno estático.
- Feed
-
Un conjunto de datos publicado. Un feed estático es el zip de horarios que publica una agencia; un feed en tiempo real es un endpoint en vivo que sirve GTFS-Realtime. Una agencia normalmente tiene un feed estático y tres en tiempo real.
- Extension
-
Un archivo en un feed que la especificación base no define. Las extensiones son la forma en que las regiones publican lo que la especificación no cubre.
Lo que contiene un feed
- Agency
-
El operador que publica el feed. Un feed puede contener varios.
- Route
-
Una línea con nombre que los pasajeros reconocen — el 38 Geary, el F Market & Wharves.
- Trip
-
Un vehículo recorriendo una ruta una vez, en un momento particular, en una dirección. Una ruta ejecuta cientos de viajes al día.
- Stop
-
Un lugar donde un vehículo presta servicio. Las paradas llevan un
stop_id, usado dentro del feed, y a menudo unstop_code, el número publicado en el poste para los pasajeros. - Stop time
-
La llegada y salida programada de un viaje en una parada. Esta es la tabla más grande en la mayoría de los feeds por un amplio margen.
- Shape
-
El trazado que sigue un viaje, como una lista ordenada de coordenadas. Lo que un mapa traza cuando dibuja una ruta.
- Service
-
Qué días opera un viaje — días laborables, sábados, festivos. Almacenado en el calendario del feed.
- Headsign
-
El destino mostrado en el frente del vehículo y en un tablero de salidas.
- Direction ID
-
Un 0 o 1 que marca en qué dirección viaja un viaje a lo largo de una ruta. No tiene significado inherente; el nombre legible viene de una extensión.
- Timepoint
-
Una parada donde el horario publicado indica una hora. Las paradas intermedias se pasan sin una hora publicada, razón por la cual un horario impreso es más corto que la lista de paradas.
Tiempo real
- Trip update
-
Una predicción: este viaje llegará a estas paradas a estas horas. Lo que un tablero de salidas cuenta regresivamente.
- Vehicle position
-
Dónde está un vehículo ahora, generalmente con su rumbo y qué tan lleno está.
- Service alert
-
Una interrupción publicada — un desvío, un cierre de parada, una suspensión — vinculada a las rutas, paradas o viajes que afecta.
- Identifier mapping
-
Reconciliar identificadores que difieren entre un feed en tiempo real y el horario estático. Una parada que es
17948en uno y7948en el otro tiene que ser emparejada antes de que las predicciones puedan llegar a la pantalla correcta.
Esta plataforma
- Display
-
Una pantalla renderizada: las salidas de una parada, el mapa de una ruta, una vista general del sistema. Las pantallas leen la misma API pública que cualquier otro cliente.
- Display context
-
La configuración almacenada para una pantalla — qué entidad muestra, qué diseño, qué superficie. Almacenada como configuración, así que se exporta con el resto del sitio.
- Variant
-
Un diseño que puede tomar una pantalla. También llamado skin cuando un módulo de agencia proporciona su propia tipografía y marca.
- Pylon
-
Una pantalla montada en plataforma, a menudo un par apilado — un panel nombrando la ruta, uno mostrando sus salidas.
- Annotation
-
Texto que una agencia añade a una parada o ruta manualmente, mostrado junto al contenido generado y que sobrevive a la próxima importación de feed.
- Embed
-
Una pantalla colocada en otro sitio a través de un
iframe, para que las propias páginas de una agencia puedan llevar un mapa en vivo sin adoptar esta pila.
Términos de Drupal
- Drupal
-
El sistema de gestión de contenido de código abierto sobre el que está construida esta suite. La suite es un conjunto de módulos ordinarios; no hay fork involucrado.
- Module
-
Una unidad de funcionalidad de Drupal, instalada con Composer y habilitada por sitio.
- Entity
-
La unidad de contenido almacenado de Drupal. Una entidad de contenido almacena datos y puede llevar campos; una entidad de configuración almacena ajustes y se exporta a código.
- Bundle
-
Un subtipo de una entidad. Cada archivo GTFS se convierte en un bundle, así que rutas, paradas y viajes son todos el mismo tipo de entidad con diferentes formas.
- Field
-
Un dato adjunto a una entidad. Los campos que añades a registros de tránsito importados sobreviven a las reimportaciones.
- View
-
El constructor de consultas de Drupal. Lista y filtra registros GTFS de la misma manera que lista cualquier otra cosa en el sitio.
- View mode
-
Una forma nombrada de renderizar una entidad — una página completa, un tooltip de mapa, una fila en una lista.
- Hook
-
Un punto de extensión publicado. El comportamiento específico de la agencia se conecta mediante hooks en lugar de editar código compartido.
- Composer
-
El gestor de dependencias PHP.
composer require drupal/gtfsinstala un módulo y todo lo que necesita. - Drush
-
La herramienta de línea de comandos de Drupal. Las importaciones de feeds, actualizaciones y auditorías se ejecutan a través de ella.
Formatos y términos web
- API
-
Application Programming Interface. Las direcciones desde las que otro programa puede solicitar datos y las formas que obtiene de vuelta.
- REST
-
Una convención para APIs construidas sobre solicitudes web ordinarias: una URL nombra un recurso y el método HTTP dice qué hacer con él.
- JSON
-
JavaScript Object Notation. El formato de texto que devuelve la API de esta plataforma.
- OpenAPI
-
Una descripción estándar de una API — cada endpoint, parámetro y forma de respuesta, en un solo archivo legible por máquina. Antes llamado Swagger. El nuestro se publica en la referencia de la API.
- Protocol Buffers
-
Generalmente abreviado como Protobuf. Un formato binario compacto, y en lo que se codifica GTFS-Realtime. Esta plataforma lo decodifica del lado del servidor, así que los clientes solo ven JSON.
- GeoJSON
-
Un formato JSON para formas geográficas — puntos, líneas, áreas. Cómo la API entrega la geometría de paradas y rutas.
- Vector tile
-
Datos de mapa cortados en piezas pequeñas y dibujados por el navegador, en lugar de entregarse como imágenes prerenderizadas. Es lo que permite que un mapa cambie de estilo sin nuevos archivos del servidor.
- PMTiles
-
Un archivo único de tiles vectoriales que puede servirse desde alojamiento estático ordinario, sin servidor de tiles detrás.
- Basemap
-
El mapa debajo de los datos de tránsito — calles, agua, parques, etiquetas. Intercambiable: las capas de ruta y parada se sitúan encima y no dependen de él.
- iframe
-
Un elemento HTML que coloca una página dentro de otra. Cómo una integración llega al sitio existente de una agencia.
- CORS
-
Cross-Origin Resource Sharing. La regla del navegador que decide si un sitio puede leer datos de otro. Un estilo de mapa remoto debe permitirlo.
- CSP
-
Content Security Policy. Reglas del navegador que un sitio establece para sí mismo, incluyendo qué otros sitios pueden enmarcar sus páginas.
- e-ink
-
Una tecnología de pantalla que mantiene una imagen sin consumir energía, legible a la luz del día. Adecuada para paradas sin suministro eléctrico.
Bay Area
- 511 SF Bay
-
El servicio de información para viajeros de la región. Su API de Open Data publica GTFS y GTFS-Realtime para cada operador de la región, en 511.org.
- MTC
-
Metropolitan Transportation Commission, la agencia de planificación de transporte del Área de la Bahía. Opera 511 y define GTFS+.
- Operator
-
La palabra de 511 para una agencia de tránsito participante.
Licencias
- GPL-2.0+
-
GNU General Public License, versión 2 o posterior. La licencia bajo la que se publica la suite de módulos: puedes ejecutarla, estudiarla, cambiarla y redistribuirla, y cualquier cosa que distribuyas construida sobre ella lleva los mismos términos.
- Open source
-
Software publicado con su código fuente bajo una licencia que permite uso y modificación. Cada módulo de la suite está en drupal.org.