Consulta pública · Escritura moderada

Datos y API de UruGo.

Los recorridos que alimentan el mapa se pueden consultar en JSON. Las propuestas de cambio pasan por revisión humana antes de llegar a esta respuesta.

Descargar OpenAPI

Versión: v1
Formato: JSON
Lectura: Pública

Un punto de entrada.

Devuelve únicamente recorridos activos y publicados. Si la base remota falla, UruGo conserva un respaldo estático.

GEThttps://www.urugo.app/api/v1/routes

curl -H "Accept: application/json" \
+  https://www.urugo.app/api/v1/routes

Acceso por invitación

Aportes desde otros proyectos.

Organizaciones y herramientas locales pueden solicitar una clave para enviar correcciones. Cada clave tiene cuota propia, puede revocarse y nunca permite editar una ruta publicada.

POSThttps://www.urugo.app/api/v1/community/reportsServidor a servidor

curl -X POST https://www.urugo.app/api/v1/community/reports \
  -H "Authorization: Bearer urugo_sk_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "reportType": "route_inactive",
    "routeKey": "ruta-14-llanitos",
    "routeName": "Ruta 14",
    "place": "Llanitos",
    "description": "Vecinos indican que esta ruta ya no circula.",
    "evidenceUrl": "https://ejemplo.com/evidencia"
  }'

01
Recibir
La propuesta entra como pendiente.
02
Comprobar
El equipo revisa fuente y recorrido.
03
Publicar
Una acción separada crea la versión.

Contrato de respuesta

Lo necesario para dibujar una ruta.

Identidad

id, nombre público y nombre de dirección.

Geometría

Coordenadas [longitud, latitud], ancho de corredor y color.

Referencias

Lugares revisados que ayudan a reconocer el recorrido.

Respuesta abreviada

{
  "meta": {
    "version": "supabase-…-81",
    "source": "supabase",
    "count": 81
  },
  "routes": [
    {
      "id": 1,
      "name": "Ruta 1 - San José",
      "original_name": "Ruta 1 - San José (Ida)",
      "color": "#…",
      "path": [[-102.0, 19.4]],
      "landmarks": []
    }
  ]
}

Reglas pequeñas, datos más confiables.

Caché consciente

La respuesta puede almacenarse una hora y publica ETag para evitar descargas repetidas.

Lectura desde otras apps

El endpoint admite CORS para solicitudes GET. No expone contactos, reportes ni identificadores comunitarios.

Escritura controlada

Las integraciones autorizadas sólo crean propuestas pendientes. Cada corrección se modera y publica como una versión nueva.

¿El dato ya cambió?

Envía la ruta, una referencia y, cuando sea posible, evidencia o un trazo aproximado. Dos aportes independientes ayudan a confirmar actividad; un administrador decide qué se publica.

Proponer una corrección

Reutilización

La consulta es pública, pero el conjunto completo todavía no tiene una licencia general de redistribución. Algunas referencias derivan de OpenStreetMap y conservan su atribución ODbL.

Revisar código y fuentes