Reverse-Geocoding/api/lookup.php
Koordinate rein, nächstgelegener Ort raus. Modus city bevorzugt bewohnte Städte, exact liefert den nächsten Punkt überhaupt.
GPS-Position in „München (DE)" verwandeln, mit Zeitzone und Einwohnerzahl.
Was geoAPI alles kann
Mehrsprachiges Reverse-Geocoding und Ortssuche, schlank und entwicklerfreundlich. Sechs REST-Endpoints, drei Drop-in-Bausteine und eine Datenbasis aus den GeoNames-Stammdaten — alles unter einer einzigen JSON-API.
5,7 Mio. Orte
10,6 Mio. mehrsprachige Namen
~250 Sprachen
252 Länder mit Vollausstattung
418 IANA-Zeitzonen
REST-API-Endpoints
Sechs schmale, zweckgebundene Endpoints. JSON ein, JSON aus. Keine SDK-Pflicht — funktioniert mit jedem HTTP-Client.
Ortssuche/api/search.php
Substring-Treffer über Name, ASCII-Variante und alle Alternativ-/Sprach-Namen. Sortiert nach Einwohnerzahl, optional mit Country-Filter.
Autosuggest-Felder, Country-Picker, „Wo ist Peking?" auf Deutsch.
Länder-Liste/api/countries.php
Alle 252 Länder, schlank für UI-Country-Picker. Optional mit Flaggen-URLs und lokalisierten Namen.
Dropdown-Befüllung im Checkout, Auswahl-Listen mit Landesflaggen.
Country-Detail/api/country.php
Vollständige Country-Info: ISO-Codes, Hauptstadt, Währung, Telefonvorwahl, Postleitzahl-Format und -Regex, Sprachen, Nachbarn, optional alle Bundesländer.
Lokalisierungs-Setup, korrekte Postleitzahl-Validierung pro Land.
Region-Detail/api/region.php
Bundesland, Kanton oder Provinz inklusive Country-Kontext. Format ISO2.AdminCode, z. B. DE.02 für Bayern oder CH.ZH für Zürich.
Lokalisierte Region-Anzeige, Kanton-Auswahl in Schweizer Formularen.
Flagge/api/flag.php
SVG-Flaggen für 233 Länder. Default: 302-Redirect direkt in <img>-Tags. Alternativ ?as=json mit URL.
Flaggen-Icons im Login-Screen, in Listen und Tooltips.
Granulare Antworten — bezahl nur, was du brauchst
Standard-Antworten sind schlank. Per extended=… wählst du gezielt zusätzliche Datenblöcke, jeder mit transparentem Latenz-Aufschlag.
country
Vollständiger Country-Block beim Treffer: Währung, Telefon, Postleitzahl-Format, Sprachen, Nachbarn, Hauptstadt.
Search-Treffer direkt mit Land-Kontext anreichern.
admin
Bundesland (admin1) und Kreis (admin2) ergänzen — beide mit lokalisierten Namen.
Adress-Auflösung mit korrekter Verwaltungsregion.
timezone
Zeitzone mit GMT-Offset, DST-Offset und Raw-Offset.
Termin-Konvertierung, „Lokalzeit am Zielort"-Anzeige.
flag
Direkter flag_url im Treffer — kein zusätzlicher Round-Trip nötig.
Listen-Ansichten mit Landesflaggen.
localized
In Kombination mit lang=de: ersetzt name, country.name und admin1.name durch die Sprach-Variante.
„Peking" statt „Beijing", „Mailand" statt „Milano".
Drop-in-Tools — eine Zeile HTML, fertig
Vorgefertigte Bausteine ohne Build-Step und ohne Framework. Auf jede statische HTML-Seite einbettbar, in WordPress, Shopify und überall sonst, wo du <script>-Tags reinschreiben darfst.
Place-Widgetgeoapi-widget.js
Autosuggest für <input>-Felder. Tastatur-navigierbar, mit Templates für Listen-Eintrag und Ergebnis-Format. Hidden-Felder für geonameid, Zeitzone, Lat/Lon und Country.
Reise-Buchungs-Form, Standort-Filter, Wetter-App.
Map-Widgetgeoapi-map.js
OpenStreetMap-Karte mit Klick-Reverse-Geocoding. Marker setzen, Lat/Lon und Ortsname automatisch in Hidden-Felder.
„Pin auf der Karte ablegen"-Form, geo-getaggte Inhalte.
PHP-ClientGeoApiClient.php
Single-File-Klasse für Server-PHP, mit optionalem Datei-Cache. Methoden lookupCity(), lookupExact(), search().
Backend-Validierung, geo-getaggte Datensätze, Cron-Jobs mit Reverse-Geocoding.
Authentifizierung & Limits
Anonym ohne Account loslegen, mit Key in skalierende Tarife wechseln. Bei Limit-Überschreitung wird gedrosselt — nie überraschend abgerechnet.
Anonym ohne Key
200 Anfragen pro Tag pro IP. Ideal für Demos, Browser-Widgets und erste Tests.
Statische Site mit Place-Widget, Hobby-Projekte.
API-Keys mit Quota
Hobby (25k/Monat ab 9 €), Starter (150k ab 19 €), Pro (1,5 M ab 39 €), Business (12 M ab 99 €). Mehrere Keys pro Konto, je Key konfigurierbar.
Trennung Production/Staging, getrennte Verbrauchs-Statistiken.
CORS-Whitelist
Pro Key eine Origin-Liste festlegen. Verhindert Missbrauch, wenn der Key im Browser sichtbar wird.
Public-Key in einer SPA, ohne Risiko von Trittbrettfahrern.
Verbrauchs-Webhooks
Pro Key HTTPS-URL und Schwellwert hinterlegen. POST mit usage_alert-Event, sobald die Schwelle erreicht ist.
Auto-Upgrade-Trigger, Slack-/Email-Alarm bei 80 %-Verbrauch.
Datenbasis
Tagessynchronisation gegen GeoNames.org, monatliche Vollabgleiche. Alle Daten unter CC BY 4.0.
5 796 847Orte (P) und Verwaltungsregionen (A)
10,6 Mio.mehrsprachige Namen, ~250 Sprachen
252Länder mit Vollausstattung
3 893Bundesländer / Kantone / Provinzen
418IANA-Zeitzonen mit DST-Offsets
Plattform & Konto
Alles, was rund um die API gehört: Self-Service, Transparenz, DSGVO.
Verbrauchs-Dashboard
Live-Verbrauch je Key, mit täglicher und monatlicher Auflösung. Audit-Log über alle Konto-Aktionen, 12 Monate aufbewahrt.
Anomalien früh erkennen, Audit-Trail für Compliance.
Stripe-Self-Service
Tarif-Wechsel, Zahlmethode aktualisieren, Rechnungen herunterladen — direkt im Stripe-Portal eingebettet.
Upgrade ohne Support-Ticket, monatliche Buchhaltung.
Datenexport
Vollständige DSGVO-Auskunft als CSV: Account-Daten, Verbrauchs-Logs, Audit-Log.
Datenmitnahme, Auskunfts-Recht erfüllen.
Health-Endpoint
UptimeRobot-/StatusCake-kompatibel: HTTP 200 bei DB ok, 503 sonst. Ohne Authentifizierung.
Eigene Monitoring-Pipeline, Status-Page-Integration.