API Pública de Información Ciudadana – Chubut

La Secretaría de Ciencia y Tecnología y la Subsecretaría de Protección Ciudadana del Chubut, ponen a disposición una API pública que permite acceder a datos actualizados sobre:

• Estado de rutas provinciales y nacionales
• Alertas meteorológicas activas
• Operatividad de aeropuertos
• Disponibilidad y ubicación de estaciones de servicio
• Y otros recursos clave para la seguridad y planificación ciudadana

Esta API es de acceso gratuito, pero requiere el uso de una API KEY personal que puede solicitarse escribiendo a: 📧 cienciachubut@gmail.com

El servicio está orientado a desarrolladores, medios, instituciones y cualquier actor que necesite integrar información confiable y en tiempo real para mejorar la toma de decisiones o brindar servicios informativos.

Formas de enviar la API Key (preferir encabezados):

• Encabezado: X-API-Key: <clave>
• Encabezado: Authorization: Api-Key <clave>
• Parámetro de query (menos recomendable): ?api_key=<clave>

Ejemplos con curl:

• curl -H "X-API-Key: clave1" https://sisciencia.chubut.gov.ar/mapa-situacion/api/v1/estaciones-servicio/
• curl -H "Authorization: Api-Key clave2" https://sisciencia.chubut.gov.ar/mapa-situacion/api/v1/aeropuertos/

Dónde se aplican (GET):

Dominio general: https://sisciencia.chubut.gov.ar

• /mapa-situacion/api/v1/estaciones-servicio/ (opcional ?last=1)
• /mapa-situacion/api/v1/estaciones-servicio/<id>/
• /mapa-situacion/api/v1/aeropuertos/ (opcional ?last=1)
• /mapa-situacion/api/v1/aeropuertos/<id>/
• /mapa-situacion/api/v1/marea-roja/ (opcional ?last=1)
• /mapa-situacion/api/v1/marea-roja/<id>/
• /mapa-situacion/api/v1/marea-roja-zonas/ (opcional ?include_last=1, ?last=1)
• /mapa-situacion/api/v1/marea-roja-zonas/<id>/ (opcional ?include_last=1)
• /mapa-situacion/api/v1/pasos/ (opcional ?last=1)
• /mapa-situacion/api/v1/pasos/<id>/
• /mapa-situacion/api/v1/rutas/ (opcional ?last=1)
• /mapa-situacion/api/v1/rutas/<id>/
• /mapa-situacion/api/v1/ruta-tramos/ (opcional ?last=1)
• /mapa-situacion/api/v1/ruta-tramos/<id>/
• /mapa-situacion/api/v1/avisos/ (opcional ?last=1)
• /mapa-situacion/api/v1/avisos/<id>/
• /mapa-situacion/api/v1/alertas-climaticas/ (opcional ?last=1)
• /mapa-situacion/api/v1/alertas-climaticas/<id>/

Detalle de endpoints v1

Ejemplo rápido:

GET /mapa-situacion/api/v1/estaciones-servicio/?localidad=5&last=1

— Devuelve solo la estación más reciente cargada para la localidad 5.

• Estaciones de Servicio:
  • GET /mapa-situacion/api/v1/estaciones-servicio/: listado con campos principales, servicios (lista), servicios_display y otros_servicios (texto libre con anotaciones adicionales).
  • GET /mapa-situacion/api/v1/estaciones-servicio/<id>/: detalle.
  • Filtros (query params): localidad/localidad_id, bandera (CSV), servicio (uno, coincide dentro de la lista), desde (ISO-8601).
    
    
• Aeropuertos:
  • GET /mapa-situacion/api/v1/aeropuertos/
  • GET /mapa-situacion/api/v1/aeropuertos/<id>/
  • Filtros: estado (CSV), q (busca en denominación).
    
    
• Marea Roja (registros y zonas):
  • GET /mapa-situacion/api/v1/marea-roja/: listado cronológico de registros con estado_display y razon_display.
  • GET /mapa-situacion/api/v1/marea-roja/<id>/: detalle de un registro.
  • GET /mapa-situacion/api/v1/marea-roja-zonas/?include_last=1: lista de zonas; con include_last=1 agrega ultimo_registro.
  • GET /mapa-situacion/api/v1/marea-roja-zonas/<id>/?include_last=1: detalle de zona; con include_last=1 agrega ultimo_registro.
  • Filtros (registros): estado (CSV), razon (CSV), zona/zona_id, desde (ISO-8601).
  • Filtros (zonas): q (busca en nombre), include_last (0/1).
    
    
• Pasos Fronterizos:
  • GET /mapa-situacion/api/v1/pasos/
  • GET /mapa-situacion/api/v1/pasos/<id>/
  • Filtros: estado (CSV), q (busca en denominación/ciudades).
    
• Rutas y Tramos:
  • GET /mapa-situacion/api/v1/rutas/
  • GET /mapa-situacion/api/v1/rutas/<id>/
  • GET /mapa-situacion/api/v1/ruta-tramos/: incluye trazo (GeoJSON/JSON), condicion_display y estado_display.
  • GET /mapa-situacion/api/v1/ruta-tramos/<id>/
  • Filtros (rutas): jurisdiccion (CSV), numero.
  • Filtros (tramos): ruta/ruta_id, estado (CSV), condicion (CSV), desde (ISO-8601).
    
    
• Avisos:
  • GET /mapa-situacion/api/v1/avisos/
  • GET /mapa-situacion/api/v1/avisos/<id>/
  • Filtros: tipo (CSV), localidad/localidad_id, desde (ISO-8601), hasta (ISO-8601), con_coordenadas (0/1).
    
    
• Alertas Climáticas:
  • GET /mapa-situacion/api/v1/alertas-climaticas/: incluye poligono y localidades_afectadas.
  • GET /mapa-situacion/api/v1/alertas-climaticas/<id>/
  • Filtros: fenomeno (CSV), nivel (CSV), desde (ISO-8601), hasta (ISO-8601).

Valores enumerados y etiquetas

Algunos campos devuelven valores predefinidos. La siguiente tabla resume las claves y su etiqueta legible:

Estaciones de Servicio

• bandera: petrominera (Petrominera de Chubut), ypf (YPF), axion (Axion), puma (Puma).
  
• servicios: abastecimiento (Abastecimiento de todos los combustibles), faltante_infinia (Faltante Nafta Infinia), faltante_super (Faltante Nafta Super), faltante_eurodiesel (Faltante Eurodiesel), faltante_ultradiesel (Faltante Ultradiesel), faltante_diesel_500 (Faltante Diesel 500), faltante_quantium (Faltante Quantium), faltante_axion_super (Faltante Axion Super), faltante_quantium_diesel_x10 (Faltante Quantium Diesel X10), faltante_axion_diesel_x10 (Faltante Axion Diesel X10), faltante_max_premium (Faltante Max Premium), faltante_puma_super (Faltante Puma Super), faltante_puma_diesel (Faltante Puma Diesel), venta_restringida (Venta restringida), fuera_de_servicio (Fuera de servicio), sin_combustibles (Sin combustibles), sin_informacion (Sin información).

Marea Roja

• estado: sin_veda (Sin Veda), con_veda (Con Veda), sin_info (Sin información).
• razon: marea_roja (Marea Roja), otro (Otro).

Aeropuertos

• estado: operable (Operable), fuera_de_servicio (Fuera de servicio), sin_informacion (Sin información).

Pasos Fronterizos

• estado: abierto (Abierto), cerrado (Cerrado), sin_informacion (Sin información).

Rutas

• jurisdiccion: nacional (Nacional), provincial (Provincial).

Tramos de Ruta

• estado: habilitada (Habilitada), no_habilitada (No Habilitada).
• condicion: normal (Normal), transitar_con_precaucion (Transitar con Precaución), extrema_precaucion (Extrema Precaución), calzada_pesada_por_barro (Calzada pesada por barro), presencia_de_hielo (Presencia de hielo), presencia_de_niebla (Presencia de niebla), sectores_con_baches (Sectores con baches), rocas_sobre_calzada (Rocas sobre calzada), sin_novedades (Sin novedades).

Avisos

• tipo: incendio (Incendio), corte_energia (Corte de Energía), corte_agua (Corte de Agua), telefonía_internet (Telefonía / Internet), otro (Otro).

Alertas Climáticas

• fenomeno: lluvia (Lluvia), viento (Viento), granizo (Granizo), temperatura_alta (Temperatura Alta), temperatura_baja (Temperatura Baja), nevada (Nevada).
• nivel: verde (Verde), amarillo (Amarillo), naranja (Naranja), roja (Roja).

Ejemplos de respuesta (JSON)

• Estaciones de servicio (lista):

[
  {
    "id": 12,
    "denominacion": "YPF Km 5",
    "bandera": "ypf",
    "servicio": "abastecimiento",
    "servicios": ["abastecimiento", "venta_restringida"],
    "servicios_display": ["Abastecimiento de todos los combustibles", "Venta restringida"],
    "otros_servicios": "Gomería habilitada, Full 24hs",
    "bajada": "Abastece normalmente, restringido a 40L.",
    "direccion": "Av. Central 123",
    "latitud": -45.84321,
    "longitud": -67.4932,
    "localidad": {"id": 5, "nombre": "Comodoro Rivadavia", "provincia": "Chubut"},
    "fecha_actualizacion": "2025-02-05T12:34:56.000Z"
  }
]

• Estaciones de servicio (detalle):

{
  "id": 12,
  "denominacion": "YPF Km 5",
  "bandera": "ypf",
  "servicio": "abastecimiento",
  "servicios": ["abastecimiento", "venta_restringida"],
  "servicios_display": ["Abastecimiento de todos los combustibles", "Venta restringida"],
  "otros_servicios": "Gomería habilitada, Full 24hs",
  "bajada": "Abastece normalmente, restringido a 40L.",
  "direccion": "Av. Central 123",
  "latitud": -45.84321,
  "longitud": -67.4932,
  "localidad": {"id": 5, "nombre": "Comodoro Rivadavia", "provincia": "Chubut"},
  "fecha_actualizacion": "2025-02-05T12:34:56.000Z"
}

• Ruta Tramos (lista):

[
  {
    "id": 7,
    "ruta": {"id": 2, "jurisdiccion": "provincial", "numero": 1},
    "fecha": "2025-02-04T14:00:00Z",
    "fecha_actualizacion": "2025-02-05T08:00:00Z",
    "trazo": [[-43.27, -65.31], [-43.29, -65.35]],
    "condicion": "transitar_con_precaucion",
    "condicion_display": "Transitar con Precaución",
    "estado": "habilitada",
    "estado_display": "Habilitada",
    "bajada": "Hielo en banquinas.",
    "extremo_1": "Trelew",
    "extremo_2": "Rawson"
  }
]

• Avisos (detalle):

{
  "id": 22,
  "fecha": "2025-02-05T07:10:00Z",
  "fecha_modificacion": "2025-02-05T09:00:00Z",
  "localidad": {"id": 10, "nombre": "Esquel", "provincia": "Chubut"},
  "latitud": null,
  "longitud": null,
  "tipo": "corte_agua",
  "tipo_display": "Corte de Agua",
  "bajada": "Corte programado de 10 a 14 h."
}

• Alerta Climática (detalle):

{
  "id": 5,
  "fecha": "2025-02-05T00:00:00Z",
  "fecha_modificacion": "2025-02-05T06:00:00Z",
  "fenomeno": "viento",
  "fenomeno_display": "Viento",
  "nivel": "naranja",
  "nivel_display": "Naranja",
  "poligono": [[[-65.3,-43.2],[-65.4,-43.2],[-65.4,-43.3],[-65.3,-43.3],[-65.3,-43.2]]],
  "bajada": "Ráfagas de 70-90 km/h.",
  "localidades_afectadas": ["Trelew", "Rawson"]
}

Respuestas comunes:

• 401 Unauthorized: falta la clave o es inválida.