hexplace-Daten für Ihre Website oder App

Ortsdaten für Portugal und Spanien, bald auch für weitere Länder: eine JSON-API ohne Schlüssel, Widgets zum Einbetten und einfache Seiten für KI-Werkzeuge. Kostenlos, auch für kommerzielle Nutzung, mit Quellenangabe und einem Link zu hexplace.

Die API

JSON über einfache GET-Anfragen. Kein Schlüssel und keine Anmeldung; jede Website darf sie aus dem Browser aufrufen. Jede Antwort enthält ihre Lizenz und die anzuzeigende Quellenangabe.

Adresse	Was sie liefert
`/api/v1/`	Länder, ihr Datenstand und die Endpunkte
`/api/v1/portugal/towns`	Jeder Ort mit seinen wichtigsten Werten (Klima, Kosten, Erreichbarkeit) und Links
`/api/v1/portugal/towns/tavira`	Ein Ort: Klima nach Monat, beste Monate, Wohnen, Einrichtungen, Gefahren, für wen er geeignet ist
`/api/v1/portugal/towns/tavira/months/08`	Ein Ort in einem Monat (01 bis 12)
`/api/v1/portugal/rankings`	Die Ranglisten
`/api/v1/portugal/rankings/warmest-winters`	Eine Rangliste, Top 100
`/api/v1/portugal/where/08`	Die wärmsten Orte in einem Monat
`/api/v1/openapi.json`	Diese API als OpenAPI-3.1-Beschreibung, für Client-Generatoren und KI-Werkzeuge

Die Daten werden jede Woche neu erstellt. Bitte speichern Sie Antworten eine Stunde oder länger zwischen und bleiben Sie bei wenigen Anfragen pro Sekunde.

Beispiel

const res = await fetch("https://hexplace.org/api/v1/portugal/towns/tavira");
const data = await res.json();
console.log(data.summary);
// die Quellenangabe zeigen, die die Lizenz verlangt:
document.querySelector("#credit").innerHTML = data.attribution.credit_html;

Jeder Wert nennt in den vollständigen Kennzahlen des Ortes seinen Datensatz und seine Genauigkeit (data.json, auch als CSV).

Alle Orte von Portugal in einer Datei: portugal/towns.csv. Die Spalten nach den Angaben zum Ort selbst sind die Kennzahl-IDs der API; eine leere Zelle bedeutet, dass der Ort keinen Wert hat, der genau genug für eine Veröffentlichung ist.

Widgets

Eine Ortskarte, ein Klimadiagramm oder eine Rangliste, immer aktuell. Wählen Sie eines im Einbettungs-Baukasten und fügen Sie den Code ein.

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

Einbettungs-Baukasten öffnen

Editoren mit oEmbed-Unterstützung (Ghost, Notion und andere) zeigen das Widget, wenn Sie den Link zu einem Ort oder einer Rangliste einfügen. Der Endpunkt ist https://hexplace.org/oembed?url=….

Ranglisten-Abzeichen

Ein Ort unter den Top 25 einer Rangliste oder den Top 10 seiner Region erhält ein Abzeichen für seine Website: ein Bild mit Link zur Rangliste, das den aktuellen Platz zeigt.

Rathäuser, Touristeninformationen, Hotels und Immobilienmakler können zeigen, welchen Platz ihr Ort belegt. Die Abzeichen jedes Ortes und ihr Code stehen auf seiner Abzeichen-Seite, zum Beispiel /de/portugal/tavira/badges/.

Für KI-Werkzeuge

Jede Ortsseite hat ein schlichtes Markdown-Gegenstück mit ihren Fakten, Quellen und Hinweisen zum Zitieren.

/de/portugal/tavira/index.md Tavira als Markdown
/llms.txt was hexplace abdeckt, für Sprachmodelle
/llms-full.txt jeder Ort mit seiner Markdown-Seite

Lizenz und Quellenangabe

Die Daten stehen unter CC BY 4.0: Nutzen Sie sie frei, auch kommerziell, solange Sie hexplace mit einem Link zu der Seite nennen, von der die Daten stammen, zum Beispiel Daten: hexplace (https://hexplace.org/portugal/tavira/). Werte aus OpenStreetMap stehen weiterhin unter der ODbL. Alle Datensätze und ihre Lizenzen stehen in der Methodik.