Imágenes libres por parada — Wikipedia + Wikimedia Commons

Fecha: 2026-09-19 · Proyecto: ~/nef/estado_turismo Script: spab-retrieval/scripts/retrieval-imagenes-comun.mjs Salida: ruta-<id>/src/imagenes-paradas.json

Por qué estas fuentes

• Wikipedia (REST summary) → imagen principal del artículo = portada curada por editores. Calidad y pertinencia muy superiores a buscar por coordenadas.
• Wikimedia Commons → fotos de dominio público y Creative Commons, con licencia, autor y página de origen verificables. Es la fuente correcta para “open source / public domain”; Unsplash/Pexels tienen su propia licencia, no PD.

Pipeline

1. Por parada: GET https://es.wikipedia.org/api/rest_v1/page/summary/<artículo> → originalimage.source → nombre de archivo → metadatos de Commons.
2. Extras: unión de GeoSearch (≤10 km) + categoría curada del lugar en Commons; se piden metadatos con imageinfo/extmetadata.
3. Filtros: licencia libre (CC0, public domain, CC BY, CC BY-SA; se excluye NC), horizontal y ≥800 px, sin logos/escudos/mapas/prensa/retratos/video, y relevancia textual al nombre del lugar.
4. Orden: dominio público/CC0 → categoría curada → cercanía. Máx. 3 extras + portada.

Salida (por parada)

{
  "Bacalar": {
    "portada": { "titulo","archivo","pagina","thumb","licencia","licencia_url","autor","ancho","alto" },
    "extras": [ { ...mismos campos, "distancia_m" } ]
  }
}

El front (ruta-maya/index.html) muestra una galería por estación con la portada resaltada y la atribución (autor · licencia · enlace a Commons).

Gotchas

• Rate limit agresivo (~1 req/s). El script aplica 700 ms entre llamadas + backoff ante 429. Correrlo solo, sin otras llamadas a Wikipedia/Commons en paralelo.
• Commons normaliza _ → espacio en títulos: hay que normalizar la clave del mapa de metadatos (bug corregido).
• La portada puede requerir 1–2 corridas si Wikipedia devuelve 429 temporal.

Extender a otras rutas

Ajustar el arreglo PARADAS (nombre, artículo de Wikipedia, término/categoría de Commons, lat/lon) y cambiar la ruta de salida. Mismo script sirve para Pacífico, Colonial, Sur y Sophia.