I dati di hexplace per il tuo sito o la tua app

Dati delle località per il Portogallo e la Spagna, presto per altri paesi: un'API JSON senza chiave, widget da incorporare e pagine semplici per gli strumenti di IA. Gratis, anche per uso commerciale, citando hexplace con un link.

L'API

JSON tramite semplici richieste GET. Nessuna chiave e nessuna registrazione; qualsiasi sito può chiamarla dal browser. Ogni risposta riporta la sua licenza e l'attribuzione da mostrare.

Indirizzo	Cosa restituisce
`/api/v1/`	I paesi, le date dei loro rilasci e gli endpoint
`/api/v1/portugal/towns`	Ogni località con i suoi valori principali (clima, costi, accessibilità) e i link
`/api/v1/portugal/towns/tavira`	Una località: clima mese per mese, mesi migliori, casa, servizi, rischi, per chi è adatta
`/api/v1/portugal/towns/tavira/months/08`	Una località in un mese (da 01 a 12)
`/api/v1/portugal/rankings`	Le classifiche
`/api/v1/portugal/rankings/warmest-winters`	Una classifica, prime 100
`/api/v1/portugal/where/08`	Le località più calde in un mese
`/api/v1/openapi.json`	Questa API come descrizione OpenAPI 3.1, per generatori di client e strumenti di IA

I dati vengono ricostruiti ogni settimana. Metti in cache le risposte per un'ora o più e limita le richieste a poche al secondo.

Esempio

const res = await fetch("https://hexplace.org/api/v1/portugal/towns/tavira");
const data = await res.json();
console.log(data.summary);
// mostra l'attribuzione richiesta dalla licenza:
document.querySelector("#credit").innerHTML = data.attribution.credit_html;

Ogni valore indica il suo dataset e la sua precisione negli indicatori completi della località (data.json, anche in CSV).

Tutte le località in Portogallo in un unico file: portugal/towns.csv. Le colonne dopo quelle della località sono gli id degli indicatori dell'API; una cella vuota significa che la località non ha un valore abbastanza preciso da pubblicare.

Widget

La scheda di una località, un grafico del clima o una classifica, sempre aggiornati. Scegline uno nel generatore di widget e incolla il codice.

<iframe src="https://hexplace.org/embed/portugal/tavira/card/" width="340" height="300"
  style="border:0;max-width:100%" loading="lazy" title="Tavira su hexplace"></iframe>
<p><a href="https://hexplace.org/it/portugal/tavira/">Tavira in cifre</a> su hexplace</p>

Apri il generatore di widget

Gli editor che leggono oEmbed (Ghost, Notion e altri) mostrano il widget quando incolli il link di una località o di una classifica. L'endpoint è https://hexplace.org/oembed?url=….

Badge di classifica

Una località tra le prime 25 di una classifica, o tra le prime 10 della sua regione, ha un badge per il suo sito: un'immagine collegata alla classifica, che mostra la posizione attuale.

Comuni, uffici turistici, hotel e agenzie immobiliari possono mostrare la posizione della loro località. I badge di ogni località e il relativo codice sono nella sua pagina dei badge, per esempio /it/portugal/tavira/badges/.

Per gli strumenti di IA

Ogni pagina di località ha una versione gemella in Markdown semplice, con i suoi dati, le fonti e come citarla.

/it/portugal/tavira/index.md Tavira in Markdown
/llms.txt cosa copre hexplace, per i modelli linguistici
/llms-full.txt ogni località con la sua pagina Markdown

Licenza e attribuzione

I dati sono pubblicati con licenza CC BY 4.0: usali liberamente, anche a fini commerciali, purché citi hexplace con un link alla pagina da cui provengono i dati, per esempio Dati: hexplace (https://hexplace.org/portugal/tavira/). I valori di OpenStreetMap restano sotto ODbL. Ogni dataset e la sua licenza sono elencati nella metodologia.