Les données hexplace pour votre site ou votre application

Des données sur les villes du Portugal et de l'Espagne, et bientôt d'autres pays : une API JSON sans clé, des widgets à intégrer et des pages simples pour les outils d'IA. Gratuit, y compris pour un usage commercial, avec une mention et un lien vers hexplace.

L'API

Du JSON via de simples requêtes GET. Ni clé ni inscription ; n'importe quel site peut l'appeler depuis le navigateur. Chaque réponse indique sa licence et la mention de source à afficher.

Adresse	Ce qu'elle renvoie
`/api/v1/`	Les pays, leurs dates d'édition et les points d'accès
`/api/v1/portugal/towns`	Chaque ville avec ses valeurs clés (climat, coûts, accès) et ses liens
`/api/v1/portugal/towns/tavira`	Une ville : climat par mois, meilleurs mois, logement, services, risques, à qui elle convient
`/api/v1/portugal/towns/tavira/months/08`	Une ville pour un mois (01 à 12)
`/api/v1/portugal/rankings`	Les classements
`/api/v1/portugal/rankings/warmest-winters`	Un classement, top 100
`/api/v1/portugal/where/08`	Les villes les plus chaudes pour un mois
`/api/v1/openapi.json`	Cette API décrite en OpenAPI 3.1, pour les générateurs de clients et les outils d'IA

Les données sont reconstruites chaque semaine. Merci de mettre les réponses en cache pendant une heure ou plus et de vous en tenir à quelques requêtes par seconde.

Exemple

const res = await fetch("https://hexplace.org/api/v1/portugal/towns/tavira");
const data = await res.json();
console.log(data.summary);
// afficher la mention de source demandée par la licence :
document.querySelector("#credit").innerHTML = data.attribution.credit_html;

Chaque valeur indique son jeu de données et sa précision dans les indicateurs complets de la ville (data.json, aussi en CSV).

Toutes les villes du Portugal dans un seul fichier : portugal/towns.csv. Les colonnes qui suivent celles de la ville sont les identifiants d'indicateurs de l'API ; une case vide signifie que la ville n'a pas de valeur assez précise pour être publiée.

Widgets

Une fiche de ville, un graphique climatique ou un classement, toujours à jour. Choisissez-en un dans l'outil d'intégration et collez le code.

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

Ouvrir l'outil d'intégration

Les éditeurs compatibles oEmbed (Ghost, Notion et d'autres) affichent le widget quand vous collez le lien d'une ville ou d'un classement. Le point d'accès est https://hexplace.org/oembed?url=….

Badges de classement

Une ville du top 25 d'un classement, ou du top 10 de sa région, a un badge pour son site web : une image liée au classement, qui affiche le rang actuel.

Les mairies, offices de tourisme, hôtels et agences immobilières peuvent montrer le rang de leur ville. Les badges de chaque ville et leur code se trouvent sur sa page de badges, par exemple /fr/portugal/tavira/badges/.

Pour les outils d'IA

Chaque page de ville a une version Markdown simple avec ses faits, ses sources et la façon de la citer.

/fr/portugal/tavira/index.md Tavira en Markdown
/llms.txt ce que couvre hexplace, pour les modèles de langage
/llms-full.txt chaque ville avec sa page Markdown

Licence et mention de source

Les données sont publiées sous CC BY 4.0 : utilisez-les librement, y compris à des fins commerciales, à condition de citer hexplace avec un lien vers la page d'où viennent les données, par exemple Données : hexplace (https://hexplace.org/portugal/tavira/). Les valeurs issues d'OpenStreetMap restent sous ODbL. Chaque jeu de données et sa licence sont listés dans la méthodologie.