Memoria del Agente

NAVITIA.md | Modificado: 2026-05-21 22:56 | Auto-refresca cada 30s

# Integración Navitia API

**Propósito:** Consultas precisas de transporte público en Madrid usando API oficial.

## Credenciales necesarias
- **API Key:** [PENDIENTE]
- **Base URL:** `https://api.navitia.io/v1` (por defecto)
- **Coverage ID para Madrid:** `es-mad` (por confirmar)

## Autenticación
HTTP Basic Auth:
- Username: API Key
- Password: (vacío)

Ejemplo curl:
```bash
curl -u "API_KEY:" "https://api.navitia.io/v1/coverage/es-mad/journeys?from=-3.6269;40.3986&to=-3.6773;40.4547"
```

## Endpoints principales

### 1. Rutas entre puntos (`/journeys`)
```
GET /v1/coverage/{coverage_id}/journeys
  ?from={lon};{lat}
  &to={lon};{lat}
  &datetime=YYYYMMDDThhmmss
  &datetime_represents=departure|arrival
  &count=3
  &first_section_mode[]=walking
  &last_section_mode[]=walking
```

### 2. Paradas cercanas (`/stop_areas`)
```
GET /v1/coverage/{coverage_id}/stop_areas
  ?distance=500
  &coord={lon};{lat}
```

### 3. Buscar lugares (`/places`)
```
GET /v1/coverage/{coverage_id}/places?q={query}
```

## Coordenadas guardadas

### Casa (Hacienda de Pavones 43)
```
40.3986079, -3.6269099
→ from=-3.6269099;40.3986079
```

### Trabajo (Príncipe de Vergara 187)
```
40.4547362, -3.6772883
→ to=-3.6772883;40.4547362
```

## Ejemplo de consulta casa → trabajo

**URL:**
```
https://api.navitia.io/v1/coverage/es-mad/journeys
  ?from=-3.6269099;40.3986079
  &to=-3.6772883;40.4547362
  &datetime=20260522T190000
  &datetime_represents=departure
  &count=3
  &first_section_mode[]=walking
  &last_section_mode[]=walking
```

**Respuesta esperada:**
- `journeys[]`: lista de rutas posibles
- Cada ruta: `sections[]` (caminata, metro, bus), `duration`, `transfers`

## Uso desde Guardian

1. **Configurar key:** Guardar API key en variable/env o pasar en cada llamada
2. **Construir URL:** Con parámetros adecuados
3. **Llamar con `web_fetch`:** Autenticación HTTP Basic
4. **Parsear JSON:** Extraer rutas, tiempos, trasbordos
5. **Presentar:** Formato claro para WhatsApp

## Limitaciones
- Rate limits (depende de key)
- Cobertura Madrid completa (verificar)
- Tiempo real vs horarios planificados

---

**Creado:** 2026-05-21  
**Última actualización:** Pendiente de credenciales