🗺️ BabaMap API

API pública para descubrir espacios familiares en Barcelona

📖 Descripción

BabaMap es una plataforma colaborativa que ayuda a familias a descubrir y compartir espacios child-friendly en Barcelona. Nuestra API pública permite acceder a información sobre miles de lugares: parques, bibliotecas, ludotecas, restaurantes, museos y mucho más.

📄 OpenAPI Spec 🌐 Aplicación Web 💻 GitHub

🚀 Inicio Rápido

Obtener todos los lugares

GET http://api.babamap.es/api/places/public/map

Ejemplo con curl:

curl "http://api.babamap.es/api/places/public/map"

Ejemplo con filtros:

curl "http://api.babamap.es/api/places/public/map?categoria=parque&ciudad=Barcelona"

Obtener detalles de un lugar

GET http://api.babamap.es/api/places/public/:id 
curl "http://api.babamap.es/api/places/public/123"

🔗 Endpoints Públicos

GET /api/places/public/map

Obtiene todos los lugares para el mapa

Parámetros de consulta opcionales:

  • categoria - Filtrar por categoría (parque, biblioteca, ludoteca, restaurante, museo, etc.)
  • ciudad - Filtrar por ciudad (Barcelona, Hospitalet de Llobregat, etc.)
  • distrito - Filtrar por distrito
  • edades - Filtrar por rango de edad (0-2, 3-5, 6-12, 13+)
  • tipoPrecio - Filtrar por tipo de precio (gratis, pago, ambos)
  • equipamientos - Filtrar por equipamientos (columpios, toboganes, fuentes, etc.)
GET /api/places/public/:id

Obtiene detalles completos de un lugar específico

Incluye: información básica, fotos, horarios, valoraciones y comentarios

GET /api/places/public/count

Cuenta lugares según filtros

Útil para paginación y estadísticas. Acepta los mismos filtros que /map

GET /api/places/public/filter-catalogs

Obtiene catálogos de filtros disponibles

Devuelve listas de categorías, edades, precios y equipamientos válidos

📊 Estructura de Datos

Objeto Place (Lugar)

Campo Tipo Descripción
id number ID único del lugar
nombre string Nombre del lugar
categoria string Categoría del lugar
descripcion string Descripción detallada
direccion string Dirección completa
ciudad string Ciudad
distrito string Distrito/barrio
latitude number Latitud (coordenadas GPS)
longitude number Longitud (coordenadas GPS)
mediaValoracion number Valoración promedio (0-5)
totalValoraciones number Número total de valoraciones
fotos array Array de URLs de fotos
edades array Rangos de edad recomendados
equipamientos array Equipamientos disponibles

Ejemplo de Respuesta

{
  "places": [
    {
      "id": 123,
      "nombre": "Parc de la Ciutadella",
      "categoria": "parque",
      "descripcion": "Gran parque urbano con zona infantil, lago y museo",
      "direccion": "Passeig de Picasso, 21",
      "ciudad": "Barcelona",
      "distrito": "Ciutat Vella",
      "latitude": 41.3887,
      "longitude": 2.1864,
      "mediaValoracion": 4.5,
      "totalValoraciones": 234,
      "fotos": [
        {
          "id": 456,
          "url": "https://res.cloudinary.com/...",
          "isMainPhoto": true
        }
      ],
      "edades": [
        { "edad": { "value": "0-2" } },
        { "edad": { "value": "3-5" } },
        { "edad": { "value": "6-12" } }
      ],
      "equipamientos": [
        { "equipamiento": { "value": "columpios" } },
        { "equipamiento": { "value": "toboganes" } }
      ]
    }
  ],
  "total": 1
}

💡 Casos de Uso

Para Asistentes de IA (Claude, ChatGPT, etc.)

Esta API está diseñada para ser descubierta y utilizada por asistentes de IA. Cuando un usuario pregunte sobre espacios familiares en Barcelona, puedes:

Para Desarrolladores

⚡ Rendimiento y Límites

📌 Nota: Esta es una API pública sin autenticación. Por favor, úsala de forma responsable:
  • No hagas más de 60 peticiones por minuto
  • Cachea las respuestas cuando sea posible
  • Usa los parámetros de filtro para reducir el tamaño de las respuestas

📞 Contacto y Contribuir

BabaMap es una plataforma colaborativa. Si tienes sugerencias, encuentras errores o quieres contribuir con datos, puedes: