Hilfe

Eine Skript-Zeile + ein Attribut auf einem Eingabefeld:

<input type="text" name="ort" data-geoapi-place>
<script src="https://geoapi.world/dist/geoapi-widget.js"></script>

Mehr Details im Tutorial.

Für reine Browser-Demos und Widget-Einbettung: nein. Der Free-anonym-Tarif erlaubt 200 Anfragen / Tag pro IP, ausreichend für erste Tests. Für ernsthafte Side-Projects: Hobby-Tarif für 9 €/Monat mit 25.000 Anfragen und eigenem Key.

Mit Account und Key bekommst du höhere Limits, Verbrauchs-Statistiken und CORS-Whitelisting. Preise & Tarife.

Konto anlegen, der Onboarding-Wizard generiert dir direkt den ersten Key. Weitere Keys kannst du jederzeit im Mein-Bereich erzeugen.

Die häufigsten Ursachen:

• Skript nicht geladen: Schau in der Browser-Konsole, ob geoapi-widget.js wirklich kommt (Status 200).
• Weniger als 2 Zeichen getippt: Das Widget startet erst ab 2 Zeichen.
• CORS blockiert: Falls dein Key eine Origin-Whitelist hat und deine Seite nicht drauf steht, blockt der Server. Im Mein-Bereich die Whitelist anpassen.
• Browser-Konsole zeigt 404 oder 500: dann hat die API ein Problem — siehe Status-Check.

Über CSS-Variablen — alle anpassbar in deinem eigenen Stylesheet:

:root {
  --geoapi-bg:        #fef3c7;
  --geoapi-fg:        #1f2937;
  --geoapi-border:    #f59e0b;
  --geoapi-active-bg: #fbbf24;
  --geoapi-radius:    8px;
}

Vollständige Liste im API-Doku unter „Widget-Variablen".

Zwei Attribute am Input:

<input data-geoapi-place
       data-geoapi-format-list="{name}<small>{country_code}</small>"
       data-geoapi-format-input="{name}, {country_code}">

Verfügbare Platzhalter: {name}, {country_code}, {admin1_code}, {timezone}, {population}, {lat}, {lon}, {geonameid}, {feature_code}.

Standardmäßig gehört jedes data-geoapi-fill-Element zum nächsten Input darüber im DOM. Falls das nicht reicht, explizit binden:

<input name="ort1" data-geoapi-place>
<span data-geoapi-fill="timezone" data-geoapi-fill-from="ort1"></span>

• /api/v1/search.php?q=…&limit=10 — Ortssuche per Substring
• /api/v1/lookup.php?lat=…&lon=…&mode=city|exact — Reverse-Geocoding
• /api/health.php — Health-Check für Monitoring

Volle Spec mit Schemas: OpenAPI-YAML · Doku.

Die Antwort jeder API-Anfrage enthält diese Header (informativ):

• X-RateLimit-Limit — dein monatliches Anfragelimit
• X-RateLimit-Remaining — wie viele du in der aktuellen Periode noch hast
• X-RateLimit-Reset — Unix-Timestamp, wann der Zähler zurückgesetzt wird
• X-Plan — dein aktueller Tarif

In Phase 2 (rollt demnächst aus) werden Überschreitungen mit HTTP 429 + Retry-After beantwortet.

Du hast für deinen API-Key eine CORS-Whitelist gesetzt, und dein Browser-Aufruf kommt von einer anderen Origin. Im Mein-Bereich → Key auswählen → Details → CORS-Whitelist erweitern oder leer lassen (= alles erlaubt).

Standard-Modus ist city — er sucht die nächste bewohnte Stadt. In Wüstengebieten oder am Meer kann das mehrere hundert Kilometer entfernt sein. Für punktgenaue Treffer (auch Berge, Seen, etc.) nutze mode=exact:

GET /api/v1/lookup.php?lat=50.1&lon=10.0&mode=exact

Bis Stripe live ist (Phase 3) erfolgt der Tarifwechsel manuell — schreib uns kurz unter Kontakt, wir aktivieren den gewünschten Plan innerhalb eines Werktags.

Im Mein-Bereich → Konto → „Daten als CSV herunterladen". Liefert Konto-Daten, API-Keys (nur Prefix), Audit-Log und Request-Log. DSGVO-konform.

Aktuell auf Anfrage über Kontakt oder ai@rd5.org. Self-Service-Löschung ist auf der Roadmap.

Self-Service-Reset kommt mit Phase 2 (sobald Mail-Versand eingerichtet ist). Bis dahin: Mail an ai@rd5.org mit Account-Email — wir setzen ein temporäres Passwort.