Los datos de hexplace para tu web o tu aplicación
Datos de localidades de Portugal y España, y pronto de más países: una API JSON sin clave, widgets para insertar y páginas sencillas para herramientas de IA. Gratis, también para uso comercial, citando a hexplace con un enlace.
La API
JSON mediante peticiones GET sencillas. Sin clave y sin registro; cualquier web puede llamarla desde el navegador. Cada respuesta lleva su licencia y la atribución que hay que mostrar.
| Dirección | Qué devuelve |
|---|---|
/api/v1/ | Los países, las fechas de sus versiones y los endpoints |
/api/v1/portugal/towns | Todas las localidades con sus valores clave (clima, costes, accesos) y enlaces |
/api/v1/portugal/towns/tavira | Una localidad: clima por mes, mejores meses, vivienda, servicios, riesgos, para quién es |
/api/v1/portugal/towns/tavira/months/08 | Una localidad en un mes (01 a 12) |
/api/v1/portugal/rankings | Los rankings |
/api/v1/portugal/rankings/warmest-winters | Un ranking, las 100 primeras |
/api/v1/portugal/where/08 | Las localidades más cálidas en un mes |
/api/v1/openapi.json | Esta API descrita en OpenAPI 3.1, para generadores de clientes y herramientas de IA |
Los datos se regeneran cada semana. Guarda las respuestas en caché una hora o más y no pases de unas pocas peticiones por segundo.
Ejemplo
const res = await fetch("https://hexplace.org/api/v1/portugal/towns/tavira");
const data = await res.json();
console.log(data.summary);
// muestra la atribución que pide la licencia:
document.querySelector("#credit").innerHTML = data.attribution.credit_html;Cada valor indica su conjunto de datos y su precisión en los indicadores completos de la localidad (data.json, también en CSV).
Todas las localidades de Portugal en un solo archivo: portugal/towns.csv. Las columnas que siguen a las de la localidad son los identificadores de indicador de la API; una celda vacía significa que la localidad no tiene un valor lo bastante preciso para publicarlo.
Widgets
Una ficha de localidad, un gráfico del clima o un ranking, siempre al día. Elige uno en el creador de widgets y pega el código.
<iframe src="https://hexplace.org/embed/portugal/tavira/card/" width="340" height="300" style="border:0;max-width:100%" loading="lazy" title="Tavira, por hexplace"></iframe> <p><a href="https://hexplace.org/es/portugal/tavira/">Tavira en cifras</a>, por hexplace</p>
Los editores compatibles con oEmbed (Ghost, Notion y otros) muestran el widget cuando pegas el enlace de una localidad o de un ranking. El endpoint es https://hexplace.org/oembed?url=….
Insignias de ranking
Una localidad entre las 25 primeras de un ranking, o entre las 10 primeras de su región, tiene una insignia para su web: una imagen enlazada al ranking que muestra el puesto actual.
Ayuntamientos, oficinas de turismo, hoteles e inmobiliarias pueden mostrar el puesto de su localidad. Las insignias de cada localidad y su código están en su página de insignias, por ejemplo /es/portugal/tavira/badges/.
Para herramientas de IA
Cada página de localidad tiene una versión en Markdown sencillo con sus datos, sus fuentes y cómo citarla.
/es/portugal/tavira/index.mdTavira en Markdown/llms.txtqué cubre hexplace, para modelos de lenguaje/llms-full.txttodas las localidades con su página en Markdown
Licencia y atribución
Los datos se publican bajo CC BY 4.0: úsalos libremente, también con fines comerciales, siempre que cites a hexplace con un enlace a la página de la que proceden los datos, por ejemplo Datos: hexplace (https://hexplace.org/portugal/tavira/). Los valores de OpenStreetMap siguen bajo la ODbL. Todos los conjuntos de datos y sus licencias figuran en la metodología.