hexplace-data voor je site of app

Plaatsdata voor Portugal en Spanje, binnenkort ook voor meer landen: een JSON-API zonder sleutel, widgets om in te sluiten en eenvoudige pagina's voor AI-tools. Gratis, ook voor commercieel gebruik, met een bronvermelding en een link naar hexplace.

De API

JSON via gewone GET-verzoeken. Geen sleutel en geen aanmelding; elke site mag hem vanuit de browser aanroepen. Elk antwoord bevat de licentie en de bronvermelding die je moet tonen.

Adres	Wat je terugkrijgt
`/api/v1/`	De landen, hun releasedatums en de endpoints
`/api/v1/portugal/towns`	Elke plaats met haar kernwaarden (klimaat, kosten, bereikbaarheid) en links
`/api/v1/portugal/towns/tavira`	Eén plaats: klimaat per maand, beste maanden, wonen, voorzieningen, risico's, voor wie geschikt
`/api/v1/portugal/towns/tavira/months/08`	Eén plaats in één maand (01 tot 12)
`/api/v1/portugal/rankings`	De ranglijsten
`/api/v1/portugal/rankings/warmest-winters`	Eén ranglijst, top 100
`/api/v1/portugal/where/08`	De warmste plaatsen in een maand
`/api/v1/openapi.json`	Deze API als OpenAPI 3.1-beschrijving, voor clientgenerators en AI-tools

De data wordt elke week opnieuw opgebouwd. Bewaar antwoorden een uur of langer in de cache en houd het bij een paar verzoeken per seconde.

Voorbeeld

const res = await fetch("https://hexplace.org/api/v1/portugal/towns/tavira");
const data = await res.json();
console.log(data.summary);
// toon de bronvermelding die de licentie vraagt:
document.querySelector("#credit").innerHTML = data.attribution.credit_html;

Elke waarde noemt haar dataset en precisie in de volledige meetwaarden van de plaats (data.json, ook als CSV).

Elke plaats in Portugal in één bestand: portugal/towns.csv. De kolommen na die van de plaats zelf zijn de meetwaarde-id's van de API; een lege cel betekent dat de plaats geen waarde heeft die precies genoeg is om te publiceren.

Widgets

Een plaatskaart, een klimaatgrafiek of een ranglijst, altijd actueel. Kies er een in de insluitmaker en plak de code.

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

Open de insluitmaker

Editors die oEmbed lezen (Ghost, Notion en andere) tonen de widget als je een link naar een plaats of ranglijst plakt. Het endpoint is https://hexplace.org/oembed?url=….

Ranglijstbadges

Een plaats in de top 25 van een ranglijst, of in de top 10 van haar regio, heeft een badge voor haar website: een afbeelding die naar de ranglijst linkt en de actuele positie toont.

Gemeentehuizen, toeristenbureaus, hotels en makelaars kunnen laten zien waar hun plaats staat. De badges van elke plaats en hun code staan op haar badgepagina, bijvoorbeeld /nl/portugal/tavira/badges/.

Voor AI-tools

Elke plaatspagina heeft een eenvoudige Markdown-versie met haar feiten, bronnen en hoe je ernaar verwijst.

/nl/portugal/tavira/index.md Tavira als Markdown
/llms.txt wat hexplace behandelt, voor taalmodellen
/llms-full.txt elke plaats met haar Markdown-pagina

Licentie en bronvermelding

De data wordt gepubliceerd onder CC BY 4.0: gebruik haar vrij, ook commercieel, zolang je hexplace vermeldt met een link naar de pagina waar de data vandaan komt, bijvoorbeeld Data: hexplace (https://hexplace.org/portugal/tavira/). Waarden uit OpenStreetMap blijven onder de ODbL vallen. Elke dataset en haar licentie staat in de werkwijze.