Archivos de datos estáticos: paradas, rutas y métricas

El sitio de Transporte Tijuana sirve todos sus datos de transparencia como archivos JSON estáticos desde el directorio /public/data/. Estos archivos son generados por scripts de procesamiento fuera de línea y luego desplegados como parte del build. No requieren autenticación para accederse y pueden ser consumidos directamente desde cualquier cliente HTTP.

Las coordenadas geográficas expuestas en todos los archivos públicos aplican un desplazamiento aleatorio determinista (jitter) para proteger la privacidad de los estudiantes encuestados. Los puntos publicados representan ubicaciones aproximadas, no exactas, del domicilio de origen de cada respondiente.

/data/paradas.json

Este archivo contiene el catálogo de paradas de autobús propuestas para las rutas estudiantiles. La página mapa-demanda del sitio carga este archivo en el servidor y filtra únicamente las paradas con active: true (valor 1) antes de enviarlas al cliente. El archivo sigue la estructura:

{
  "meta": { ... },
  "stops": [ ... ]
}

La clave raíz stops es un arreglo de objetos de parada. La clave meta contiene metadatos de configuración del editor de paradas y no forma parte del esquema público expuesto al cliente.

Ejemplo de fetch

const res = await fetch('/data/paradas.json');
const { stops } = await res.json();
const activeStops = stops.filter(s => s.active === 1);

Esquema de cada parada (`stops[]`)

string

required

Identificador único de la parada. Formato: PARADA-M-{timestamp}. Ejemplo: "PARADA-M-1775427630157".

name

string

required

Nombre legible de la parada para mostrar en el mapa. Ejemplo: "02 Paseo del Centenario".

lat

number

required

Latitud de la parada en grados decimales WGS-84. Ejemplo: 32.53682901475021.

lng

number

required

Longitud de la parada en grados decimales WGS-84. Ejemplo: -117.02453541595848.

route_id

string

required

Identificador de la ruta a la que pertenece esta parada. Hace referencia al campo id de custom_routes.json. Valores actuales: "route-centro-unrc-001" o "route-la-mesa-unrc-001".

turno

string

required

Turno académico al que está orientada esta parada. Valores posibles: "Matutino", "Intermedio", "Vespertino", "Manual".

dias_raw

string

required

Días de operación de la parada en texto libre. Valores observados: "Lunes a Miercoles", "Jueves a Sabado", "Todos los días", "Manual".

active

number

required

Indicador de si la parada está activa. 1 = activa, 0 = inactiva. La página mapa-demanda solo renderiza paradas con active === 1.

stop_number

null

Campo reservado para numeración secuencial de paradas. Actualmente null en todos los registros.

student_count

number

required

Número de estudiantes encuestados cuya ubicación de origen se aproxima a esta parada. Valor de referencia para planificación de capacidad.

/data/custom_routes.json

Este archivo define las rutas de transporte propuestas como polilíneas geográficas. La página de mapa del sitio carga este arreglo para dibujar cada ruta sobre el mapa Leaflet con su color correspondiente. El archivo es un arreglo JSON raíz (no un objeto envolvente):

[
  { "id": "route-la-mesa-unrc-001", ... },
  { "id": "route-centro-unrc-001", ... }
]

Ejemplo de fetch

const res = await fetch('/data/custom_routes.json');
const routes = await res.json();
routes.forEach(route => {
  console.log(route.id, route.color, route.points.length);
});

Rutas actuales

`id`	`name`	`color`	Descripción
`route-la-mesa-unrc-001`	La Mesa → UNRC vía Camino Verde	`#ff9500`	Blvd. Díaz Ordaz (La Mesa) → Lomas del Valle → Camino Verde → UNRC. 37.3 km, ~59 min.
`route-centro-unrc-001`	Centro → UNRC vía Corredor 2000	`#0011ff`	Av. Constitución (Centro) → Blvd. Paseo de los Héroes → Corredor 2000 → UNRC. 39.9 km, ~72 min.

Esquema de cada ruta

string

required

Identificador único de la ruta. Ejemplos: "route-la-mesa-unrc-001", "route-centro-unrc-001".

name

string

required

Nombre legible de la ruta para mostrar en la leyenda del mapa.

description

string

required

Descripción del recorrido incluyendo vialidades principales, distancia aproximada y tiempo estimado de viaje.

color

string

required

Color hexadecimal para la polilínea en el mapa. Ejemplo: "#ff9500".

visible

boolean

required

Indica si la ruta debe mostrarse por defecto al cargar el mapa. true en todas las rutas actuales.

points

array

required

Arreglo de coordenadas que define la geometría de la ruta. Cada elemento es un par [lat, lng] en formato numérico. El arreglo puede contener varios cientos de puntos para rutas largas.

Show Ejemplo de puntos (primeros 3)

[
  [32.496628, -116.962863],
  [32.496492, -116.962629],
  [32.496094, -116.961961]
]

/data/summary.json

Este archivo contiene el reporte completo de métricas y análisis de la encuesta de demanda estudiantil. Es el JSON principal que alimenta la página de reporte público del sitio. Su estructura sigue la interfaz SummaryPayload definida en web/types/transport.ts.

Ejemplo de fetch

const res = await fetch('/data/summary.json');
const summary = await res.json();

console.log(summary.metrics.totalResponses);  // 192
console.log(summary.metrics.topColonia);       // "Natura"
console.log(summary.series.turnos[0]);         // { Categoria: "Matutino", Cantidad: 96, Porcentaje: 50 }

Esquema completo (`SummaryPayload`)

recipientInstitution

string

required

Nombre de la institución destinataria del reporte. Ejemplo: "Universidad Nacional Rosario Castellanos Unidad Tijuana".

reportTitle

string

required

Título del reporte. Ejemplo: "Reporte de demanda de transporte estudiantil".

generatedAt

string

required

Fecha y hora de generación del archivo en formato ISO 8601 con zona horaria. Ejemplo: "2026-04-06T08:20:24.869905+00:00".

siteUrl

string

required

URL pública del sitio de transparencia. Ejemplo: "https://transporte.tijuana.cloud".

qrUrl

string

required

URL incluida en el código QR del reporte impreso. Actualmente coincide con siteUrl. Ejemplo: "https://transporte.tijuana.cloud".

institution

string

required

Nombre corto de la institución. Ejemplo: "Universidad Nacional Rosario Castellanos".

reportSubtitle

string

required

Subtítulo del reporte. Ejemplo: "Analisis territorial, operativo y de sugerencias estudiantiles".

author

object

required

Información del autor del reporte.

Show Campos de author

name

string

required

Nombre completo del autor. Ejemplo: "Daniel Cruz".

string

required

Correo electrónico del autor. Ejemplo: "daniel.cruz@tijuana.cloud".

hosting

object

required

Información del proveedor de hosting del sitio.

Show Campos de hosting

brand

string

required

Nombre de la marca del proveedor. Ejemplo: "Tijuana Cloud".

url

string

required

URL del proveedor. Ejemplo: "https://tijuana.cloud".

logo

string

required

Ruta al logotipo del proveedor relativa al dominio del sitio. Ejemplo: "/brand/tijuana-cloud-logo.png".

label

string

required

Etiqueta descriptiva del hosting. Ejemplo: "Sitio hosteado por Tijuana Cloud".

methodology

string[]

required

Lista de notas metodológicas sobre el procesamiento de los datos. Describe las decisiones de anonimización, el tratamiento de coordenadas con jitter y qué información fue excluida de la publicación. Ejemplo de primer elemento: "La base original se conserva para analisis interno y la publicacion web solo usa datos anonimizados.".

downloads

object

required

Rutas a los archivos descargables del reporte.

Show Campos de downloads

pdf

string

required

Ruta al archivo PDF del reporte completo. Ejemplo: "/downloads/reporte-demanda-transporte.pdf".

csv

string

required

Ruta al archivo CSV con los puntos anónimos geocodificados. Ejemplo: "/downloads/public_points.csv".

metrics

object

required

Métricas agregadas de la encuesta de demanda.

Show Campos de metrics

totalResponses

number

required

Total de respuestas recibidas en la encuesta. Ejemplo: 192.

geolocated

number

required

Número de respuestas con coordenadas geográficas válidas. Ejemplo: 190.

geolocatedPct

number

required

Porcentaje de respuestas geolocalizadas sobre el total. Ejemplo: 98.96.

comments

number

required

Número de respuestas que incluyen sugerencias en texto libre. Ejemplo: 146.

commentsPct

number

required

Porcentaje de respuestas con comentarios sobre el total. Ejemplo: 76.04.

uniqueColonias

number

required

Número de colonias únicas representadas en la encuesta. Ejemplo: 70.

topColonia

string

required

Nombre de la colonia con mayor número de respondientes. Ejemplo: "Natura".

topTurno

string

required

Turno académico con mayor número de respondientes. Ejemplo: "Matutino".

map

object

required

Metadatos para la visualización del mapa de demanda.

Show Campos de map

count

number

required

Número de puntos incluidos en el mapa público. Ejemplo: 190.

center

[number, number]

required

Coordenadas del centroide calculado sobre todos los puntos del mapa, como par [lat, lng]. Ejemplo: [32.464653, -116.924751].

series

object

required

Series de datos para las gráficas del reporte. Cada serie es un arreglo de objetos SeriesRow.

Show Estructura de SeriesRow

Cada elemento en los arreglos de series sigue este esquema:

Categoria

string

required

Nombre de la categoría. Ejemplo: "Matutino", "Lunes a Miercoles", "Natura".

Cantidad

number

required

Conteo absoluto de respuestas en esta categoría. Ejemplo: 96.

Porcentaje

number

required

Porcentaje de esta categoría sobre el total de respuestas. Ejemplo: 50.0.

turnos

SeriesRow[]

required

Distribución de respuestas por turno académico. Categorías observadas: "Matutino", "Intermedio", "Vespertino", "Matutino (7:00 a 11:00)".

dias

SeriesRow[]

required

Distribución de respuestas por días de asistencia. Categorías observadas: "Lunes a Miercoles", "Jueves a Sabado", "Todos los días".

colonias

SeriesRow[]

required

Top de colonias de origen de los estudiantes encuestados, ordenadas por frecuencia descendente. Ejemplo de top 3: "Natura" (30), "Centro" (13), "Delicias" (13).

suggestions

object

required

Análisis de las sugerencias abiertas de los estudiantes.

Show Campos de suggestions

totalComments

number

required

Total de respuestas de la encuesta que incluyen texto libre en el campo de sugerencias. Ejemplo: 146.

fareSummary

string

required

Resumen en texto de los montos de tarifa más sugeridos. Ejemplo: "Los montos mas repetidos se concentran en 15 pesos (13), 10 pesos (10), 18 pesos (9).".

themes

array

required

Temas identificados en las sugerencias de texto libre, con conteo de menciones.

Show Campos de cada tema

label

string

required

Nombre del tema. Ejemplo: "Tarifa estudiantil / precio justo".

count

number

required

Número de comentarios que mencionan este tema. Ejemplo: 55.

percentage

number

required

Porcentaje de comentarios que mencionan este tema sobre el total de comentarios con texto. Ejemplo: 37.67.

topFareValues

array

required

Valores de tarifa más frecuentemente sugeridos por los estudiantes.

Show Campos de cada valor de tarifa

value

number | string

required

Monto de tarifa sugerido en pesos mexicanos. Ejemplo: 15, 10, 18.

count

number

required

Número de estudiantes que sugirieron este monto. Ejemplo: 13.

wordCloud

array

required

Palabras más frecuentes en las sugerencias, con peso normalizado para visualización en nube de palabras.

Show Campos de cada entrada de wordCloud

text

string

required

Palabra o término. Ejemplo: "Transporte".

count

number

required

Número de apariciones en los comentarios. Ejemplo: 42.

weight

number

required

Peso normalizado para renderizado de la nube. Ejemplo: 3.5.

highlights

array

required

Selección de comentarios textuales representativos de los estudiantes.

Show Campos de cada highlight

text

string

required

Texto literal del comentario del estudiante.

colonia

string

required

Colonia de origen del estudiante que realizó el comentario.

turno

string

required

Turno académico del estudiante que realizó el comentario.

/data/map_points.json

Este archivo contiene los puntos geocodificados anónimos de la encuesta, listos para renderizar en el mapa interactivo de demanda. Sigue la interfaz MapPayload de web/types/transport.ts. Las coordenadas de cada punto incluyen jitter para proteger la privacidad de los respondientes.

Ejemplo de fetch

const res = await fetch('/data/map_points.json');
const payload = await res.json();

console.log(payload.generatedAt);       // "2026-03-26T05:24:33.141747+00:00"
console.log(payload.center);            // [32.466224, -116.928478]
console.log(payload.points.length);     // 190
console.log(payload.points[0].colonia); // "Colinas de la Presa"

Esquema del archivo (`MapPayload`)

generatedAt

string

required

Fecha y hora de generación del archivo en formato ISO 8601. Ejemplo: "2026-03-26T05:24:33.141747+00:00".

center

[number, number]

required

Coordenadas del centro geográfico calculado para el mapa, como par [lat, lng]. Ejemplo: [32.466224, -116.928478].

focusBounds

[[number, number], [number, number]]

required

Límites del bounding box sugerido para el encuadre inicial del mapa. Formato: [[lat_sw, lng_sw], [lat_ne, lng_ne]]. Ejemplo: [[32.373491, -117.047167], [32.545445, -116.821759]].

points

PublicPoint[]

required

Arreglo de puntos anónimos geocodificados. Cada objeto sigue la interfaz PublicPoint.

Show Esquema de PublicPoint

punto_id

string

required

Identificador único anonimizado del punto. Es un hash hexadecimal de 16 caracteres. Ejemplo: "bd611548c8566ea3".

colonia

string

required

Colonia o zona de origen del estudiante, tal como fue capturada en la encuesta. Ejemplo: "Colinas de la Presa", "Urbi Villas del Prado", "Natura".

turno

string

required

Turno académico del respondiente con su rango horario. Ejemplos: "Matutino (7:00 a 11:00)", "Intermedio (11:00 a 15:00)", "Vespertino (15:00 a 19:00)".

dias

string

required

Días de asistencia declarados por el estudiante. Ejemplos: "Lunes a Miercoles", "Jueves a Sabado", "Todos los días".

licenciatura

string

required

Carrera que cursa el estudiante. Ejemplos: "Psicología", "Derecho y Criminología", "Ingeniería en control y automatización".

lat_publica

number

required

Latitud con jitter aplicado. No corresponde exactamente a la ubicación real del estudiante. Ejemplo: 32.443203.

lon_publica

number

required

Longitud con jitter aplicado. No corresponde exactamente a la ubicación real del estudiante. Ejemplo: -116.934223.

fuente_coordenada_publica

string

required

Método por el que se obtuvo la coordenada original antes de aplicar el jitter. Valores observados: "URL resuelta", "Texto geocodificado", "Coordenadas directas".

sugerencia_publica

string

required

Sugerencia en texto libre del estudiante, tal como fue ingresada en la encuesta. Puede ser una cadena vacía "" si el estudiante no proporcionó sugerencia.

/downloads/

El directorio /downloads/ expone dos archivos para descarga directa desde la página de reporte.

reporte-demanda-transporte.pdf

file

Reporte completo de demanda de transporte estudiantil en formato PDF. Incluye análisis territorial, gráficas de series, mapa de puntos y síntesis de sugerencias. Accesible en /downloads/reporte-demanda-transporte.pdf.

public_points.csv

file

Puntos geocodificados anónimos de la encuesta en formato CSV. Contiene las mismas columnas que los objetos PublicPoint del archivo map_points.json, en formato tabular para análisis en hojas de cálculo o SIG. Accesible en /downloads/public_points.csv.

Ejemplo de fetch de los archivos descargables

// Descargar el CSV de puntos públicos
const csvRes = await fetch('/downloads/public_points.csv');
const csvText = await csvRes.text();

// Descargar el PDF del reporte
const pdfRes = await fetch('/downloads/reporte-demanda-transporte.pdf');
const pdfBlob = await pdfRes.blob();
const pdfUrl = URL.createObjectURL(pdfBlob);

API

Componentes

Tipos

Archivos de datos estáticos: paradas, rutas y métricas

/data/paradas.json

Ejemplo de fetch

Esquema de cada parada (`stops[]`)

/data/custom_routes.json

Ejemplo de fetch

Rutas actuales

Esquema de cada ruta

/data/summary.json

Ejemplo de fetch

Esquema completo (`SummaryPayload`)

/data/map_points.json

Ejemplo de fetch

Esquema del archivo (`MapPayload`)

/downloads/

Ejemplo de fetch de los archivos descargables

Build docs developers (and LLMs) love

API

Componentes

Tipos

Documentation Index

​/data/paradas.json

​Ejemplo de fetch

​Esquema de cada parada (stops[])

​/data/custom_routes.json

​Ejemplo de fetch

​Rutas actuales

​Esquema de cada ruta

​/data/summary.json

​Ejemplo de fetch

​Esquema completo (SummaryPayload)

​/data/map_points.json

​Ejemplo de fetch

​Esquema del archivo (MapPayload)

​/downloads/

​Ejemplo de fetch de los archivos descargables

Build docs developers (and LLMs) love

/data/paradas.json

Ejemplo de fetch

Esquema de cada parada (`stops[]`)

/data/custom_routes.json

Ejemplo de fetch

Rutas actuales

Esquema de cada ruta

/data/summary.json

Ejemplo de fetch

Esquema completo (`SummaryPayload`)

/data/map_points.json

Ejemplo de fetch

Esquema del archivo (`MapPayload`)

/downloads/

Ejemplo de fetch de los archivos descargables