API d'equipaments de Barcelona

API de només lectura, en JSON, sense clau i sense login. Es pot cridar des de qualsevol web. Dades d'Open Data BCN (CC-BY-4.0). Descripció completa (OpenAPI): /api/v1/openapi.json. Torna al mapa.

Equipaments a prop d'un punt

El punt va al cos d'un POST (i no a l'adreça) perquè no quedi registrat enlloc. radi_m pot ser 500, 1000 o 2000. Els resultats surten del més proper al més llunyà, amb la distància en línia recta en metres. tipus és opcional: biblioteca, centre_civic, cap, poliesportiu, escola_bressol.

curl -X POST /api/v1/cerques-a-prop \
  -H "Content-Type: application/json" \
  -d '{"lat": 41.3874, "lon": 2.1686, "radi_m": 1000, "tipus": ["biblioteca"]}'

Llista d'equipaments

curl "/api/v1/equipaments?tipus=cap&tipus=biblioteca"

Cerca d'un equipament pel nom

El paràmetre nom (fins a 100 caràcters) troba trossos del nom, sense importar majúscules, accents ni l'ordre de les paraules; també mira el nom del tipus. Es pot combinar amb tipus. Els millors resultats, primer.

curl "/api/v1/equipaments?nom=centre%20civic&tipus=centre_civic"

La fitxa d'un equipament

L'id és el de la llista o d'una cerca. Torna l'adreça, l'horari en text net, els telèfons (amb l'enllaç tel:) i l'enllaç a Google Maps. Una dada que no consta és null (a telefons, []); accessibilitat és sempre null, perquè les dades obertes no en diuen res.

curl /api/v1/equipaments/1015170605

Metadades

Data de les dades, fonts, tipus i radis permesos.

curl /api/v1/metadades

Errors

Sempre en català: {"error": {"codi": "peticio_no_valida", "missatge": "..."}}. Codis: peticio_no_valida (400), no_trobat (404), metode_no_permes (405), massa_gran (413), massa_peticions (429) i error_intern (500). Cada IP pot fer fins a 300 peticions a l'API per minut; qui ho supera rep el 429 amb la capçalera Retry-After.