Lizenz & FAQ
Datenquelle, Lizenz-Bedingungen und Antworten auf die häufigsten Fragen.
Lizenz
| Datenquelle | geonames.org — täglich Delta-Sync, monatlich Full-Sync. |
|---|---|
| Datenlizenz | CC BY 4.0 — wer die Daten weitergibt, muss „© GeoNames" als Quelle nennen. |
| HTTPS | Ausschließlich. HTTP-Aufrufe werden umgeleitet. |
| Antwortformat | JSON, UTF-8, mit JSON_UNESCAPED_UNICODE. Content-Type: application/json; charset=utf-8. |
| Fehler | HTTP 4xx/5xx mit { "error": "…" } als JSON-Body. |
FAQ
Warum sind die Namen oft englisch?
GeoNames-Originalfeld name liegt in der jeweiligen Hauptsprache des Landes — oder bei sehr vielen Einträgen einfach englisch (historisches Default). Lokalisierte Varianten kommen aus geo_alternate_names. Lösung: ?lang=de ergänzen — dann werden name, country.name und admin1.name aus der deutschen Übersetzung gefüllt.
Wie verhindere ich, dass ich das Tageslimit reiße?
Drei Stellschrauben:
- Debounce bei Autosuggest (≥ 200 ms zwischen Tastatureingabe und API-Call). Das Place-Widget macht das automatisch.
- Cache auf der eigenen Seite — der PHP-Client hat das eingebaut, im Browser z. B. via
localStorage. - API-Key mit Tier-Abo — selbst „Hobby" gibt 10 000 / Monat statt 1 000 / Tag und ist für ~5 € erhältlich.
Kann ich nur ein bestimmtes Land durchsuchen?
Ja: /api/search.php?q=Foo&country=DE — kommagetrennt für mehrere: country=DE,AT,CH.
Wie bekomme ich die Flagge eines Landes?
Drei Wege:
- Per Parameter zur Antwort:
?flag=1ergänztflag_urlin jedem Treffer/Country-Block. - Direkt als
<img>-Quelle:<img src="/api/flag.php?code=DE">— der Endpoint liefert per 302 die SVG. - Als Asset-URL:
/assets/Bilder/Flaggen/de.svg— wenn du die URL-Konvention selbst baust.
Wie melde ich einen Bug oder schicke einen Feature-Wunsch?
Email an ai@rd5.org, oder über das Kontaktformular.