Inicio

Datos abiertos

La información pública de Faro VE está abierta para que otras aplicaciones y servicios la usen. La idea es simple: datos conectados entre todas las apps que ayudan, para que nadie quede sin posibilidad de ser ubicado. Todo es solo lectura, con CORS abierto (cualquier sitio puede consumirlo desde el navegador) y sin claves.

Endpoints

  • Personas — PFIF 1.4 (XML)

    https://faro-ve.com/api/pfif?limit=200&offset=0

    Estándar Person Finder (Google PF, ICRC, Cruz Roja). Ubicación en TEXTO, nunca coordenadas. Cada record con expiry_date (retención 60d).

  • Personas — JSON

    https://faro-ve.com/api/persons?q=nombre&limit=100

    Filtros: q (nombre), status, is_minor, medical_urgent, bbox, limit. Conteo exacto con ?count=exact. Incluye reportes sin ubicación (buscables por nombre).

  • Personas — GeoJSON

    https://faro-ve.com/api/persons?format=geojson&bbox=-73.4,0.6,-59.8,12.3

    FeatureCollection RFC 7946 para mapas (Leaflet/Mapbox/QGIS). Coordenadas OFUSCADAS ~300m; los reportes sin ubicación van como Feature con geometry null.

  • Refugios y puntos de ayuda — JSON / GeoJSON

    https://faro-ve.com/api/aid-points?format=geojson

    Lugares de servicio con coordenadas EXACTAS (la gente debe llegar). Filtros: type, q, bbox, limit. Props: nombre, tipo, insumos, horario, capacidad, dirección, cómo entrar.

  • Zonas y conteos

    https://faro-ve.com/api/persons/clusters?bbox=-73.4,0.6,-59.8,12.3&zoom=6

    Burbujas agregadas por zona (conteo real) y /api/persons/stats (totales por categoría). Útil para dashboards.

Respuestas cacheadas en el edge (15–300s). Sé considerado con la frecuencia; para sincronizar grandes volúmenes, escríbenos y coordinamos.

Privacidad de los datos

  • Personas: la ubicación se entrega siempre aproximada (~300m) y en texto — nunca la coordenada exacta. No se incluye ningún dato de quien reportó (correo/teléfono). La foto de un menor nunca se expone.
  • Refugios y puntos de ayuda: coordenadas exactas, porque son lugares de servicio a los que la gente necesita llegar.
  • Cada record lleva source y source_url (atribución a la fuente original) y un expiry_date (retención 60 días).

Licencia y condiciones de uso

Los datos públicos de Faro VE se ofrecen bajo Creative Commons Atribución 4.0 (CC BY 4.0), con una cláusula humanitaria adicional:

  • ✅ Podés usar, copiar, redistribuir y combinar estos datos —incluso en apps, mapas, dashboards o investigaciones— si nos atribuís: «Datos de Faro VE — faro-ve.com» con enlace, y conservando el source de cada record.
  • 🚫 Prohibido intentar des-ofuscar las coordenadas, reidentificar o re-combinar los datos para ubicar a una persona en su punto exacto, o cualquier uso que ponga en riesgo a las personas reportadas.
  • 🔄 Respetá el opt-out: si una fila sale de nuestro feed (o pasa su expiry_date), debés purgarla también de tu copia.

Opt-out y contacto

¿Tu organización no quiere ser incluida, o querés que dejemos de ingerir tu fuente? [email protected] — SLA 24h para detener la ingesta y purgar.

¿Querés conectar tu app, intercambiar datos o federar (Person Finder, ICRC/Cruz Roja, HDX)? Escribinos a [email protected] y coordinamos.

Faro VE · Sin fines de lucro · Privacidad por diseño · Estándar de interoperabilidad PFIF v1.4

Auxilio